Margin

Trade

Security Type: TRADE

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

New Order

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

Rate Limit:100times/2s

Headers

Name
Type
Description

X-CH-SIGN

string

Sign

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

timestamp

Request Body

Name
Type
Description

symbol

string

Symbol Name. E.g. BTCUSDT

volume

number

Order vol. For MARKET BUY orders, vol=amount.

side

string

Side of the order, BUY/SELL

type

string

Type of the order, LIMIT/MARKET

price

number

Order price, REQUIRED for LIMIT orders

newClientOrderId

string

Unique order ID generated by users to mark their orders

recvWindow

string

Time window

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

Query Order

GET https://openapi.xxx.com/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. BTCUSDT

Headers

Name
Type
Description

X-CH-SIGN

string

Sign

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

timestamp

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

Cancel Order

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

Rate Limit: 100times/2s

Headers

Name
Type
Description

X-CH-SIGN

string

Sign

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

timestamp

Request Body

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. BTCUSDT

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

Current Open Orders

GET https://openapi.xxx.com/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-APIKEY

string

Your API-key

X-CH-TS

integer

timestamp

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

Trades

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

Rate Limit: 20times/2s

Query Parameters

Name
Type
Description

symbol

string

Symbol Name. E.g. BTCUSDT

limit

string

Default 100; Max 1000

fromId

integer

Trade Id to fetch from

Headers

Name
Type
Description

X-CH-SIGN

string

Sign

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

timestamp

[
  {
    "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"
  },...
]

Last updated