Margin (leveraged) trading

Base URL for all endpoints in this module: https://openapi.bitbaby.com/spot/open

Trading

Security: TRADE

All trading endpoints below require a valid API key and request signature.

Create margin order

POST /sapi/v1/margin/order

Demo: https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/margin/NewOrder.java

Rate limit: 10 req/s

Headers

Name	Type	Description
X-CH-SIGN	string	Signature
X-CH-APIKEY	string	Your API key
X-CH-TS	integer	Timestamp

Request body

Name	Type	Description
symbol	string	Symbol, e.g. BTCUSDT
volume	number	Order size
side	string	BUY / SELL
type	string	LIMIT / MARKET
price	number	Price; required for LIMIT
newClientOrderId	string	Client order id
recvWindow	string	Recv window

200 — order created

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

Query margin order

GET /sapi/v1/margin/order

Demo: https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/margin/QueryOrder.java

Query parameters

Name	Type	Description
orderId	string	Order id
newClientOrderId	string	Client order id
symbol	string	Symbol, e.g. BTCUSDT

Headers

Name	Type	Description
X-CH-SIGN	string	Signature
X-CH-APIKEY	string	Your API key
X-CH-TS	integer	Timestamp

200

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

Cancel margin order

POST /sapi/v1/margin/cancel

Demo: https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/margin/CancelOrder.java

Headers

Name	Type	Description
X-CH-SIGN	string	Signature
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
symbol	string	Symbol, e.g. BTCUSDT

200

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

Open margin orders

GET /sapi/v1/margin/openOrders

Demo: https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/margin/CurrentOpenOrders.java

Query parameters

Name	Type	Description
symbol	string	Symbol, e.g. BTCUSDT
limit	integer	Default 100; max 1000

Headers

Name	Type	Description
X-CH-SIGN	string	Signature
X-CH-APIKEY	string	Your API key
X-CH-TS	integer	Timestamp

200

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

Margin trade history

GET /sapi/v1/margin/myTrades

Demo: https://github.com/exchange2021/openapidemo/blob/master/src/main/java/com/margin/Trades.java

Query parameters

Name	Type	Description
symbol	string	Symbol, e.g. BTCUSDT
limit	integer	Default 100; max 1000
fromId	integer	Fetch starting at this trade id

Headers

Name	Type	Description
X-CH-SIGN	string	Signature
X-CH-APIKEY	string	Your API key
X-CH-TS	integer	Timestamp

200

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