Margin

Trade

Security Type: TRADE

Endpoints under Trade require an API-key and a signature.​

New Order

POST https://openapi.xxx.xx/sapi/v1/margin/order

Rate Limit：100times/2s

Headers

Name	Type	Description
X-CH-SIGN	String	Sign
X-CH-TS	String	timestamp
X-CH-APIKEY	String	Your API-key

Request Body

Name	Type	Description
type	String	Type of the order, LIMIT/MARKET
recwwindow	String	Time window
price	number	Order price, REQUIRED for LIMIT orders
newClientOrderId	String	Unique order ID generated by users to mark their orders, Cannot exceed 32 characters
side	String	Side of the order, BUY/SELL
volume	number	Order vol. For MARKET BUY orders, vol=amount.
symbol	String	Symbol Name. E.g. BTCUSDT

200: OK

{
    'symbol': 'LXTUSDT', 
    'orderId': '494736827050147840', 
    'clientOrderId': '157371322565051',
    'transactTime': '1573713225668', 
    'price': '0.005452', 
    'origQty': '110', 
    'executedQty': '0', 
    'status': 'NEW',
    'type': 'LIMIT', 
    'side': 'SELL'
}

weight(IP/UID): 5

Query Order

GET https://openapi.xxx.xx/sapi/v1/margin/order

Rate Limit: 20times/2s

Query Parameters

Name	Type	Description
orderId	String	Order ID
newClientOrderId	String	Client Order Id, Unique order ID generated by users to mark their orders. E.g. 354444heihieddada
symbol	String	Symbol Name.E.g. BTCUSDTHeader

Headers

Name	Type	Description
X-CH-SIGN	String	Sign
X-CH-TS	String	timestamp
X-CH-APIKEY	String	Your API-key

200: OK

{
    'orderId': '499890200602846976', 
    'clientOrderId': '157432755564968', 
    'symbol': 'BHTUSDT', 
    'price': '0.01', 
    'origQty': '50', 
    'executedQty': '0', 
    'avgPrice': '0', 
    'status': 'NEW', 
    'type': 'LIMIT', 
    'side': 'BUY', 
    'transactTime': '1574327555669'
}

weight(IP/UID): 5

Cancel Order

POST https://openapi.xxx.xx/sapi/v1/margin/cancel

Rate Limit: 100times/2s

Headers

Name	Type	Description
X-CH-SIGN	String	Sign
X-CH-TS	String	timestamp
X-CH-APIKEY	String	Your API-key

Request Body

Name	Type	Description
newClientOrderId	String	Symbol Name. E.g. BTCUSDTResponses200GET
symbol	String	Client Order Id, Unique order ID generated by users to mark their orders. E.g. 354444heihieddada
orderId	String	Order ID

200: OK

{
    'symbol': 'BHTUSDT', 
    'clientOrderId': '0', 
    'orderId': '499890200602846976', 
    'status': 'CANCELED'
}

weight(IP/UID): 5

Current Open Orders

GET https://openapi.xxx.xx/sapi/v1/margin/openOrders

Rate Limit: 20times/2s

Query Parameters

Name	Type	Description
symbol	String	Symbol Name. E.g. BTCUSDT
limit	String	Default 100; Max 1000

Headers

Name	Type	Description
X-CH-SIGN	String	Sign
X-CH-TS	String	timestamp
X-CH-APIKEY	String	Your API-key

200: OK

[
    {
        'orderId': '499902955766523648', 
        'symbol': 'BHTUSDT', 
        'price': '0.01', 
        'origQty': '50', 
        'executedQty': '0', 
        'avgPrice': '0', 
        'status': 'NEW', 
        'type': 'LIMIT', 
        'side': 'BUY', 
        'time': '1574329076202'
        },...
]

weight(IP/UID): 1

Trades

GET https://openapi.xxx.xx/sapi/v1/margin/myTrades

Query Parameters

Name	Type	Description
symbol	String	Symbol Name. E.g. BTCUSDT
limit	String	Default 100; Max 1000
fromId	String	Trade Id to fetch from

Headers

Name	Type	Description
X-CH-SIGN	String	Sign
X-CH-TS	String	timestamp
X-CH-APIKEY	String	Your API-key

200: OK

[
  {
    "symbol": "ETHBTC",
    "id": 100211,
    "bidId": 150695552109032492,
    "askId": 150695552109032493,
    "price": "4.00000100",
    "qty": "12.00000000",
    "time": 1499865549590,
    "isBuyer": true,
    "isMaker": false,
    "feeCoin": "ETH",
    "fee":"0.001"
  },...
]

weight(IP/UID): 1