This document outlines the appropriate format that the traders must follow while writing the webhook payload for setting up the following types of delivery contract orders (Futures) to be executed into KuCoin.
Let’s get started 🚀
Market Order
The traders can write the webhook payload for setting up market orders using these three payload fields:
- Symbol
- Action
- Quantity
Symbol
The ticker symbol of the asset. KuCoin represents delivery contracts by using the contract code format that combines the cryptocurrency ticker symbol, month code, and year. Here month and year represent the expiration of the delivery contract.
The format is: [Cryptocurrency Product Symbol][Month Code][Year]
For months, a specific code is used to represent each month:
- January is represented by "F"
- February is represented by "G"
- March is represented by "H"
- April is represented by "J"
- May is represented by "K"
- June is represented by "M"
- July is represented by "N"
- August is represented by "Q"
- September is represented by "U"
- October is represented by "V"
- November is represented by "X"
- December is represented by "Z"
To denote the year of the contract, you simply append the year to the code. For instance, "XBTZ19" would represent the Bitcoin Futures expiring in December 2019
Sample:
- product = "XBT" represents “Bitcoin Futures”.
- month_code = "Z" represents “December”.
- year = "19" represents 2019 (using two digits to represent the year).
Action
The signal action indicates the type of trade to be executed. It can be one of the following two:
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
EXAMPLE
I. Buy
{
"symbol": "XBTZ19",
"action": "buy",
"quantity": 123
}
II. Sell
{
"symbol": "XBTZ19",
"action": "sell",
"quantity": 123
}
Limit Order
The traders can write the webhook payload for setting up limit orders using these four payload fields:
- Symbol
- Action
- Quantity
- Limit_price
Symbol
The ticker symbol of the asset. KuCoin represents delivery contracts by using the contract code format that combines the cryptocurrency ticker symbol, month code, and year. Here month and year represent the expiration of the delivery contract.
The format is: [Cryptocurrency Product Symbol][Month Code][Year]
For months, a specific code is used to represent each month:
- January is represented by "F"
- February is represented by "G"
- March is represented by "H"
- April is represented by "J"
- May is represented by "K"
- June is represented by "M"
- July is represented by "N"
- August is represented by "Q"
- September is represented by "U"
- October is represented by "V"
- November is represented by "X"
- December is represented by "Z"
To denote the year of the contract, you simply append the year to the code. For instance, "XBTZ19" would represent the Bitcoin Futures expiring in December 2019
Sample:
- product = "XBT" represents “Bitcoin Futures”.
- month_code = "Z" represents “December”.
- year = "19" represents 2019 (using two digits to represent the year).
Action
The signal action indicates the type of trade to be executed. It can be one of the following two:
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Limit_price
An optional field specifying the execution price for a “buy” or “sell” trade. If you specify the limit price the trade will be executed at the specified limit price. Or If you choose not to specify a limit price, the trade will be executed at the current market price.
EXAMPLE
I. Buy
{
"symbol": "XBTZ19",
"action": "buy",
"quantity": 123,
"limit_price": 123.98
}
II. Sell
{
"symbol": "XBTZ19",
"action": "sell",
"quantity": 123,
"limit_price": 123.98
}
Stop Order
The traders can write the webhook payload for setting up limit orders using these four payload fields:
- Symbol
- Action
- Quantity
- Stop_price
Symbol
The ticker symbol of the asset. KuCoin represents delivery contracts by using the contract code format that combines the cryptocurrency ticker symbol, month code, and year. Here month and year represent the expiration of the delivery contract.
The format is: [Cryptocurrency Product Symbol][Month Code][Year]
For months, a specific code is used to represent each month:
- January is represented by "F"
- February is represented by "G"
- March is represented by "H"
- April is represented by "J"
- May is represented by "K"
- June is represented by "M"
- July is represented by "N"
- August is represented by "Q"
- September is represented by "U"
- October is represented by "V"
- November is represented by "X"
- December is represented by "Z"
To denote the year of the contract, you simply append the year to the code. For instance, "XBTZ19" would represent the Bitcoin Futures expiring in December 2019
Sample:
- product = "XBT" represents “Bitcoin Futures”.
- month_code = "Z" represents “December”.
- year = "19" represents 2019 (using two digits to represent the year).
Action
The signal action indicates the type of trade to be executed. It can be one of the following two:
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Stop_price
An optional field specifying the price level at which a stop-loss or stop-limit order should be triggered. It helps limit potential losses by automatically closing the position when the specified price is reached.
EXAMPLE
I. Buy
{
"symbol": "XBTZ19",
"action": "buy",
"quantity": 123,
"stop_price": 123.98
}
II. Sell
{
"symbol": "XBTZ19",
"action": "sell",
"quantity": 123,
"stop_price": 123.98
}
Stop-Limit Order
The traders can write the webhook payload for setting up Stop-limit orders using these five payload fields:
- Symbol
- Action
- Quantity
- Limit_price
- Stop_price
Symbol
The ticker symbol of the asset. KuCoin represents delivery contracts by using the contract code format that combines the cryptocurrency ticker symbol, month code, and year. Here month and year represent the expiration of the delivery contract.
The format is: [Cryptocurrency Product Symbol][Month Code][Year]
For months, a specific code is used to represent each month:
- January is represented by "F"
- February is represented by "G"
- March is represented by "H"
- April is represented by "J"
- May is represented by "K"
- June is represented by "M"
- July is represented by "N"
- August is represented by "Q"
- September is represented by "U"
- October is represented by "V"
- November is represented by "X"
- December is represented by "Z"
To denote the year of the contract, you simply append the year to the code. For instance, "XBTZ19" would represent the Bitcoin Futures expiring in December 2019
Sample:
- product = "XBT" represents “Bitcoin Futures”.
- month_code = "Z" represents “December”.
- year = "19" represents 2019 (using two digits to represent the year).
Action
The signal action indicates the type of trade to be executed. It can be one of the following two:
Buy: Triggers an action to purchase the asset.
Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Limit_price
An optional field specifying the execution price for a “buy” or “sell” trade. If you specify the limit price the trade will be executed at the specified limit price. Or If you choose not to specify a limit price, the trade will be executed at the current market price.
Stop_price
An optional field specifying the price level at which a stop-loss or stop-limit order should be triggered. It helps limit potential losses by automatically closing the position when the specified price is reached.
EXAMPLE
I. Buy
{
"symbol": "XBTZ19",
"action": "buy",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98
}
II. Sell
{
"symbol": "XBTZ19",
"action": "sell",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98
}