API Reference

Create Order v1.1 (New)

Creates a single order for Spot Trading on the Exchange. When an order is placed, the required funds from your account will be ringfenced for the duration of the order

📘

Note

New endpoint

  • Supports specifying both the cash amount and the quantity for market orders, regardless of whether it's a buy or sell order

Weight: 1

Certain parameters are mandatory depending on the order type:

TypeMandatory parameters
LIMITquantity, price
MARKETquantity
LIMIT_MAKERquantity, price

Request Parameters

PARAMETER

TYPE

Req'd

DESCRIPTION

symbol

STRING

Y

Name of instrument e.g. "BTCUSD", "ETHUSD"

side

ENUM

Y

BUY or SELL

type

ENUM

Y

Currently offer 3 order types:

- LIMIT - Limit order
- MARKET - Market order
- LIMIT_MAKER - Maker Limit order

quantity

DECIMAL

C

Order quantity in units of the instrument

- Limit order: Represents the amount of the base asset you want to buy or sell.
For example: BTC/USD pair, if quantity is 0.5, you're ordering 0.5 BTC

- Market order: Represents the cash amount for market buy orders and the quantity for market sell orders
For example: For BTC/USD pair, if amount = 1000, you are placing a MARKET buy order to purchase BTC using 1000 USD at the current market price

amount

DECIMAL

C

Cash amount in the units of quote asset. Market order only

- Market order: Represents the amount of the quote asset you want to use for the trade
For example: For BTC/USD pair, if amount = 1000, you are placing a MARKET buy order to purchase BTC using 1000 USD at the current market price

price

DECIMAL

C

Required for LIMIT and LIMIT_MAKER order

newClientOrderId

STRING

An ID defined by the client for the order, it will be automatically generated if it is not sent in the request.
newClientOrderId for the same accountId is not allowed to be duplicate.

timeInForce

ENUM

-"GTC" for Limit order & Limit maker order
-"IOC" for Limit order & Market order
-"FOK" for Limit order

recvWindow

LONG

Recv Window. Default 5000

timestamp

LONG

Y

Timestamp

stpMode

ENUM

C

Self Trade Prevention Mode.
Enum: EXPIRE_TAKER, EXPIRE_MAKER
Default EXPIRE_TAKER if not specified.

Response Content


PARAMETERTYPEExample valuesDESCRIPTION
accountIdLONG1467298646903017216Account number
symbolSTRINGBTCUSDTrading pair
symbolNameSTRINGBTCUSDTrading pair name
clientOrderIdSTRING1690084460710352An ID defined by the client for the order, it will be automatically generated if it is not sent in the request
orderIdLONG1470929500342690304System-generated order ID (up to 20 characters)
transactTimeLONG1690084460716Timestamp in milliseconds
priceDECIMAL28000Price
origQtyDECIMAL0.01Quantity
executedQtyDECIMAL0Traded Volume
statusENUMNEWOrder status. See Enumeration definition for more details
timeInForceENUMGTCDuration of the order before expiring
typeENUMLIMITOrder type. See enumeration definition for more details
sideENUMBUYBUY or SELL
reqAmountSTRING0Requested Cash amount
concentrationSTRINGConcentration reminder message
Language
Credentials
Header
Click Try It! to start a request and see the response here!