PINE LIBRARY

PineTradingbotWebhook

Updated

Library "PineTradingbotWebhook"

makeWebhookJson(webhookKey, direction, qty, entryLimit, entryStop, exitLimit, exitStop, orderRef, contract)
Creates a Webhook message for Tbot on Tradingboat
Parameters:
webhookKey: the unique key to the Flask (TVWB) server
direction: the same as the strategy's direction
qty
entryLimit
entryStop
exitLimit
exitStop
orderRef
contract
Returns: JSON as a string

Release Notes

v2:
update the "qty" argument from a "simple float" to a "series float"

Release Notes

v3

Updated:
- Update PineScript library to send a single client ID for multiple Redis pub actions

Release Notes

v4

Updated:
"Revised makeWebhookJson function to use -1e10 as a special value for the qty parameter to indicate all contracts/units should be exited. Added comment to code to explain the special value."

Release Notes

v5

This update includes the addition of a detailed description for function parameters.

Allow me to clarify the purpose of this library.
The library generates webhook messages in JSON format.
The following is an example of the JSON message format:

----------------------------------------------------------------------------------
{
"timestamp": 1645630199,
"ticker": "AAPL",
"currency": "USD",
"timeframe": "1D",
"key": "WebhookReceived:123456",
"contract": "stock",
"orderRef": "long#1",
"direction": "strategy.long",
"clientId": 1,
"metrics": [
{
"name": "entry.stop",
"value": 130.0
},
{
"name": "entry.limit",
"value": 0.0
},
{
"name": "exit.limit",
"value": 150.0
},
{
"name": "exit.stop",
"value": 100.0
}
]
}
----------------------------------------------------------------------------------
The webhook message can be received by a web server. An example of such a server is provided below.
The web server is based on Flask and TVWB.
It can push Redis messages to individual Redis Streams per Interactive Broker clientID,
as well as fetch order information and display it in web browsers.

Here is the link to the GitHub repository for the tradingview-webhooks-bot:

github.com/PlusGenie/tradingview-webhooks-bot

Release Notes

v6
This patch replaces string concatenation with the str.format() function for better readability and performance

Release Notes

v7

Updated: Rearrange the function signature parameter order

makeWebhookJson(webhookKey, orderRef, direction, qty, entryLimit, entryStop, exitLimit, exitStop, contract, clientId)
Creates a Webhook message for Tbot on Tradingboat
Parameters:
webhookKey (simple string): the unique key to the Flask (TVWB) server - // Use format like WebhookReceived:123456
orderRef (simple string): this will be used to create the order reference ID, together with timeframe and clientID
direction (simple string): the same as the strategy's direction - strategy.entrylong, strategy.entryshort, strategy.exitlong, strategy.exitshort, strategy.close, strategy.close_all
qty (float): default value is -1e10 indicating all contracts/units
entryLimit (float): this is same to strategy.entry()'s limit parameter
entryStop (float): this is same to strategy.entry()'s stop parameter
exitLimit (float): this is the same to strategy.exit()'s limit parameter
exitStop (float): this is the same to strategy.exit()'s stop parameter
contract (simple string): this will be translated to secType in ib insync. stock, forex, crypto
clientId (int): this is for IB Gateway/TWS's clientID which should start with 1
Returns: JSON as a series string

Release Notes

v8

Updated: The library has been updated to include support for Futures.

makeWebhookJson(webhookKey, orderRef, direction, qty, entryLimit, entryStop, exitLimit, exitStop, contract, exchange, lastTradeDateOrContractMonth, clientId)
Creates a Webhook message for Tbot on Tradingboat
Parameters:
webhookKey (simple string): the unique key to the Flask (TVWB) server - // Use format like WebhookReceived:123456
orderRef (simple string): this will be used to create the order reference ID, together with timeframe and clientID
direction (simple string): the same as the strategy's direction - strategy.entrylong, strategy.entryshort, strategy.exitlong, strategy.exitshort, strategy.close, strategy.close_all
qty (float): default value is -1e10 indicating all contracts/units
entryLimit (float): this is same to strategy.entry()'s limit parameter
entryStop (float): this is same to strategy.entry()'s stop parameter
exitLimit (float): this is the same to strategy.exit()'s limit parameter
exitStop (float): this is the same to strategy.exit()'s stop parameter
contract (simple string): this will be translated to secType in ib_insync. stock, forex, crypto and future(s)
exchange (simple string): Destination exchange for ib_insync, primarily for futures.
lastTradeDateOrContractMonth (simple string): The contract's last trading day or contract month for ib_insync, mainly for futures. Should be in the format YYYYMM or YYYYMMDD.
clientId (int): this is for IB Gateway/TWS's clientID which should start with 1
Returns: JSON as a series string

Release Notes

v9

Updated:

Added 'ticker' parameter in PineTradingbotWebhook library

- Enhanced the makeWebhookJson function with a new 'ticker' parameter
- Ensured compatibility with different symbol formats in TradingView and ib_insync
- Provided default behavior to use current chart's ticker if 'ticker' parameter is not specified
- Updated function documentation to include the new parameter description

Release Notes

v10

Updated:
makeWebhookJson(webhookKey, orderRef, direction, qty, entryLimit, entryStop, exitLimit, exitStop, contract, ticker, lastTradeDateOrContractMonth, exchange, multiplier, clientId)
Creates a Webhook message for Tbot on Tradingboat
Parameters:
webhookKey (simple string): the unique key to the Flask (TVWB) server - // Use format like WebhookReceived:123456
orderRef (simple string): this will be used to create the order reference ID, together with timeframe and clientID
direction (simple string): the same as the strategy's direction - strategy.entrylong, strategy.entryshort, strategy.exitlong, strategy.exitshort, strategy.close, strategy.close_all
qty (float): default value is -1e10 indicating all contracts/units
entryLimit (float): this is same to strategy.entry()'s limit parameter
entryStop (float): this is same to strategy.entry()'s stop parameter
exitLimit (float): this is the same to strategy.exit()'s limit parameter
exitStop (float): this is the same to strategy.exit()'s stop parameter
contract (simple string): this will be translated to secType in ib_insync. stock, forex, crypto and future(s)
ticker (simple string): The TradingView ticker symbol for the asset; defaults to the current chart's ticker if not specified.
lastTradeDateOrContractMonth (simple string): The contract's last trading day or contract month for ib_insync, mainly for futures. Should be in the format YYYYMM or YYYYMMDD.
exchange (simple string): Destination exchange for ib_insync, primarily for futures.
multiplier (simple string): The futures contract multiplier is the amount multiplying the price per point to determine total value.
clientId (int): this is for IB Gateway/TWS's clientID which should start with 1
Returns: JSON as a series string

Pine library

In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in a publication is governed by House rules.

AlphaCentauri66367

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.