Cryptocurrency | Perpetual Contracts (Futures) | KuCoin

This document outlines the appropriate format that the traders must follow while writing the webhook payload for setting up the following types of Perpetual 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 the future perpetual contract using cryptocurrency ticker symbols paired with quote currency. E.g.,

If you choose Coin-ⓜ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDM: This represents the BTC perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Bitcoin per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDM: This represents the ETH perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Ethereum per contract.

If you choose the USDⓢ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDTM: This represents the BTC-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.001 BTC per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDTM: This represents the ETH-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.01 BTC per contract.

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": "XBTUSDM",
  "action": "buy",
  "quantity": 123
}

II. Sell

{
  "symbol": "XBTUSDM",
  "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 the future perpetual contract using cryptocurrency ticker symbols paired with quote currency. E.g.,

If you choose Coin-ⓜ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDM: This represents the BTC perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Bitcoin per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDM: This represents the ETH perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Ethereum per contract.

If you choose the USDⓢ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDTM: This represents the BTC-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.001 BTC per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDTM: This represents the ETH-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.01 BTC per contract.

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 Order

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": "XBTUSDM",
  "action": "buy",
  "quantity": 123,
  "limit_price": 123.98
}

II. Sell

{
  "symbol": "XBTUSDM",
  "action": "sell",
  "quantity": 123,
  "limit_price": 123.98
}

Stop Order

The traders can write the webhook payload for setting up Stop orders using these five payload fields:

  • Symbol
  • Action
  • Quantity
  • Stop_Price

Symbol

The ticker symbol of the asset. KuCoin represents the future perpetual contract using cryptocurrency ticker symbols paired with quote currency. E.g.,

If you choose Coin-ⓜ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDM: This represents the BTC perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Bitcoin per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDM: This represents the ETH perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Ethereum per contract.

If you choose the USDⓢ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDTM: This represents the BTC-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.001 BTC per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDTM: This represents the ETH-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.01 BTC per contract.

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 Order

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": "XBTUSDM",
  "action": "buy",
  "quantity": 123,
  "stop_price": 123.98
}

II. Sell

{
  "symbol": "XBTUSDM",
  "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 the future perpetual contract using cryptocurrency ticker symbols paired with quote currency. E.g.,

If you choose Coin-ⓜ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDM: This represents the BTC perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Bitcoin per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDM: This represents the ETH perpetual contract quoted in USD. This contract has no expiry date, worth 1 USD of Ethereum per contract.

If you choose the USDⓢ contract type and BTC perpetual contract then the contract ticker symbol is like this:

XBTUSDTM: This represents the BTC-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.001 BTC per contract.

Same as for ETH then the ticker symbol is like this:

ETHUSDTM: This represents the ETH-USDT perpetual Swap Mini Contract. This contract has no expiry date and is worth of 0.01 BTC per contract.

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 Order

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 Order

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": "XBTUSDM",
  "action": "buy",
  "quantity": 123,
  "limit_price": 123.98,
  "stop_price": 123.98
}

II. Sell

{
  "symbol": "XBTUSDM",
  "action": "sell",
  "quantity": 123,
  "limit_price": 123.98,
  "stop_price": 123.98
}




Sep 29, 2023

Contact Us

Not finding what you're looking for? Contact Us Directly