mirror of
https://github.com/discountry/ritmex-bot.git
synced 2026-09-11 09:18:08 +00:00
add docs
This commit is contained in:
discountry
@@ -0,0 +1,10 @@
|
||||
---
|
||||
title: "Introduction | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/Introduction"
|
||||
fetched_at: "2026-01-27T05:28:00.328Z"
|
||||
---
|
||||
!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();t(null!==e?e:"light")}(),function(){try{const n=new URLSearchParams(window.location.search).entries();for(var\[t,e\]of n)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()
|
||||
|
||||
[Skip to main content](https://developers.binance.com/docs/derivatives/usds-margined-futures/general-info)
|
||||
|
||||
Derivative Trading API provide REST and WebSocket APIs to suit your derivative trading needs.
|
||||
File diff suppressed because it is too large
Load Diff
+12
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: "New Future Account Transfer | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api"
|
||||
fetched_at: "2026-01-27T05:28:00.545Z"
|
||||
---
|
||||
!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();t(null!==e?e:"light")}(),function(){try{const n=new URLSearchParams(window.location.search).entries();for(var\[t,e\]of n)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()
|
||||
|
||||
[Skip to main content](https://developers.binance.com/docs/derivatives/usds-margined-futures/general-info)
|
||||
|
||||
# New Future Account Transfer
|
||||
|
||||
Please find details from [here](https://developers.binance.com/docs/wallet/asset/user-universal-transfer).
|
||||
+55
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "Account Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information"
|
||||
fetched_at: "2026-01-27T05:28:00.542Z"
|
||||
---
|
||||
# Account Information (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
|
||||
Get current account information.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
|
||||
GET `/dapi/v1/account`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - for One-way Mode user, the "positions" will only show the "BOTH" positions
|
||||
> - for Hedge Mode user, the "positions" will show "BOTH", "LONG", and "SHORT" positions.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
|
||||
```
|
||||
{ "assets": [ { "asset": "BTC", // asset name "walletBalance": "0.00241969", // total wallet balance "unrealizedProfit": "0.00000000", // unrealized profit or loss "marginBalance": "0.00241969", // margin balance "maintMargin": "0.00000000", // maintenance margin "initialMargin": "0.00000000", // total intial margin required with the latest mark price "positionInitialMargin": "0.00000000", // positions" margin required with the latest mark price "openOrderInitialMargin": "0.00000000", // open orders" intial margin required with the latest mark price "maxWithdrawAmount": "0.00241969", // available amount for transfer out "crossWalletBalance": "0.00241969", // wallet balance for crossed margin "crossUnPnl": "0.00000000", // total unrealized profit or loss of crossed positions "availableBalance": "0.00241969", // available margin balance "updateTime": 1625474304765 //update time } ], "positions": [ { "symbol": "BTCUSD_201225", "positionAmt":"0", // position amount "initialMargin": "0", "maintMargin": "0", "unrealizedProfit": "0.00000000", "positionInitialMargin": "0", "openOrderInitialMargin": "0", "leverage": "125", "isolated": false, "positionSide": "BOTH", // BOTH means that it is the position of One-way Mode "entryPrice": "0.0", "breakEvenPrice": "0.0", // break-even price "maxQty": "50", // maximum quantity of base asset "updateTime": 0 }, { "symbol": "BTCUSD_201225", "positionAmt":"0", "initialMargin": "0", "maintMargin": "0", "unrealizedProfit": "0.00000000", "positionInitialMargin": "0", "openOrderInitialMargin": "0", "leverage": "125", "isolated": false, "positionSide": "LONG", // LONG or SHORT means that it is the position of Hedge Mode "entryPrice": "0.0", "breakEvenPrice": "0.0", // break-even price "maxQty": "50", "updateTime": 0 }, { "symbol": "BTCUSD_201225", "positionAmt":"0", "initialMargin": "0", "maintMargin": "0", "unrealizedProfit": "0.00000000", "positionInitialMargin": "0", "openOrderInitialMargin": "0", "leverage": "125", "isolated": false, "positionSide": "SHORT", // LONG or SHORT means that it is the position of Hedge Mode "entryPrice": "0.0", "breakEvenPrice": "0.0", // break-even price "maxQty": "50", "notionalValue": "0", "updateTime":1627026881327 } ], "canDeposit": true, "canTrade": true, "canWithdraw": true, "feeTier": 2, "updateTime": 0}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information)
|
||||
+52
@@ -0,0 +1,52 @@
|
||||
---
|
||||
title: "Futures Account Balance | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance"
|
||||
fetched_at: "2026-01-27T05:28:00.720Z"
|
||||
---
|
||||
# Futures Account Balance (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
|
||||
Check futures account balance
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
|
||||
GET `/dapi/v1/balance`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
|
||||
```
|
||||
[ { "accountAlias": "SgsR", // unique account code "asset": "BTC", "balance": "0.00250000", "withdrawAvailable": "0.00250000", "crossWalletBalance": "0.00241969", "crossUnPnl": "0.00000000", "availableBalance": "0.00241969", "updateTime": 1592468353979 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Futures-Account-Balance)
|
||||
+52
@@ -0,0 +1,52 @@
|
||||
---
|
||||
title: "Get Current Position Mode | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode"
|
||||
fetched_at: "2026-01-27T05:28:00.641Z"
|
||||
---
|
||||
# Get Current Position Mode(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
|
||||
Get user's position mode (Hedge Mode or One-way Mode ) on _**EVERY symbol**_
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
|
||||
GET `/dapi/v1/positionSide/dual`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
|
||||
**30**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
|
||||
```
|
||||
{ "dualSidePosition": true // "true": Hedge Mode; "false": One-way Mode}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Current-Position-Mode)
|
||||
+71
@@ -0,0 +1,71 @@
|
||||
---
|
||||
title: "Get Download Id For Futures Order History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History"
|
||||
fetched_at: "2026-01-27T05:28:00.935Z"
|
||||
---
|
||||
# Get Download Id For Futures Order History (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
|
||||
Get Download Id For Futures Order History
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
|
||||
GET `/dapi/v1/order/asyn`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Request Limitation is 10 times per month, shared by front end download page and rest api
|
||||
> - The time between `startTime` and `endTime` can not be longer than 1 year
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
|
||||
```
|
||||
{ "avgCostTimestampOfLast30d":7241837, // Average time taken for data download in the past 30 days "downloadId":"546975389218332672",}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Order-History)
|
||||
+71
@@ -0,0 +1,71 @@
|
||||
---
|
||||
title: "Get Download Id For Futures Trade History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History"
|
||||
fetched_at: "2026-01-27T05:28:00.942Z"
|
||||
---
|
||||
# Get Download Id For Futures Trade History (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
|
||||
Get download id for futures trade history
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
|
||||
GET `/dapi/v1/trade/asyn`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Request Limitation is 5 times per month, shared by front end download page and rest api
|
||||
> - The time between `startTime` and `endTime` can not be longer than 1 year
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
|
||||
```
|
||||
{ "avgCostTimestampOfLast30d":7241837, // Average time taken for data download in the past 30 days "downloadId":"546975389218332672",}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Trade-History)
|
||||
+71
@@ -0,0 +1,71 @@
|
||||
---
|
||||
title: "Get Download Id For Futures Transaction History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History"
|
||||
fetched_at: "2026-01-27T05:28:01.033Z"
|
||||
---
|
||||
# Get Download Id For Futures Transaction History(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
|
||||
Get download id for futures transaction history
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
|
||||
GET `/dapi/v1/income/asyn`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Timestamp in ms
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Request Limitation is 5 times per month, shared by front end download page and rest api
|
||||
> - The time between `startTime` and `endTime` can not be longer than 1 year
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
|
||||
```
|
||||
{ "avgCostTimestampOfLast30d":7241837, // Average time taken for data download in the past 30 days "downloadId":"546975389218332672",}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Download-Id-For-Futures-Transaction-History)
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
---
|
||||
title: "Get Future Account Transaction History List | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Future-Account-Transaction-History-List"
|
||||
fetched_at: "2026-01-27T05:28:01.109Z"
|
||||
---
|
||||
# Get Future Account Transaction History List
|
||||
|
||||
Please find details from [here](https://developers.binance.com/docs/wallet/asset/query-user-universal-transfer).
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: "Get Futures Order History Download Link By Id | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id"
|
||||
fetched_at: "2026-01-27T05:28:01.327Z"
|
||||
---
|
||||
# Get Futures Order History Download Link by Id (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
|
||||
Get futures order history download link by Id
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
|
||||
GET `/dapi/v1/order/asyn/id`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
|
||||
5
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
downloadId
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
get by download id api
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Download link expiration: 24h
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
|
||||
> **Response:**
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"completed", // Enum：completed，processing "url":"www.binance.com", // The link is mapped to download id "notified":true, // ignore "expirationTimestamp":1645009771000, // The link would expire after this timestamp "isExpired":null,}
|
||||
```
|
||||
|
||||
> **OR** (Response when server is processing)
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, }
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Order-History-Download-Link-by-Id)
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: "Get Futures Trade Download Link By Id | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id"
|
||||
fetched_at: "2026-01-27T05:28:01.337Z"
|
||||
---
|
||||
# Get Futures Trade Download Link by Id(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
|
||||
Get futures trade download link by Id
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
|
||||
GET `/dapi/v1/trade/asyn/id`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
downloadId
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
get by download id api
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Download link expiration: 24h
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
|
||||
> **Response:**
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"completed", // Enum：completed，processing "url":"www.binance.com", // The link is mapped to download id "notified":true, // ignore "expirationTimestamp":1645009771000, // The link would expire after this timestamp "isExpired":null,}
|
||||
```
|
||||
|
||||
> **OR** (Response when server is processing)
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, }
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Trade-Download-Link-by-Id)
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: "Get Futures Transaction History Download Link By Id | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id"
|
||||
fetched_at: "2026-01-27T05:28:01.425Z"
|
||||
---
|
||||
# Get Futures Transaction History Download Link by Id (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
|
||||
Get futures transaction history download link by Id
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
|
||||
GET `/dapi/v1/income/asyn/id`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
downloadId
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
get by download id api
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Download link expiration: 24h
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
|
||||
> **Response:**
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"completed", // Enum：completed，processing "url":"www.binance.com", // The link is mapped to download id "notified":true, // ignore "expirationTimestamp":1645009771000, // The link would expire after this timestamp "isExpired":null,}
|
||||
```
|
||||
|
||||
> **OR** (Response when server is processing)
|
||||
|
||||
```
|
||||
{ "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, }
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Futures-Transaction-History-Download-Link-by-Id)
|
||||
+100
@@ -0,0 +1,100 @@
|
||||
---
|
||||
title: "Get Income History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History"
|
||||
fetched_at: "2026-01-27T05:28:01.561Z"
|
||||
---
|
||||
# Get Income History(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
|
||||
Get income history
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
|
||||
GET `/dapi/v1/income`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
|
||||
**20**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
incomeType
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"TRANSFER","WELCOME\_BONUS", "FUNDING\_FEE", "REALIZED\_PNL", "COMMISSION", "INSURANCE\_CLEAR", and "DELIVERED\_SETTELMENT"
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get funding from INCLUSIVE.
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get funding until INCLUSIVE.
|
||||
|
||||
page
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 100; max 1000
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - If `incomeType` is not sent, all kinds of flow will be returned
|
||||
> - "trandId" is unique in the same "incomeType" for a user
|
||||
> - The time between `startTime` and `endTime` can not be longer than 1 year
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
|
||||
```
|
||||
[ { "symbol": "", // trade symbol, if existing "incomeType": "TRANSFER", // income type "income": "-0.37500000", // income amount "asset": "BTC", // income asset "info":"WITHDRAW", // extra information "time": 1570608000000, "tranId":"9689322392", // transaction id "tradeId":"" // trade id, if existing }, { "symbol": "BTCUSD_200925", "incomeType": "COMMISSION", "income": "-0.01000000", "asset": "BTC", "info":"", "time": 1570636800000, "tranId":"9689322392", "tradeId":"2059192" }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Get-Income-History)
|
||||
+60
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Notional Bracket For Pair | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair"
|
||||
fetched_at: "2026-01-27T05:28:01.714Z"
|
||||
---
|
||||
# Notional Bracket for Pair(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
|
||||
**Not recommended to continue using this v1 endpoint**
|
||||
|
||||
Get the pair's default notional bracket list, may return ambiguous values when there have been multiple different `symbol` brackets under the `pair`, suggest using the following `GET /dapi/v2/leverageBracket` query instead to get the specific `symbol` notional bracket list.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
|
||||
GET `/dapi/v1/leverageBracket`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "brackets": [ { "bracket": 1, // bracket level "initialLeverage": 125, // the maximum leverage "qtyCap": 50, // upper edge of base asset quantity "qtylFloor": 0, // lower edge of base asset quantity "maintMarginRatio": 0.004 // maintenance margin rate "cum": 0.0 // Auxiliary number for quick calculation }, ] }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Pair)
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: "Notional Bracket For Symbol | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol"
|
||||
fetched_at: "2026-01-27T05:28:01.725Z"
|
||||
---
|
||||
# Notional Bracket for Symbol(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
|
||||
Get the symbol's notional bracket list.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
|
||||
GET `/dapi/v2/leverageBracket`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_PERP", "notionalCoef": 1.50, //user symbol bracket multiplier, only appears when user's symbol bracket is adjusted "brackets": [ { "bracket": 1, // bracket level "initialLeverage": 125, // the maximum leverage "qtyCap": 50, // upper edge of base asset quantity "qtylFloor": 0, // lower edge of base asset quantity "maintMarginRatio": 0.004 // maintenance margin rate "cum": 0.0 // Auxiliary number for quick calculation }, ] }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Notional-Bracket-for-Symbol)
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: "User Commission Rate | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate"
|
||||
fetched_at: "2026-01-27T05:28:01.811Z"
|
||||
---
|
||||
# User Commission Rate (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
|
||||
Query user commission rate
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
|
||||
GET `/dapi/v1/commissionRate`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
|
||||
**20**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
|
||||
```
|
||||
{ "symbol": "BTCUSD_PERP", "makerCommissionRate": "0.00015", // 0.015% "takerCommissionRate": "0.00040" // 0.040%}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/User-Commission-Rate)
|
||||
+59
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: "Futures Account Balance | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api"
|
||||
fetched_at: "2026-01-27T05:28:01.946Z"
|
||||
---
|
||||
# Futures Account Balance(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
Query account balance info
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
`account.balance`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "9328e612-1560-4108-979e-283bf85b5acb", "method": "account.balance", "params": { "apiKey": "", "timestamp": 1727810404936, "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "9328e612-1560-4108-979e-283bf85b5acb", "status": 200, "result": [ { "accountAlias": "fWAuTiuXoCuXmY", "asset": "WLD", "balance": "0.00000000", "withdrawAvailable": "0.00000000", "crossWalletBalance": "0.00000000", "crossUnPnl": "0.00000000", "availableBalance": "0.00000000", "updateTime": 0 }, // ... ... ], "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 10 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api)
|
||||
+59
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: "Account Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information"
|
||||
fetched_at: "2026-01-27T05:28:02.105Z"
|
||||
---
|
||||
# Account Information(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
Get current account information. User in single-asset/ multi-assets mode will see different value, see comments in response section for detail.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
`account.status`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
```
|
||||
{ "id": "baaec739-c5cf-4920-b448-c0b9c5431410", "method": "account.status", "params": { "apiKey": "", "timestamp": 1727785087742, "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
|
||||
```
|
||||
{ "id": "baaec739-c5cf-4920-b448-c0b9c5431410", "status": 200, "result": { "feeTier": 0, "canTrade": true, "canDeposit": true, "canWithdraw": true, "updateTime": 0, "assets": [ { "asset": "WLD", "walletBalance": "0.00000000", "unrealizedProfit": "0.00000000", "marginBalance": "0.00000000", "maintMargin": "0.00000000", "initialMargin": "0.00000000", "positionInitialMargin": "0.00000000", "openOrderInitialMargin": "0.00000000", "maxWithdrawAmount": "0.00000000", "crossWalletBalance": "0.00000000", "crossUnPnl": "0.00000000", "availableBalance": "0.00000000", "updateTime": 0 }, // ... ... ], "positions": [ { "symbol": "ETHUSD_220930", "initialMargin": "0", "maintMargin": "0", "unrealizedProfit": "0.00000000", "positionInitialMargin": "0", "openOrderInitialMargin": "0", "leverage": "7", "isolated": false, "positionSide": "BOTH", "entryPrice": "0.00000000", "maxQty": "1000", "notionalValue": "0", "isolatedWallet": "0", "updateTime": 0, "positionAmt": "0", "breakEvenPrice": "0.00000000" }, // ... ... ] }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 10 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/account/websocket-api/Account-Information)
|
||||
+248
@@ -0,0 +1,248 @@
|
||||
---
|
||||
title: "Common Definition | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition"
|
||||
fetched_at: "2026-01-27T05:28:02.113Z"
|
||||
---
|
||||
# Public Endpoints Info
|
||||
|
||||
## Terminology[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
- `symbol` refers to the symbol name of a contract symbol
|
||||
- `pair` refers to the underlying symbol of a contracrt symbol
|
||||
- `base asset` refers to the asset that is the `quantity` of a symbol.
|
||||
- `quote asset` refers to the asset that is the `price` of a symbol.
|
||||
- `margin asset` refers to the asset that is the `margin` of a symbol
|
||||
|
||||
## ENUM definitions[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
**Symbol type:**
|
||||
|
||||
- DELIVERY\_CONTRACT
|
||||
- PERPETUAL\_CONTRACT
|
||||
|
||||
**Contract type (contractType):**
|
||||
|
||||
- PERPETUAL
|
||||
- CURRENT\_QUARTER
|
||||
- NEXT\_QUARTER
|
||||
- CURRENT\_QUARTER\_DELIVERING // Invalid type, only used for DELIVERING status
|
||||
- NEXT\_QUARTER\_DELIVERING // Invalid type, only used for DELIVERING status
|
||||
- PERPETUAL\_DELIVERING
|
||||
|
||||
**Contract status (contractStatus, status):**
|
||||
|
||||
- PENDING\_TRADING
|
||||
- TRADING
|
||||
- PRE\_DELIVERING
|
||||
- DELIVERING
|
||||
- DELIVERED
|
||||
|
||||
**Order status (status):**
|
||||
|
||||
- NEW
|
||||
- PARTIALLY\_FILLED
|
||||
- FILLED
|
||||
- CANCELED
|
||||
- EXPIRED
|
||||
|
||||
**Order types (type):**
|
||||
|
||||
- LIMIT
|
||||
- MARKET
|
||||
- STOP
|
||||
- STOP\_MARKET
|
||||
- TAKE\_PROFIT
|
||||
- TAKE\_PROFIT\_MARKET
|
||||
- TRAILING\_STOP\_MARKET
|
||||
|
||||
**Order side (side):**
|
||||
|
||||
- BUY
|
||||
- SELL
|
||||
|
||||
**Position side (positionSide):**
|
||||
|
||||
- BOTH
|
||||
- LONG
|
||||
- SHORT
|
||||
|
||||
**Time in force (timeInForce):**
|
||||
|
||||
- GTC - Good Till Cancel
|
||||
- IOC - Immediate or Cancel
|
||||
- FOK - Fill or Kill
|
||||
- GTX - Good Till Crossing (Post Only)
|
||||
|
||||
**Working Type (workingType)**
|
||||
|
||||
- MARK\_PRICE
|
||||
- CONTRACT\_PRICE
|
||||
|
||||
**New Order Response Type (newOrderRespType)**
|
||||
|
||||
- ACK
|
||||
- RESULT
|
||||
|
||||
**Price Match (priceMatch)**
|
||||
|
||||
- NONE: no price match
|
||||
- OPPONENT: counterparty best price
|
||||
- OPPONENT\_5: counterparty 5th best price
|
||||
- OPPONENT\_10: counterparty 10th best price
|
||||
- OPPONENT\_20: counterparty 20th best price
|
||||
- QUEUE: the best price on the same side of the order book
|
||||
- QUEUE\_5: the 5th best price on the same side of the order book
|
||||
- QUEUE\_10: the 10th best price on the same side of the order book
|
||||
- QUEUE\_20: the 20th best price on the same side of the order book
|
||||
|
||||
**Self-Trade Prevention mode (selfTradePreventionMode)**
|
||||
|
||||
- NONE: No Self-Trade Prevention
|
||||
- EXPIRE\_TAKER: expire taker order when STP trigger
|
||||
- EXPIRE\_BOTH: expire taker and maker order when STP trigger
|
||||
- EXPIRE\_MAKER: expire maker order when STP trigger
|
||||
|
||||
**Kline/Candlestick chart intervals:**
|
||||
|
||||
m -> minutes; h -> hours; d -> days; w -> weeks; M -> months
|
||||
|
||||
- 1m
|
||||
- 3m
|
||||
- 5m
|
||||
- 15m
|
||||
- 30m
|
||||
- 1h
|
||||
- 2h
|
||||
- 4h
|
||||
- 6h
|
||||
- 8h
|
||||
- 12h
|
||||
- 1d
|
||||
- 3d
|
||||
- 1w
|
||||
- 1M
|
||||
|
||||
**Rate limiters (rateLimitType)**
|
||||
|
||||
> REQUEST\_WEIGHT
|
||||
|
||||
```
|
||||
{ "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 6000 }
|
||||
```
|
||||
|
||||
> ORDERS
|
||||
|
||||
```
|
||||
{ "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200 }
|
||||
```
|
||||
|
||||
- REQUEST\_WEIGHT
|
||||
|
||||
- ORDERS
|
||||
|
||||
|
||||
**Rate limit intervals (interval)**
|
||||
|
||||
- MINUTE
|
||||
|
||||
# Filters
|
||||
|
||||
Filters define trading rules on a symbol or an exchange.
|
||||
|
||||
## Symbol filters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
### PRICE\_FILTER[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
> **/exchangeInfo format:**
|
||||
|
||||
```
|
||||
{ "filterType": "PRICE_FILTER", "minPrice": "0.00000100", "maxPrice": "100000.00000000", "tickSize": "0.00000100" }
|
||||
```
|
||||
|
||||
The `PRICE_FILTER` defines the `price` rules for a symbol. There are 3 parts:
|
||||
|
||||
- `minPrice` defines the minimum `price`/`stopPrice` allowed; disabled on `minPrice` == 0.
|
||||
- `maxPrice` defines the maximum `price`/`stopPrice` allowed; disabled on `maxPrice` == 0.
|
||||
- `tickSize` defines the intervals that a `price`/`stopPrice` can be increased/decreased by; disabled on `tickSize` == 0.
|
||||
|
||||
Any of the above variables can be set to 0, which disables that rule in the `price filter`. In order to pass the `price filter`, the following must be true for `price`/`stopPrice` of the enabled rules:
|
||||
|
||||
- `price` >= `minPrice`
|
||||
- `price` <= `maxPrice`
|
||||
- (`price`\-`minPrice`) % `tickSize` == 0
|
||||
|
||||
### LOT\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
> **/exchangeInfo format:**
|
||||
|
||||
```
|
||||
{ "filterType": "LOT_SIZE", "minQty": "0.00100000", "maxQty": "100000.00000000", "stepSize": "0.00100000" }
|
||||
```
|
||||
|
||||
The `LOT_SIZE` filter defines the `quantity` (aka "lots" in auction terms) rules for a symbol. There are 3 parts:
|
||||
|
||||
- `minQty` defines the minimum `quantity` allowed.
|
||||
- `maxQty` defines the maximum `quantity` allowed.
|
||||
- `stepSize` defines the intervals that a `quantity` can be increased/decreased by.
|
||||
|
||||
In order to pass the `lot size`, the following must be true for `quantity`:
|
||||
|
||||
- `quantity` >= `minQty`
|
||||
- `quantity` <= `maxQty`
|
||||
- (`quantity`\-`minQty`) % `stepSize` == 0
|
||||
|
||||
### MARKET\_LOT\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
> **/exchangeInfo format:**
|
||||
|
||||
```
|
||||
{ "filterType": "MARKET_LOT_SIZE", "minQty": "0.00100000", "maxQty": "100000.00000000", "stepSize": "0.00100000" }
|
||||
```
|
||||
|
||||
The `MARKET_LOT_SIZE` filter defines the `quantity` (aka "lots" in auction terms) rules for `MARKET` orders on a symbol. There are 3 parts:
|
||||
|
||||
- `minQty` defines the minimum `quantity` allowed.
|
||||
- `maxQty` defines the maximum `quantity` allowed.
|
||||
- `stepSize` defines the intervals that a `quantity` can be increased/decreased by.
|
||||
|
||||
In order to pass the `market lot size`, the following must be true for `quantity`:
|
||||
|
||||
- `quantity` >= `minQty`
|
||||
- `quantity` <= `maxQty`
|
||||
- (`quantity`\-`minQty`) % `stepSize` == 0
|
||||
|
||||
### MAX\_NUM\_ORDERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
> **/exchangeInfo format:**
|
||||
|
||||
```
|
||||
{ "filterType": "MAX_NUM_ORDERS", "limit": 200 }
|
||||
```
|
||||
|
||||
The `MAX_NUM_ORDERS` filter defines the maximum number of orders an account is allowed to have open on a symbol.
|
||||
|
||||
Note that both "algo" orders and normal orders are counted for this filter.
|
||||
|
||||
### PERCENT\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
|
||||
> **/exchangeInfo format:**
|
||||
|
||||
```
|
||||
{ "filterType": "PERCENT_PRICE", "multiplierUp": "1.0500", "multiplierDown": "0.9500", "multiplierDecimal": 4 }
|
||||
```
|
||||
|
||||
The `PERCENT_PRICE` filter defines valid range for a price based on the mark price.
|
||||
|
||||
In order to pass the `percent price`, the following must be true for `price`:
|
||||
|
||||
- BUY: `price` <= `markPrice` \* `multiplierUp`
|
||||
- SELL: `price` >= `markPrice` \* `multiplierDown`
|
||||
|
||||
- [Terminology](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [ENUM definitions](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [Symbol filters](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [PRICE\_FILTER](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [LOT\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [MARKET\_LOT\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [MAX\_NUM\_ORDERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
- [PERCENT\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/common-definition)
|
||||
+823
@@ -0,0 +1,823 @@
|
||||
---
|
||||
title: "Error Code | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code"
|
||||
fetched_at: "2026-01-27T05:28:02.148Z"
|
||||
---
|
||||
# Error Codes
|
||||
|
||||
> Here is the error JSON payload:
|
||||
|
||||
```
|
||||
{ "code":-1121, "msg":"Invalid symbol."}
|
||||
```
|
||||
|
||||
Errors consist of two parts: an error code and a message.
|
||||
Codes are universal,but messages can vary.
|
||||
|
||||
## 10xx - General Server or Network issues[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
### \-1000 UNKNOWN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- An unknown error occured while processing the request.
|
||||
|
||||
### \-1001 DISCONNECTED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Internal error; unable to process your request. Please try again.
|
||||
|
||||
### \-1002 UNAUTHORIZED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- You are not authorized to execute this request.
|
||||
|
||||
### \-1003 TOO\_MANY\_REQUESTS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Too many requests; current limit is %s requests per minute. Please use the websocket for live updates to avoid polling the API.
|
||||
- Way too many requests; IP banned until %s. Please use the websocket for live updates to avoid bans.
|
||||
|
||||
### \-1004 DUPLICATE\_IP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This IP is already on the white list
|
||||
|
||||
### \-1005 NO\_SUCH\_IP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No such IP has been white listed
|
||||
|
||||
### \-1006 UNEXPECTED\_RESP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- An unexpected response was received from the message bus. Execution status unknown.
|
||||
|
||||
### \-1007 TIMEOUT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Timeout waiting for response from backend server. Send status unknown; execution status unknown.
|
||||
|
||||
### \-1008 Request Throttled[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Server is currently overloaded with other requests. Please try again in a few minutes.
|
||||
- Request throttled by system-level protection. Reduce-only/close-position orders are exempt. Please try again.
|
||||
|
||||
### \-1010 ERROR\_MSG\_RECEIVED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- ERROR\_MSG\_RECEIVED.
|
||||
|
||||
### \-1011 NON\_WHITE\_LIST[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This IP cannot access this route.
|
||||
|
||||
### \-1013 INVALID\_MESSAGE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- INVALID\_MESSAGE.
|
||||
|
||||
### \-1014 UNKNOWN\_ORDER\_COMPOSITION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Unsupported order combination.
|
||||
|
||||
### \-1015 TOO\_MANY\_ORDERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Too many new orders.
|
||||
- Too many new orders; current limit is %s orders per %s.
|
||||
|
||||
### \-1016 SERVICE\_SHUTTING\_DOWN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This service is no longer available.
|
||||
|
||||
### \-1020 UNSUPPORTED\_OPERATION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This operation is not supported.
|
||||
|
||||
### \-1021 INVALID\_TIMESTAMP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Timestamp for this request is outside of the recvWindow.
|
||||
- Timestamp for this request was 1000ms ahead of the server's time.
|
||||
|
||||
### \-1022 INVALID\_SIGNATURE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Signature for this request is not valid.
|
||||
|
||||
### \-1023 START\_TIME\_GREATER\_THAN\_END\_TIME[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Start time is greater than end time.
|
||||
|
||||
## 11xx - Request issues[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
### \-1100 ILLEGAL\_CHARS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Illegal characters found in a parameter.
|
||||
- Illegal characters found in parameter '%s'; legal range is '%s'.
|
||||
|
||||
### \-1101 TOO\_MANY\_PARAMETERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Too many parameters sent for this endpoint.
|
||||
- Too many parameters; expected '%s' and received '%s'.
|
||||
- Duplicate values for a parameter detected.
|
||||
|
||||
### \-1102 MANDATORY\_PARAM\_EMPTY\_OR\_MALFORMED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- A mandatory parameter was not sent, was empty/null, or malformed.
|
||||
- Mandatory parameter '%s' was not sent, was empty/null, or malformed.
|
||||
- Param '%s' or '%s' must be sent, but both were empty/null!
|
||||
|
||||
### \-1103 UNKNOWN\_PARAM[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- An unknown parameter was sent.
|
||||
|
||||
### \-1104 UNREAD\_PARAMETERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Not all sent parameters were read.
|
||||
- Not all sent parameters were read; read '%s' parameter(s) but was sent '%s'.
|
||||
|
||||
### \-1105 PARAM\_EMPTY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- A parameter was empty.
|
||||
- Parameter '%s' was empty.
|
||||
|
||||
### \-1106 PARAM\_NOT\_REQUIRED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- A parameter was sent when not required.
|
||||
- Parameter '%s' sent when not required.
|
||||
|
||||
### \-1108 BAD\_ASSET[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid asset.
|
||||
|
||||
### \-1109 BAD\_ACCOUNT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid account.
|
||||
|
||||
### \-1110 BAD\_INSTRUMENT\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid symbolType.
|
||||
|
||||
### \-1111 BAD\_PRECISION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Precision is over the maximum defined for this asset.
|
||||
|
||||
### \-1112 NO\_DEPTH[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No orders on book for symbol.
|
||||
|
||||
### \-1113 WITHDRAW\_NOT\_NEGATIVE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Withdrawal amount must be negative.
|
||||
|
||||
### \-1114 TIF\_NOT\_REQUIRED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- TimeInForce parameter sent when not required.
|
||||
|
||||
### \-1115 INVALID\_TIF[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid timeInForce.
|
||||
|
||||
### \-1116 INVALID\_ORDER\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid orderType.
|
||||
|
||||
### \-1117 INVALID\_SIDE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid side.
|
||||
|
||||
### \-1118 EMPTY\_NEW\_CL\_ORD\_ID[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- New client order ID was empty.
|
||||
|
||||
### \-1119 EMPTY\_ORG\_CL\_ORD\_ID[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Original client order ID was empty.
|
||||
|
||||
### \-1120 BAD\_INTERVAL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid interval.
|
||||
|
||||
### \-1121 BAD\_SYMBOL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid symbol.
|
||||
|
||||
### \-1125 INVALID\_LISTEN\_KEY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This listenKey does not exist. Please use `POST /fapi/v1/listenKey` to recreate `listenKey`
|
||||
|
||||
### \-1127 MORE\_THAN\_XX\_HOURS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Lookup interval is too big.
|
||||
- More than %s hours between startTime and endTime.
|
||||
|
||||
### \-1128 OPTIONAL\_PARAMS\_BAD\_COMBO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Combination of optional parameters invalid.
|
||||
|
||||
### \-1130 INVALID\_PARAMETER[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid data sent for a parameter.
|
||||
- Data sent for parameter '%s' is not valid.
|
||||
|
||||
### \-1136 INVALID\_NEW\_ORDER\_RESP\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid newOrderRespType.
|
||||
|
||||
## 20xx - Processing Issues[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
### \-2010 NEW\_ORDER\_REJECTED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- NEW\_ORDER\_REJECTED
|
||||
|
||||
### \-2011 CANCEL\_REJECTED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- CANCEL\_REJECTED
|
||||
|
||||
### \-2013 NO\_SUCH\_ORDER[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Order does not exist.
|
||||
|
||||
### \-2014 BAD\_API\_KEY\_FMT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- API-key format invalid.
|
||||
|
||||
### \-2015 REJECTED\_MBX\_KEY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid API-key, IP, or permissions for action.
|
||||
|
||||
### \-2016 NO\_TRADING\_WINDOW[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No trading window could be found for the symbol. Try ticker/24hrs instead.
|
||||
|
||||
### \-2018 BALANCE\_NOT\_SUFFICIENT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Balance is insufficient.
|
||||
|
||||
### \-2019 MARGIN\_NOT\_SUFFICIEN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Margin is insufficient.
|
||||
|
||||
### \-2020 UNABLE\_TO\_FILL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Unable to fill.
|
||||
|
||||
### \-2021 ORDER\_WOULD\_IMMEDIATELY\_TRIGGER[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Order would immediately trigger.
|
||||
|
||||
### \-2022 REDUCE\_ONLY\_REJECT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- ReduceOnly Order is rejected.
|
||||
- This indicates the new reduce-only order conflicts with existing open orders; cancel the existing order and resubmit the reduce-only order.
|
||||
|
||||
### \-2023 USER\_IN\_LIQUIDATION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- User in liquidation mode now.
|
||||
|
||||
### \-2024 POSITION\_NOT\_SUFFICIENT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Position is not sufficient.
|
||||
|
||||
### \-2025 MAX\_OPEN\_ORDER\_EXCEEDED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Reach max open order limit.
|
||||
|
||||
### \-2026 REDUCE\_ONLY\_ORDER\_TYPE\_NOT\_SUPPORTED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- This OrderType is not supported when reduceOnly.
|
||||
|
||||
### \-2027 MAX\_LEVERAGE\_RATIO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Exceeded the maximum allowable position at current leverage.
|
||||
|
||||
### \-2028 MIN\_LEVERAGE\_RATIO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Leverage is smaller than permitted: insufficient margin balance.
|
||||
|
||||
## 40xx - Filters and other Issues[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
### \-4000 INVALID\_ORDER\_STATUS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid order status.
|
||||
|
||||
### \-4001 PRICE\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price less than 0.
|
||||
|
||||
### \-4002 PRICE\_GREATER\_THAN\_MAX\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price greater than max price.
|
||||
|
||||
### \-4003 QTY\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Quantity less than zero.
|
||||
|
||||
### \-4004 QTY\_LESS\_THAN\_MIN\_QTY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Quantity less than min quantity.
|
||||
|
||||
### \-4005 QTY\_GREATER\_THAN\_MAX\_QTY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Quantity greater than max quantity.
|
||||
|
||||
### \-4006 STOP\_PRICE\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Stop price less than zero.
|
||||
|
||||
### \-4007 STOP\_PRICE\_GREATER\_THAN\_MAX\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Stop price greater than max price.
|
||||
|
||||
### \-4008 TICK\_SIZE\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Tick size less than zero.
|
||||
|
||||
### \-4009 MAX\_PRICE\_LESS\_THAN\_MIN\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Max price less than min price.
|
||||
|
||||
### \-4010 MAX\_QTY\_LESS\_THAN\_MIN\_QTY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Max qty less than min qty.
|
||||
|
||||
### \-4011 STEP\_SIZE\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Step size less than zero.
|
||||
|
||||
### \-4012 MAX\_NUM\_ORDERS\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Max mum orders less than zero.
|
||||
|
||||
### \-4013 PRICE\_LESS\_THAN\_MIN\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price less than min price.
|
||||
|
||||
### \-4014 PRICE\_NOT\_INCREASED\_BY\_TICK\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price not increased by tick size.
|
||||
|
||||
### \-4015 INVALID\_CL\_ORD\_ID\_LEN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Client order id is not valid.
|
||||
- Client order id length should not be more than 36 chars
|
||||
|
||||
### \-4016 PRICE\_HIGHTER\_THAN\_MULTIPLIER\_UP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price is higher than mark price multiplier cap.
|
||||
|
||||
### \-4017 MULTIPLIER\_UP\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Multiplier up less than zero.
|
||||
|
||||
### \-4018 MULTIPLIER\_DOWN\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Multiplier down less than zero.
|
||||
|
||||
### \-4019 COMPOSITE\_SCALE\_OVERFLOW[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Composite scale too large.
|
||||
|
||||
### \-4020 TARGET\_STRATEGY\_INVALID[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Target strategy invalid for orderType '%s',reduceOnly '%b'.
|
||||
|
||||
### \-4021 INVALID\_DEPTH\_LIMIT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid depth limit.
|
||||
- '%s' is not valid depth limit.
|
||||
|
||||
### \-4022 WRONG\_MARKET\_STATUS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- market status sent is not valid.
|
||||
|
||||
### \-4023 QTY\_NOT\_INCREASED\_BY\_STEP\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Qty not increased by step size.
|
||||
|
||||
### \-4024 PRICE\_LOWER\_THAN\_MULTIPLIER\_DOWN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price is lower than mark price multiplier floor.
|
||||
|
||||
### \-4025 MULTIPLIER\_DECIMAL\_LESS\_THAN\_ZERO[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Multiplier decimal less than zero.
|
||||
|
||||
### \-4026 COMMISSION\_INVALID[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Commission invalid.
|
||||
- `%s` less than zero.
|
||||
- `%s` absolute value greater than `%s`
|
||||
|
||||
### \-4027 INVALID\_ACCOUNT\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid account type.
|
||||
|
||||
### \-4028 INVALID\_LEVERAGE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid leverage
|
||||
- Leverage `%s` is not valid
|
||||
- Leverage `%s` already exist with `%s`
|
||||
|
||||
### \-4029 INVALID\_TICK\_SIZE\_PRECISION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Tick size precision is invalid.
|
||||
|
||||
### \-4030 INVALID\_STEP\_SIZE\_PRECISION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Step size precision is invalid.
|
||||
|
||||
### \-4031 INVALID\_WORKING\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid parameter working type
|
||||
- Invalid parameter working type: `%s`
|
||||
|
||||
### \-4032 EXCEED\_MAX\_CANCEL\_ORDER\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Exceed maximum cancel order size.
|
||||
- Invalid parameter working type: `%s`
|
||||
|
||||
### \-4033 INSURANCE\_ACCOUNT\_NOT\_FOUND[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Insurance account not found.
|
||||
|
||||
### \-4044 INVALID\_BALANCE\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Balance Type is invalid.
|
||||
|
||||
### \-4045 MAX\_STOP\_ORDER\_EXCEEDED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Reach max stop order limit.
|
||||
|
||||
### \-4046 NO\_NEED\_TO\_CHANGE\_MARGIN\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No need to change margin type.
|
||||
|
||||
### \-4047 THERE\_EXISTS\_OPEN\_ORDERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Margin type cannot be changed if there exists open orders.
|
||||
|
||||
### \-4048 THERE\_EXISTS\_QUANTITY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Margin type cannot be changed if there exists position.
|
||||
|
||||
### \-4049 ADD\_ISOLATED\_MARGIN\_REJECT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Add margin only support for isolated position.
|
||||
|
||||
### \-4050 CROSS\_BALANCE\_INSUFFICIENT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Cross balance insufficient.
|
||||
|
||||
### \-4051 ISOLATED\_BALANCE\_INSUFFICIENT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Isolated balance insufficient.
|
||||
|
||||
### \-4052 NO\_NEED\_TO\_CHANGE\_AUTO\_ADD\_MARGIN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No need to change auto add margin.
|
||||
|
||||
### \-4053 AUTO\_ADD\_CROSSED\_MARGIN\_REJECT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Auto add margin only support for isolated position.
|
||||
|
||||
### \-4054 ADD\_ISOLATED\_MARGIN\_NO\_POSITION\_REJECT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Cannot add position margin: position is 0.
|
||||
|
||||
### \-4055 AMOUNT\_MUST\_BE\_POSITIVE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Amount must be positive.
|
||||
|
||||
### \-4056 INVALID\_API\_KEY\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid api key type.
|
||||
|
||||
### \-4057 INVALID\_RSA\_PUBLIC\_KEY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid api public key
|
||||
|
||||
### \-4058 MAX\_PRICE\_TOO\_LARGE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- maxPrice and priceDecimal too large,please check.
|
||||
|
||||
### \-4059 NO\_NEED\_TO\_CHANGE\_POSITION\_SIDE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No need to change position side.
|
||||
|
||||
### \-4060 INVALID\_POSITION\_SIDE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid position side.
|
||||
|
||||
### \-4061 POSITION\_SIDE\_NOT\_MATCH[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Order's position side does not match user's setting.
|
||||
|
||||
### \-4062 REDUCE\_ONLY\_CONFLICT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid or improper reduceOnly value.
|
||||
|
||||
### \-4067 POSITION\_SIDE\_CHANGE\_EXISTS\_OPEN\_ORDERS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Position side cannot be changed if there exists open orders.
|
||||
|
||||
### \-4068 POSITION\_SIDE\_CHANGE\_EXISTS\_QUANTITY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Position side cannot be changed if there exists position.
|
||||
|
||||
### \-4082 INVALID\_BATCH\_PLACE\_ORDER\_SIZE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid number of batch place orders.
|
||||
- Invalid number of batch place orders: %s
|
||||
|
||||
### \-4083 PLACE\_BATCH\_ORDERS\_FAIL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Fail to place batch orders.
|
||||
|
||||
### \-4084 UPCOMING\_METHOD[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Method is not allowed currently. Upcoming soon.
|
||||
|
||||
### \-4086 INVALID\_PRICE\_SPREAD\_THRESHOLD[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid price spread threshold.
|
||||
|
||||
### \-4087 INVALID\_PAIR[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid pair.
|
||||
|
||||
### \-4088 INVALID\_TIME\_INTERVAL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid time interval.
|
||||
- Maximum time interval is %s days.
|
||||
|
||||
### \-4089 REDUCE\_ONLY\_ORDER\_PERMISSION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- User can only place reduce only order.
|
||||
|
||||
### \-4090 NO\_PLACE\_ORDER\_PERMISSION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- User can not place order currently.
|
||||
|
||||
### \-4104 INVALID\_CONTRACT\_TYPE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid contract type.
|
||||
|
||||
### \-4110 INVALID\_CLIENT\_TRAN\_ID\_LEN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- clientTranId is not valid.
|
||||
- Client tran id length should be less than 64 chars.
|
||||
|
||||
### \-4111 DUPLICATED\_CLIENT\_TRAN\_ID[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- clientTranId is duplicated.
|
||||
- Client tran id should be unique within 7 days.
|
||||
|
||||
### \-4112 REDUCE\_ONLY\_MARGIN\_CHECK\_FAILED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- ReduceOnly Order Failed. Please check your existing position and open orders.
|
||||
- This indicates that the new reduce-only order, combined with an existing same-side open order, would create an opposite-side position and lead to insufficient margin; please cancel the open order and try again.
|
||||
|
||||
### \-4113 MARKET\_ORDER\_REJECT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- The counterparty's best price does not meet the PERCENT\_PRICE filter limit.
|
||||
|
||||
### \-4135 INVALID\_ACTIVATION\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Invalid activation price.
|
||||
|
||||
### \-4137 QUANTITY\_EXISTS\_WITH\_CLOSE\_POSITION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Quantity must be zero with closePosition equals true.
|
||||
|
||||
### \-4138 REDUCE\_ONLY\_MUST\_BE\_TRUE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Reduce only must be true with closePosition equals true.
|
||||
|
||||
### \-4139 ORDER\_TYPE\_CANNOT\_BE\_MKT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Order type can not be market if it's unable to cancel.
|
||||
|
||||
### \-4142 STRATEGY\_INVALID\_TRIGGER\_PRICE[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- REJECT: take profit or stop order will be triggered immediately.
|
||||
|
||||
### \-4150 ISOLATED\_LEVERAGE\_REJECT\_WITH\_POSITION[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Leverage reduction is not supported in Isolated Margin Mode with open positions.
|
||||
|
||||
### \-4151 PRICE\_HIGHTER\_THAN\_STOP\_MULTIPLIER\_UP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price is higher than stop price multiplier cap.
|
||||
- Limit price can't be higher than %s.
|
||||
|
||||
### \-4152 PRICE\_LOWER\_THAN\_STOP\_MULTIPLIER\_DOWN[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Price is lower than stop price multiplier floor.
|
||||
- Limit price can't be lower than %s.
|
||||
|
||||
### \-4154 STOP\_PRICE\_HIGHER\_THAN\_PRICE\_MULTIPLIER\_LIMIT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Stop price is higher than price multiplier cap.
|
||||
- Stop price can't be higher than %s
|
||||
|
||||
### \-4155 STOP\_PRICE\_LOWER\_THAN\_PRICE\_MULTIPLIER\_LIMIT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- PStop price is lower than price multiplier floor.
|
||||
- Stop price can't be lower than %s
|
||||
|
||||
### \-4178 MIN\_NOTIONAL[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Order's notional must be no smaller than one (unless you choose reduce only)
|
||||
- Order's notional must be no smaller than %s (unless you choose reduce only)
|
||||
|
||||
### \-4192 COOLING\_OFF\_PERIOD[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Trade forbidden due to Cooling-off Period.
|
||||
|
||||
### \-4194 ADJUST\_LEVERAGE\_KYC\_FAILED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Intermediate Personal Verification is required for adjusting leverage over 20x.
|
||||
|
||||
### \-4195 ADJUST\_LEVERAGE\_ONE\_MONTH\_FAILED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- More than 20x leverage is available one month after account registration.
|
||||
|
||||
### \-4196 LIMIT\_ORDER\_ONLY[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Only limit order is supported.
|
||||
|
||||
### \-4197 SAME\_ORDER[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- No need to modify the order.
|
||||
|
||||
### \-4198 EXCEED\_MAX\_MODIFY\_ORDER\_LIMIT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Exceed maximum modify order limit.
|
||||
|
||||
### \-4199 MOVE\_ORDER\_NOT\_ALLOWED\_SYMBOL\_REASON[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Symbol is not in trading status. Order amendment is not permitted.
|
||||
|
||||
### \-4200 ADJUST\_LEVERAGE\_X\_DAYS\_FAILED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- More than 20x leverage is available 30 days after Futures account registration.
|
||||
- More than 20x leverage is available %s days after Futures account registration.
|
||||
|
||||
### \-4201 ADJUST\_LEVERAGE\_KYC\_LIMIT[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Users in this country has limited adjust leverage.
|
||||
- Users in your location/country can only access a maximum leverage of %s
|
||||
|
||||
### \-4202 ADJUST\_LEVERAGE\_ACCOUNT\_SYMBOL\_FAILED[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Current symbol leverage cannot exceed 20 when using position limit adjustment service.
|
||||
|
||||
### \-4188 ME\_INVALID\_TIMESTAMP[](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
|
||||
- Timestamp for this request is outside of the ME recvWindow.
|
||||
|
||||
- [10xx - General Server or Network issues](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1000 UNKNOWN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1001 DISCONNECTED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1002 UNAUTHORIZED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1003 TOO\_MANY\_REQUESTS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1004 DUPLICATE\_IP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1005 NO\_SUCH\_IP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1006 UNEXPECTED\_RESP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1007 TIMEOUT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1008 Request Throttled](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1010 ERROR\_MSG\_RECEIVED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1011 NON\_WHITE\_LIST](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1013 INVALID\_MESSAGE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1014 UNKNOWN\_ORDER\_COMPOSITION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1015 TOO\_MANY\_ORDERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1016 SERVICE\_SHUTTING\_DOWN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1020 UNSUPPORTED\_OPERATION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1021 INVALID\_TIMESTAMP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1022 INVALID\_SIGNATURE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1023 START\_TIME\_GREATER\_THAN\_END\_TIME](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [11xx - Request issues](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1100 ILLEGAL\_CHARS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1101 TOO\_MANY\_PARAMETERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1102 MANDATORY\_PARAM\_EMPTY\_OR\_MALFORMED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1103 UNKNOWN\_PARAM](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1104 UNREAD\_PARAMETERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1105 PARAM\_EMPTY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1106 PARAM\_NOT\_REQUIRED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1108 BAD\_ASSET](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1109 BAD\_ACCOUNT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1110 BAD\_INSTRUMENT\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1111 BAD\_PRECISION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1112 NO\_DEPTH](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1113 WITHDRAW\_NOT\_NEGATIVE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1114 TIF\_NOT\_REQUIRED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1115 INVALID\_TIF](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1116 INVALID\_ORDER\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1117 INVALID\_SIDE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1118 EMPTY\_NEW\_CL\_ORD\_ID](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1119 EMPTY\_ORG\_CL\_ORD\_ID](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1120 BAD\_INTERVAL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1121 BAD\_SYMBOL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1125 INVALID\_LISTEN\_KEY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1127 MORE\_THAN\_XX\_HOURS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1128 OPTIONAL\_PARAMS\_BAD\_COMBO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1130 INVALID\_PARAMETER](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-1136 INVALID\_NEW\_ORDER\_RESP\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [20xx - Processing Issues](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2010 NEW\_ORDER\_REJECTED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2011 CANCEL\_REJECTED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2013 NO\_SUCH\_ORDER](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2014 BAD\_API\_KEY\_FMT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2015 REJECTED\_MBX\_KEY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2016 NO\_TRADING\_WINDOW](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2018 BALANCE\_NOT\_SUFFICIENT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2019 MARGIN\_NOT\_SUFFICIEN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2020 UNABLE\_TO\_FILL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2021 ORDER\_WOULD\_IMMEDIATELY\_TRIGGER](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2022 REDUCE\_ONLY\_REJECT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2023 USER\_IN\_LIQUIDATION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2024 POSITION\_NOT\_SUFFICIENT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2025 MAX\_OPEN\_ORDER\_EXCEEDED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2026 REDUCE\_ONLY\_ORDER\_TYPE\_NOT\_SUPPORTED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2027 MAX\_LEVERAGE\_RATIO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-2028 MIN\_LEVERAGE\_RATIO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [40xx - Filters and other Issues](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4000 INVALID\_ORDER\_STATUS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4001 PRICE\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4002 PRICE\_GREATER\_THAN\_MAX\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4003 QTY\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4004 QTY\_LESS\_THAN\_MIN\_QTY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4005 QTY\_GREATER\_THAN\_MAX\_QTY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4006 STOP\_PRICE\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4007 STOP\_PRICE\_GREATER\_THAN\_MAX\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4008 TICK\_SIZE\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4009 MAX\_PRICE\_LESS\_THAN\_MIN\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4010 MAX\_QTY\_LESS\_THAN\_MIN\_QTY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4011 STEP\_SIZE\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4012 MAX\_NUM\_ORDERS\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4013 PRICE\_LESS\_THAN\_MIN\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4014 PRICE\_NOT\_INCREASED\_BY\_TICK\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4015 INVALID\_CL\_ORD\_ID\_LEN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4016 PRICE\_HIGHTER\_THAN\_MULTIPLIER\_UP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4017 MULTIPLIER\_UP\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4018 MULTIPLIER\_DOWN\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4019 COMPOSITE\_SCALE\_OVERFLOW](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4020 TARGET\_STRATEGY\_INVALID](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4021 INVALID\_DEPTH\_LIMIT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4022 WRONG\_MARKET\_STATUS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4023 QTY\_NOT\_INCREASED\_BY\_STEP\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4024 PRICE\_LOWER\_THAN\_MULTIPLIER\_DOWN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4025 MULTIPLIER\_DECIMAL\_LESS\_THAN\_ZERO](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4026 COMMISSION\_INVALID](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4027 INVALID\_ACCOUNT\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4028 INVALID\_LEVERAGE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4029 INVALID\_TICK\_SIZE\_PRECISION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4030 INVALID\_STEP\_SIZE\_PRECISION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4031 INVALID\_WORKING\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4032 EXCEED\_MAX\_CANCEL\_ORDER\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4033 INSURANCE\_ACCOUNT\_NOT\_FOUND](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4044 INVALID\_BALANCE\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4045 MAX\_STOP\_ORDER\_EXCEEDED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4046 NO\_NEED\_TO\_CHANGE\_MARGIN\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4047 THERE\_EXISTS\_OPEN\_ORDERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4048 THERE\_EXISTS\_QUANTITY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4049 ADD\_ISOLATED\_MARGIN\_REJECT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4050 CROSS\_BALANCE\_INSUFFICIENT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4051 ISOLATED\_BALANCE\_INSUFFICIENT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4052 NO\_NEED\_TO\_CHANGE\_AUTO\_ADD\_MARGIN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4053 AUTO\_ADD\_CROSSED\_MARGIN\_REJECT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4054 ADD\_ISOLATED\_MARGIN\_NO\_POSITION\_REJECT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4055 AMOUNT\_MUST\_BE\_POSITIVE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4056 INVALID\_API\_KEY\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4057 INVALID\_RSA\_PUBLIC\_KEY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4058 MAX\_PRICE\_TOO\_LARGE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4059 NO\_NEED\_TO\_CHANGE\_POSITION\_SIDE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4060 INVALID\_POSITION\_SIDE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4061 POSITION\_SIDE\_NOT\_MATCH](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4062 REDUCE\_ONLY\_CONFLICT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4067 POSITION\_SIDE\_CHANGE\_EXISTS\_OPEN\_ORDERS](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4068 POSITION\_SIDE\_CHANGE\_EXISTS\_QUANTITY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4082 INVALID\_BATCH\_PLACE\_ORDER\_SIZE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4083 PLACE\_BATCH\_ORDERS\_FAIL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4084 UPCOMING\_METHOD](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4086 INVALID\_PRICE\_SPREAD\_THRESHOLD](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4087 INVALID\_PAIR](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4088 INVALID\_TIME\_INTERVAL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4089 REDUCE\_ONLY\_ORDER\_PERMISSION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4090 NO\_PLACE\_ORDER\_PERMISSION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4104 INVALID\_CONTRACT\_TYPE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4110 INVALID\_CLIENT\_TRAN\_ID\_LEN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4111 DUPLICATED\_CLIENT\_TRAN\_ID](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4112 REDUCE\_ONLY\_MARGIN\_CHECK\_FAILED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4113 MARKET\_ORDER\_REJECT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4135 INVALID\_ACTIVATION\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4137 QUANTITY\_EXISTS\_WITH\_CLOSE\_POSITION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4138 REDUCE\_ONLY\_MUST\_BE\_TRUE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4139 ORDER\_TYPE\_CANNOT\_BE\_MKT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4142 STRATEGY\_INVALID\_TRIGGER\_PRICE](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4150 ISOLATED\_LEVERAGE\_REJECT\_WITH\_POSITION](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4151 PRICE\_HIGHTER\_THAN\_STOP\_MULTIPLIER\_UP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4152 PRICE\_LOWER\_THAN\_STOP\_MULTIPLIER\_DOWN](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4154 STOP\_PRICE\_HIGHER\_THAN\_PRICE\_MULTIPLIER\_LIMIT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4155 STOP\_PRICE\_LOWER\_THAN\_PRICE\_MULTIPLIER\_LIMIT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4178 MIN\_NOTIONAL](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4192 COOLING\_OFF\_PERIOD](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4194 ADJUST\_LEVERAGE\_KYC\_FAILED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4195 ADJUST\_LEVERAGE\_ONE\_MONTH\_FAILED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4196 LIMIT\_ORDER\_ONLY](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4197 SAME\_ORDER](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4198 EXCEED\_MAX\_MODIFY\_ORDER\_LIMIT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4199 MOVE\_ORDER\_NOT\_ALLOWED\_SYMBOL\_REASON](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4200 ADJUST\_LEVERAGE\_X\_DAYS\_FAILED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4201 ADJUST\_LEVERAGE\_KYC\_LIMIT](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4202 ADJUST\_LEVERAGE\_ACCOUNT\_SYMBOL\_FAILED](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
- [\-4188 ME\_INVALID\_TIMESTAMP](https://developers.binance.com/docs/derivatives/coin-margined-futures/error-code)
|
||||
+416
@@ -0,0 +1,416 @@
|
||||
---
|
||||
title: "General Info | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info"
|
||||
fetched_at: "2026-01-27T05:28:02.210Z"
|
||||
---
|
||||
# General Info
|
||||
|
||||
## General API Information[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- The base endpoint is: **[https://dapi.binance.com](https://dapi.binance.com/)**
|
||||
- All endpoints return either a JSON object or array.
|
||||
- Data is returned in **ascending** order. Oldest first, newest last.
|
||||
- All time and timestamp related fields are in milliseconds.
|
||||
- All data types adopt definition in JAVA.
|
||||
|
||||
### Testnet API Information[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- Most of the endpoints can be also used in the testnet platform.
|
||||
- The REST baseurl for **testnet** is "[https://testnet.binancefuture.com](https://testnet.binancefuture.com/)"
|
||||
- The Websocket baseurl for **testnet** is "wss://dstream.binancefuture.com"
|
||||
|
||||
---
|
||||
|
||||
## General Information on Endpoints[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- For `GET` endpoints, parameters must be sent as a `query string`.
|
||||
- For `POST`, `PUT`, and `DELETE` endpoints, the parameters may be sent as a `query string` or in the `request body` with content type `application/x-www-form-urlencoded`. You may mix parameters between both the `query string` and `request body` if you wish to do so.
|
||||
- Parameters may be sent in any order.
|
||||
- If a parameter sent in both the `query string` and `request body`, the `query string` parameter will be used.
|
||||
|
||||
### HTTP Return Codes[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- HTTP `4XX` return codes are used for for malformed requests; the issue is on the sender's side.
|
||||
- HTTP `403` return code is used when the WAF Limit (Web Application Firewall) has been violated.
|
||||
- HTTP `408` return code is used when a timeout has occurred while waiting for a response from the backend server.
|
||||
- HTTP `429` return code is used when breaking a request rate limit.
|
||||
- HTTP `418` return code is used when an IP has been auto-banned for continuing to send requests after receiving `429` codes.
|
||||
- HTTP `5XX` return codes are used for internal errors; the issue is on Binance's side.
|
||||
1. If there is an error message **"Request occur unknown error."**, please retry later.
|
||||
- HTTP `503` return code is used when:
|
||||
1. If there is an error message **"Unknown error, please check your request or try again later."** returned in the response, the API successfully sent the request but not get a response within the timeout period.
|
||||
It is important to **NOT** treat this as a failure operation; the execution status is **UNKNOWN** and could have been a success;
|
||||
2. If there is an error message **"Service Unavailable."** returned in the response, it means this is a failure API operation and the service might be unavailable at the moment, you need to retry later.
|
||||
3. If there is an error message **"Internal error; unable to process your request. Please try again."** returned in the response, it means this is a failure API operation and you can resend your request if you need.
|
||||
4. If the response contains the error message **"Request throttled by system-level protection. Reduce-only/close-position orders are exempt. Please try again." (-1008)**, This indicates the node has exceeded its maximum concurrency and is temporarily throttled. Close-position, reduce-only, and cancel orders are exempt and will not receive this error.
|
||||
|
||||
### HTTP 503 Status: Message Variants & Handling[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
#### A. “Unknown error, please check your request or try again later.” (Execution status **unknown**)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- **Meaning**: Request accepted but no response before timeout; **execution may have succeeded**.
|
||||
- **Handling**:
|
||||
- **Do not treat as immediate failure**; first verify via **WebSocket updates** or **orderId queries** to avoid duplicates.
|
||||
- During peaks, prefer **single orders** over batch to reduce uncertainty.
|
||||
- **Rate-limit counting**: **May or may not** count, check header to verify rate limit info
|
||||
|
||||
#### B. “Service Unavailable.” (Failure)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- **Meaning**: Service temporarily unavailable; **100% failure**.
|
||||
- **Handling**: **Retry with exponential backoff** (e.g., 200ms → 400ms → 800ms, max 3–5 attempts).
|
||||
- **Rate-limit counting**: **not counted**
|
||||
|
||||
#### C. “Request throttled by system-level protection. Reduce-only/close-position orders are exempt. Please try again.” (**\-1008**, Failure)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- **Meaning**: System overload; **100% failure**.
|
||||
- **Handling**: **Retry with backoff** and **reduce concurrency**;
|
||||
- **Applicable endpoints**:
|
||||
- `POST /dapi/v1/order`
|
||||
- `POST /dapi/v1/batchOrders`
|
||||
- `POST /dapi/v1/order/test`
|
||||
- **Rate-limit counting**: **Not counted** (overload protection).
|
||||
- **Exception integrated here**: When a request **reduces exposure** (Reduce-only / Close-position: `closePosition = true`, or `positionSide = BOTH` with `reduceOnly = true`, or `LONG+SELL`, or `SHORT+BUY`), it is **not affected or prioritized under -1008** to ensure risk reduction.
|
||||
- Covered endpoints: `POST /dapi/v1/order`、`POST /dapi/v1/batchOrders` (when parameters satisfy the condition)
|
||||
|
||||
### Error Codes and Messages[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- Any endpoint can return an ERROR
|
||||
|
||||
> _**The error payload is as follows:**_
|
||||
|
||||
```
|
||||
{ "code": -1121, "msg": "Invalid symbol."}
|
||||
```
|
||||
|
||||
- Specific error codes and messages defined in [Error Codes](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info).
|
||||
|
||||
---
|
||||
|
||||
## LIMITS[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- The `/dapi/v1/exchangeInfo` `rateLimits` array contains objects related to the exchange's `RAW_REQUEST`, `REQUEST_WEIGHT`, and `ORDER` rate limits. These are further defined in the `ENUM definitions` section under `Rate limiters (rateLimitType)`.
|
||||
- A `429` will be returned when either rate limit is violated.
|
||||
|
||||
### IP Limits[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- Every request will contain `X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)` in the response headers which has the current used weight for the IP for all request rate limiters defined.
|
||||
- Each route has a `weight` which determines for the number of requests each endpoint counts for. Heavier endpoints and endpoints that do operations on multiple symbols will have a heavier `weight`.
|
||||
- When a 429 is received, it's your obligation as an API to back off and not spam the API.
|
||||
- **Repeatedly violating rate limits and/or failing to back off after receiving 429s will result in an automated IP ban (HTTP status 418).**
|
||||
- IP bans are tracked and **scale in duration** for repeat offenders, **from 2 minutes to 3 days**.
|
||||
- **The limits on the API are based on the IPs, not the API keys.**
|
||||
|
||||
### Order Rate Limits[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- Every order response will contain a `X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)` header which has the current order count for the account for all order rate limiters defined.
|
||||
- Rejected/unsuccessful orders are not guaranteed to have `X-MBX-ORDER-COUNT-**` headers in the response.
|
||||
- **The order rate limit is counted against each account**.
|
||||
|
||||
---
|
||||
|
||||
## Endpoint Security Type[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- Each endpoint has a security type that determines the how you will interact with it.
|
||||
- API-keys are passed into the Rest API via the `X-MBX-APIKEY` header.
|
||||
- API-keys and secret-keys **are case sensitive**.
|
||||
- API-keys can be configured to only access certain types of secure endpoints. For example, one API-key could be used for TRADE only, while another API-key can access everything except for TRADE routes.
|
||||
- By default, API-keys can access all secure routes.
|
||||
|
||||
Security Type
|
||||
|
||||
Description
|
||||
|
||||
NONE
|
||||
|
||||
Endpoint can be accessed freely.
|
||||
|
||||
TRADE
|
||||
|
||||
Endpoint requires sending a valid API-Key and signature.
|
||||
|
||||
USER\_DATA
|
||||
|
||||
Endpoint requires sending a valid API-Key and signature.
|
||||
|
||||
USER\_STREAM
|
||||
|
||||
Endpoint requires sending a valid API-Key.
|
||||
|
||||
MARKET\_DATA
|
||||
|
||||
Endpoint requires sending a valid API-Key.
|
||||
|
||||
- `TRADE` and `USER_DATA` endpoints are `SIGNED` endpoints.
|
||||
|
||||
### SIGNED (TRADE and USER\_DATA) Endpoint Security[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- `SIGNED` endpoints require an additional parameter, `signature`, to be sent in the `query string` or `request body`.
|
||||
- Endpoints use `HMAC SHA256` signatures. The `HMAC SHA256 signature` is a keyed `HMAC SHA256` operation. Use your `secretKey` as the key and `totalParams` as the value for the HMAC operation.
|
||||
- The `signature` is **not case sensitive**.
|
||||
- Please make sure the `signature` is the end part of your `query string` or `request body`.
|
||||
- `totalParams` is defined as the `query string` concatenated with the `request body`.
|
||||
|
||||
### Timing security[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- A `SIGNED` endpoint also requires a parameter, `timestamp`, to be sent which should be the millisecond timestamp of when the request was created and sent.
|
||||
- An additional parameter, `recvWindow`, may be sent to specify the number of milliseconds after `timestamp` the request is valid for. If `recvWindow` is not sent, **it defaults to 5000**.
|
||||
- If the server determines that the timestamp sent by the client is more than **one second** in the future of the server time, the request will also be rejected.
|
||||
|
||||
> The logic is as follows:
|
||||
|
||||
```
|
||||
if (timestamp < (serverTime + 1000) && (serverTime - timestamp) <= recvWindow){ // process request } else { // reject request }
|
||||
```
|
||||
|
||||
**Serious trading is about timing.** Networks can be unstable and unreliable, which can lead to requests taking varying amounts of time to reach the servers. With `recvWindow`, you can specify that the request must be processed within a certain number of milliseconds or be rejected by the server.
|
||||
|
||||
### SIGNED Endpoint Examples for POST /dapi/v1/order - HMAC Keys[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
Here is a step-by-step example of how to send a vaild signed payload from the Linux command line using `echo`, `openssl`, and `curl`.
|
||||
|
||||
Key
|
||||
|
||||
Value
|
||||
|
||||
apiKey
|
||||
|
||||
dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83
|
||||
|
||||
secretKey
|
||||
|
||||
2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9
|
||||
|
||||
Parameter
|
||||
|
||||
Value
|
||||
|
||||
symbol
|
||||
|
||||
BTCUSD\_200925
|
||||
|
||||
side
|
||||
|
||||
BUY
|
||||
|
||||
type
|
||||
|
||||
LIMIT
|
||||
|
||||
timeInForce
|
||||
|
||||
GTC
|
||||
|
||||
quantity
|
||||
|
||||
1
|
||||
|
||||
price
|
||||
|
||||
9000
|
||||
|
||||
recvWindow
|
||||
|
||||
5000
|
||||
|
||||
timestamp
|
||||
|
||||
1591702613943
|
||||
|
||||
#### Example 1: As a query string[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
> **Example 1**
|
||||
|
||||
> **HMAC SHA256 signature:**
|
||||
|
||||
```
|
||||
$ echo -n "symbol=BTCUSD_200925&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9" (stdin)= 21fd819734bf0e5c68740eed892909414d693635c5f7fffab1313925ae13556a
|
||||
```
|
||||
|
||||
> **curl command:**
|
||||
|
||||
```
|
||||
(HMAC SHA256) $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://dapi.binance.com/dapi/v1/order?symbol=BTCUSD_200925&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943&signature= 21fd819734bf0e5c68740eed892909414d693635c5f7fffab1313925ae13556a'
|
||||
```
|
||||
|
||||
- **queryString:**
|
||||
|
||||
symbol=BTCUSD\_200925
|
||||
&side=BUY
|
||||
&type=LIMIT
|
||||
&timeInForce=GTC
|
||||
&quantity=1
|
||||
&price=9000
|
||||
&recvWindow=5000
|
||||
×tamp=1591702613943
|
||||
|
||||
|
||||
#### Example 2: As a request body[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
> **Example 2**
|
||||
|
||||
> **HMAC SHA256 signature:**
|
||||
|
||||
```
|
||||
$ echo -n "symbol=BTCUSD_200925&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9" (stdin)= 21fd819734bf0e5c68740eed892909414d693635c5f7fffab1313925ae13556a
|
||||
```
|
||||
|
||||
> **curl command:**
|
||||
|
||||
```
|
||||
(HMAC SHA256) $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://dapi.binance.com/dapi/v1/order' -d 'symbol=BTCUSD_200925&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943&signature= 21fd819734bf0e5c68740eed892909414d693635c5f7fffab1313925ae13556a'
|
||||
```
|
||||
|
||||
- **requestBody:**
|
||||
|
||||
symbol=BTCUSD\_200925
|
||||
&side=BUY
|
||||
&type=LIMIT
|
||||
&timeInForce=GTC
|
||||
&quantity=1
|
||||
&price=9000
|
||||
&recvWindow=5000
|
||||
×tamp=1591702613943
|
||||
|
||||
|
||||
#### Example 3: Mixed query string and request body[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
> **Example 3**
|
||||
|
||||
> **HMAC SHA256 signature:**
|
||||
|
||||
```
|
||||
$ echo -n "symbol=BTCUSD_200925&side=BUY&type=LIMIT&timeInForce=GTCquantity=1&price=9000&recvWindow=5000×tamp= 1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9" (stdin)= f3129e7c72c7727037891ad8a86b76a7dc514ba125a536775c8ba403b2d1b222
|
||||
```
|
||||
|
||||
> **curl command:**
|
||||
|
||||
```
|
||||
(HMAC SHA256) $ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://dapi.binance.com/dapi/v1/order?symbol=BTCUSD_200925&side=BUY&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=9000&recvWindow=5000×tamp= 1591702613943&signature=f3129e7c72c7727037891ad8a86b76a7dc514ba125a536775c8ba403b2d1b222'
|
||||
```
|
||||
|
||||
- **queryString:** symbol=BTCUSD\_200925&side=BUY&type=LIMIT&timeInForce=GTC
|
||||
- **requestBody:** quantity=1&price=9000&recvWindow=5000×tamp= 1591702613943
|
||||
|
||||
Note that the signature is different in example 3.
|
||||
There is no & between "GTC" and "quantity=1".
|
||||
|
||||
### SIGNED Endpoint Examples for POST /dapi/v1/order - RSA Keys[](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
|
||||
- This will be a step by step process how to create the signature payload to send a valid signed payload.
|
||||
- We support `PKCS#8` currently.
|
||||
- To get your API key, you need to upload your RSA Public Key to your account and a corresponding API key will be provided for you.
|
||||
|
||||
For this example, the private key will be referenced as `test-prv-key.pem`
|
||||
|
||||
Key
|
||||
|
||||
Value
|
||||
|
||||
apiKey
|
||||
|
||||
vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2
|
||||
|
||||
Parameter
|
||||
|
||||
Value
|
||||
|
||||
symbol
|
||||
|
||||
BTCUSD\_PERP
|
||||
|
||||
side
|
||||
|
||||
SELL
|
||||
|
||||
type
|
||||
|
||||
MARKET
|
||||
|
||||
quantity
|
||||
|
||||
100
|
||||
|
||||
recvWindow
|
||||
|
||||
9999999
|
||||
|
||||
timestamp
|
||||
|
||||
1671090801999
|
||||
|
||||
> **Signature payload (with the listed parameters):**
|
||||
|
||||
```
|
||||
timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100
|
||||
```
|
||||
|
||||
**Step 1: Construct the payload**
|
||||
|
||||
Arrange the list of parameters into a string. Separate each parameter with a `&`.
|
||||
|
||||
**Step 2: Compute the signature:**
|
||||
|
||||
2.1 - Encode signature payload as ASCII data.
|
||||
|
||||
> **Step 2.2**
|
||||
|
||||
```
|
||||
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem
|
||||
```
|
||||
|
||||
2.2 - Sign payload using RSASSA-PKCS1-v1\_5 algorithm with SHA-256 hash function.
|
||||
|
||||
> **Step 2.3**
|
||||
|
||||
```
|
||||
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem | openssl enc -base64aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
|
||||
```
|
||||
|
||||
2.3 - Encode output as base64 string.
|
||||
|
||||
> **Step 2.4**
|
||||
|
||||
```
|
||||
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem | openssl enc -base64 | tr -d '\n'aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
|
||||
```
|
||||
|
||||
2.4 - Delete any newlines in the signature.
|
||||
|
||||
> **Step 2.5**
|
||||
|
||||
```
|
||||
aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
|
||||
```
|
||||
|
||||
2.5 - Since the signature may contain `/` and `=`, this could cause issues with sending the request. So the signature has to be URL encoded.
|
||||
|
||||
> **Step 2.6**
|
||||
|
||||
```
|
||||
curl -H "X-MBX-APIKEY: vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2" -X POST 'https://dapi.binance.com/dapi/v1/order?timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100&signature=aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D'
|
||||
```
|
||||
|
||||
2.6 - curl command
|
||||
|
||||
> **Bash script**
|
||||
|
||||
```
|
||||
#!/usr/bin/env bash# Set up authentication:apiKey="vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2" ### REPLACE THIS WITH YOUR API KEY# Set up the request:apiMethod="POST"apiCall="v1/order"apiParams="timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSD_PERP&side=SELL&type=MARKET&quantity=100"function rawurlencode { local value="$1" local len=${#value} local encoded="" local pos c o for (( pos=0 ; pos<len ; pos++ )) do c=${value:$pos:1} case "$c" in [-_.~a-zA-Z0-9] ) o="${c}" ;; * ) printf -v o '%%%02x' "'$c" esac encoded+="$o" done echo "$encoded"}ts=$(date +%s000)paramsWithTs="$apiParams×tamp=$ts"rawSignature=$(echo -n "$paramsWithTs" \ | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem \ ### THIS IS YOUR PRIVATE KEY. DO NOT SHARE THIS FILE WITH ANYONE. | openssl enc -base64 \ | tr -d '\n')signature=$(rawurlencode "$rawSignature")curl -H "X-MBX-APIKEY: $apiKey" -X $apiMethod \ "https://dapi.binance.com/dapi/$apiCall?$paramsWithTs&signature=$signature"
|
||||
```
|
||||
|
||||
A sample Bash script containing similar steps is available in the right side.
|
||||
|
||||
- [General API Information](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [Testnet API Information](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [General Information on Endpoints](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [HTTP Return Codes](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [HTTP 503 Status: Message Variants & Handling](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [Error Codes and Messages](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [LIMITS](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [IP Limits](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [Order Rate Limits](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [Endpoint Security Type](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [SIGNED (TRADE and USER\_DATA) Endpoint Security](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [Timing security](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [SIGNED Endpoint Examples for POST /dapi/v1/order - HMAC Keys](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
- [SIGNED Endpoint Examples for POST /dapi/v1/order - RSA Keys](https://developers.binance.com/docs/derivatives/coin-margined-futures/general-info)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Test Connectivity | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api"
|
||||
fetched_at: "2026-01-27T05:28:02.494Z"
|
||||
---
|
||||
# Test Connectivity
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
|
||||
Test connectivity to the Rest API.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
|
||||
GET `/dapi/v1/ping`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
|
||||
NONE
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
|
||||
```
|
||||
{}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api)
|
||||
+56
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: "24hr Ticker Price Change Statistics | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics"
|
||||
fetched_at: "2026-01-27T05:28:02.371Z"
|
||||
---
|
||||
# 24hr Ticker Price Change Statistics
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
|
||||
24 hour rolling window price change statistics.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
|
||||
GET `/dapi/v1/ticker/24hr`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
|
||||
**1** for a single symbol, **40** when the symbol parameter is omitted **Careful** when accessing this with no symbol.
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
> - Symbol and pair cannot be sent together
|
||||
> - If a pair is sent,tickers for all symbols of the pair will be returned
|
||||
> - If either a pair or symbol is sent, tickers for all symbols of all pairs will be returned
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_200925", "pair": "BTCUSD", "priceChange": "136.6", "priceChangePercent": "1.436", "weightedAvgPrice": "9547.3", "lastPrice": "9651.6", "lastQty": "1", "openPrice": "9515.0", "highPrice": "9687.0", "lowPrice": "9499.5", "volume": "494109", "baseVolume": "5192.94797687", "openTime": 1591170300000, "closeTime": 1591256718418, "firstId": 600507, // First tradeId "lastId": 697803, // Last tradeId "count": 97297 // Trade count }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/24hr-Ticker-Price-Change-Statistics)
|
||||
+87
@@ -0,0 +1,87 @@
|
||||
---
|
||||
title: "Basis | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis"
|
||||
fetched_at: "2026-01-27T05:28:02.535Z"
|
||||
---
|
||||
# Basis
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
|
||||
Query basis
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
|
||||
GET `/futures/data/basis`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
BTCUSD
|
||||
|
||||
contractType
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
CURRENT\_QUARTER, NEXT\_QUARTER, PERPETUAL
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Default 30,Max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
|
||||
```
|
||||
[ { "indexPrice": "29269.93972727", "contractType": "CURRENT_QUARTER", "basisRate": "0.0024", "futuresPrice": "29341.3", "annualizedBasisRate": "0.0283", "basis": "71.36027273", "pair": "BTCUSD", "timestamp": 1653381600000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Basis)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Check Server Time | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time"
|
||||
fetched_at: "2026-01-27T05:28:02.607Z"
|
||||
---
|
||||
# Check Server time
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
|
||||
Test connectivity to the Rest API and get the current server time.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
|
||||
GET `/dapi/v1/time`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
|
||||
NONE
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
|
||||
```
|
||||
{ "serverTime": 1499827319559}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Check-Server-time)
|
||||
+84
@@ -0,0 +1,84 @@
|
||||
---
|
||||
title: "Compressed Aggregate Trades List | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List"
|
||||
fetched_at: "2026-01-27T05:28:02.622Z"
|
||||
---
|
||||
# Compressed/Aggregate Trades List
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
|
||||
Get compressed, aggregate trades. Market trades that fill in 100ms with the same price and the same taking side will have the quantity aggregated.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
|
||||
GET `/dapi/v1/aggTrades`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
|
||||
**20**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
fromId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
ID to get aggregate trades from INCLUSIVE.
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get aggregate trades from INCLUSIVE.
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get aggregate trades until INCLUSIVE.
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1000.
|
||||
|
||||
> - support querying futures trade histories that are not older than one year
|
||||
> - If both `startTime` and `endTime` are sent, time between `startTime` and `endTime` must be less than 1 hour.
|
||||
> - If `fromId`, `startTime`, and `endTime` are not sent, the most recent aggregate trades will be returned.
|
||||
> - Only market trades will be aggregated and returned, which means the insurance fund trades and ADL trades won't be aggregated.
|
||||
> - Sending both `startTime`/`endTime` and `fromId` might cause response timeout, please send either `fromId` or `startTime`/`endTime`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
|
||||
```
|
||||
[ { "a": 416690, // Aggregate tradeId "p": "9642.4", // Price "q": "3", // Quantity "f": 595259, // First tradeId "l": 595259, // Last tradeId "T": 1591250548649, // Timestamp "m": false, // Was the buyer the maker? }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Compressed-Aggregate-Trades-List)
|
||||
+107
@@ -0,0 +1,107 @@
|
||||
---
|
||||
title: "Continuous Contract Kline Candlestick Data | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data"
|
||||
fetched_at: "2026-01-27T05:28:02.754Z"
|
||||
---
|
||||
# Continuous Contract Kline/Candlestick Data
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
|
||||
Kline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.
|
||||
|
||||
> - Contract type:
|
||||
> - PERPETUAL
|
||||
> - CURRENT\_QUARTER
|
||||
> - NEXT\_QUARTER
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
|
||||
GET `/dapi/v1/continuousKlines`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
|
||||
based on parameter `LIMIT`
|
||||
|
||||
LIMIT
|
||||
|
||||
weight
|
||||
|
||||
\[1,100)
|
||||
|
||||
1
|
||||
|
||||
\[100, 500)
|
||||
|
||||
2
|
||||
|
||||
\[500, 1000\]
|
||||
|
||||
5
|
||||
|
||||
> 1000 | 10
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
contractType
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
interval
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1500.
|
||||
|
||||
> - The difference between `startTime` and `endTime` can only be up to 200 days
|
||||
> - Between `startTime` and `endTime`, the most recent `limit` data from `endTime` will be returned:
|
||||
> - If `startTime` and `endTime` are not sent, current timestamp will be set as `endTime`, and the most recent data will be returned.
|
||||
> - If `startTime` is sent only, the timestamp of 200 days after `startTime` will be set as `endTime`(up to the current time)
|
||||
> - If `endTime` is sent only, the timestamp of 200 days before `endTime` will be set as `startTime`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
|
||||
```
|
||||
[ [ 1591258320000, // Open time "9640.7", // Open "9642.4", // High "9640.6", // Low "9642.0", // Close (or latest price) "206", // Volume 1591258379999, // Close time "2.13660389", // Base asset volume 48, // Number of trades "119", // Taker buy volume "1.23424865", // Taker buy base asset volume "0" // Ignore. ]]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Continuous-Contract-Kline-Candlestick-Data)
|
||||
+12
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: "Delist Schedule | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Delist-Schedule"
|
||||
fetched_at: "2026-01-27T05:28:02.791Z"
|
||||
---
|
||||
# Delist Schedule
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Delist-Schedule)
|
||||
|
||||
The Futures team will update the `deliveryDate` in the `Get /dapi/v1/exchangeInfo` endpoint to the delisting time after the delisting announcement is published. Please refer to [Exchange Info](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information) to check the delisting information of contract trading pairs in advance.
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Delist-Schedule)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Exchange Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information"
|
||||
fetched_at: "2026-01-27T05:28:03.009Z"
|
||||
---
|
||||
# Exchange Information
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
|
||||
Current exchange trading rules and symbol information
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
|
||||
GET `/dapi/v1/exchangeInfo`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
|
||||
1
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
|
||||
NONE
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
|
||||
```
|
||||
{ "exchangeFilters": [], "rateLimits": [ { "interval": "MINUTE", "intervalNum": 1, "limit": 6000, "rateLimitType": "REQUEST_WEIGHT" }, { "interval": "MINUTE", "intervalNum": 1, "limit": 6000, "rateLimitType": "ORDERS" } ], "serverTime": 1565613908500, // Ignore please. If you want to check current server time, please check via "GET /dapi/v1/time" "symbols": [ // contract symbols { "filters": [ { "filterType": "PRICE_FILTER", "maxPrice": "100000", "minPrice": "0.1", "tickSize": "0.1" }, { "filterType": "LOT_SIZE", "maxQty": "100000", "minQty": "1", "stepSize": "1" }, { "filterType": "MARKET_LOT_SIZE", "maxQty": "100000", "minQty": "1", "stepSize": "1" }, { "filterType": "MAX_NUM_ORDERS", "limit": 200 }, { "filterType": "PERCENT_PRICE", "multiplierUp": "1.0500", "multiplierDown": "0.9500", "multiplierDecimal": "4" } ], "OrderType": [ "LIMIT", "MARKET", "STOP", "TAKE_PROFIT", "TRAILING_STOP_MARKET" ], "timeInForce": [ "GTC", "IOC", "FOK", "GTX" ], "liquidationFee": "0.010000", // liquidation fee rate "marketTakeBound": "0.30", // the max price difference rate( from mark price) a market order can make "symbol": "BTCUSD_200925", // contract symbol name "pair": "BTCUSD", // underlying symbol "contractType": "CURRENT_QUARTER", "deliveryDate": 1601020800000, "onboardDate": 1590739200000, "contractStatus": "TRADING", "contractSize": 100, "quoteAsset": "USD", "baseAsset": "BTC", "marginAsset": "BTC", "pricePrecision": 1, // please do not use it as tickSize "quantityPrecision": 0, // please do not use it as stepSize "baseAssetPrecision": 8, "quotePrecision": 8, "equalQtyPrecision": 4, // ignore "triggerProtect": "0.0500", // threshold for algo order with "priceProtect" "maintMarginPercent": "2.5000", // ignore "requiredMarginPercent": "5.0000", // ignore "underlyingType": "COIN", "underlyingSubType": [] } ], "timezone": "UTC"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Exchange-Information)
|
||||
+24
@@ -0,0 +1,24 @@
|
||||
---
|
||||
title: "Get Funding Info | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info"
|
||||
fetched_at: "2026-01-27T05:28:03.020Z"
|
||||
---
|
||||
# Get Funding Rate Info
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
|
||||
Query funding rate info for symbols that had FundingRateCap/ FundingRateFloor / fundingIntervalHours adjustment
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
|
||||
GET `/dapi/v1/fundingInfo`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_PERP", "adjustedFundingRateCap": "0.02500000", "adjustedFundingRateFloor": "-0.02500000", "fundingIntervalHours": 8, "disclaimer": false // ignore }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Info)
|
||||
+72
@@ -0,0 +1,72 @@
|
||||
---
|
||||
title: "Get Funding Rate History Of Perpetual Futures | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures"
|
||||
fetched_at: "2026-01-27T05:28:03.017Z"
|
||||
---
|
||||
# Get Funding Rate History of Perpetual Futures
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
|
||||
Get Funding Rate History of Perpetual Futures
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
|
||||
GET `/dapi/v1/fundingRate`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get funding rate from INCLUSIVE.
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get funding rate until INCLUSIVE.
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 100; max 1000
|
||||
|
||||
> - empty array will be returned for delivery symbols.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_PERP", "fundingTime": 1596038400000, "fundingRate": "-0.00300000" }, { "symbol": "BTCUSD_PERP", "fundingTime": 1596067200000, "fundingRate": "-0.00300000" }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Get-Funding-Rate-History-of-Perpetual-Futures)
|
||||
+46
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: "Query Index Price Constituents | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents"
|
||||
fetched_at: "2026-01-27T05:28:03.049Z"
|
||||
---
|
||||
# Query Index Price Constituents
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
|
||||
Query index price constituents
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
|
||||
GET `/dapi/v1/constituents`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
|
||||
```
|
||||
{ "symbol": "BTCUSD", "time": 1697422647853, "constituents": [ { "exchange": "bitstamp", "symbol": "btcusd" }, { "exchange": "coinbase", "symbol": "BTC-USD" }, { "exchange": "kraken", "symbol": "XBT/USD" }, { "exchange": "binance_cross", "symbol": "BTCUSDC*index(USDCUSD)" } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Constituents)
|
||||
+96
@@ -0,0 +1,96 @@
|
||||
---
|
||||
title: "Index Price Kline Candlestick Data | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data"
|
||||
fetched_at: "2026-01-27T05:28:03.266Z"
|
||||
---
|
||||
# Index Price Kline/Candlestick Data
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
|
||||
Kline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
|
||||
GET `/dapi/v1/indexPriceKlines`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
|
||||
based on parameter `LIMIT`
|
||||
|
||||
LIMIT
|
||||
|
||||
weight
|
||||
|
||||
\[1,100)
|
||||
|
||||
1
|
||||
|
||||
\[100, 500)
|
||||
|
||||
2
|
||||
|
||||
\[500, 1000\]
|
||||
|
||||
5
|
||||
|
||||
> 1000 | 10
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
interval
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1500.
|
||||
|
||||
> - The difference between `startTime` and `endTime` can only be up to 200 days
|
||||
> - Between `startTime` and `endTime`, the most recent `limit` data from `endTime` will be returned:
|
||||
> - If `startTime` and `endTime` are not sent, current timestamp will be set as `endTime`, and the most recent data will be returned.
|
||||
> - If `startTime` is sent only, the timestamp of 200 days after `startTime` will be set as `endTime`(up to the current time)
|
||||
> - If `endTime` is sent only, the timestamp of 200 days before `endTime` will be set as `startTime`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
|
||||
```
|
||||
[ [ 1591256400000, // Open time "9653.69440000", // Open "9653.69640000", // High "9651.38600000", // Low "9651.55200000", // Close (or latest price) "0 ", // Ignore 1591256459999, // Close time "0", // Ignore 60, // Number of bisic data "0", // Ignore "0", // Ignore "0" // Ignore ]]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-Kline-Candlestick-Data)
|
||||
+54
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: "Index Price And Mark Price | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price"
|
||||
fetched_at: "2026-01-27T05:28:03.276Z"
|
||||
---
|
||||
# Index Price and Mark Price
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
|
||||
Query index price and mark price
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
|
||||
GET `/dapi/v1/premiumIndex`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
|
||||
**10**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
|
||||
> with symbol
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "markPrice": "11029.69574559", // mark price "indexPrice": "10979.14437500", // index price "estimatedSettlePrice": "10981.74168236", // Estimated Settle Price, only useful in the last hour before the settlement starts. "lastFundingRate": "0.00071003", // the lasted funding rate, for perpetual contract symbols only. For delivery symbols, "" will be shown. "interestRate": "0.00010000", // the base asset interest rate, for perpetual contract symbols only. For delivery symbols, "" will be shown. "nextFundingTime": 1596096000000, // For perpetual contract symbols only. For delivery symbols, 0 will be shown "time": 1596094042000 }, { "symbol": "BTCUSD_200925", "pair": "BTCUSD", "markPrice": "12077.01343750", "indexPrice": "10979.10312500", "estimatedSettlePrice": "10981.74168236", "lastFundingRate": "", "interestRate": "", "nextFundingTime": 0, "time": 1596094042000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Index-Price-and-Mark-Price)
|
||||
+116
@@ -0,0 +1,116 @@
|
||||
---
|
||||
title: "Kline Candlestick Data | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data"
|
||||
fetched_at: "2026-01-27T05:28:03.412Z"
|
||||
---
|
||||
# Kline/Candlestick Data
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
|
||||
Kline/candlestick bars for a symbol.
|
||||
Klines are uniquely identified by their open time.
|
||||
|
||||
- Kline/Candlestick chart intervals:
|
||||
m -> minutes; h -> hours; d -> days; w -> weeks; M -> months
|
||||
|
||||
- 1m
|
||||
- 3m
|
||||
- 5m
|
||||
- 15m
|
||||
- 30m
|
||||
- 1h
|
||||
- 2h
|
||||
- 4h
|
||||
- 6h
|
||||
- 8h
|
||||
- 12h
|
||||
- 1d
|
||||
- 3d
|
||||
- 1w
|
||||
- 1M
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
|
||||
GET `/dapi/v1/klines`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
|
||||
based on parameter `LIMIT`
|
||||
|
||||
LIMIT
|
||||
|
||||
weight
|
||||
|
||||
\[1,100)
|
||||
|
||||
1
|
||||
|
||||
\[100, 500)
|
||||
|
||||
2
|
||||
|
||||
\[500, 1000\]
|
||||
|
||||
5
|
||||
|
||||
> 1000 | 10
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
interval
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1500.
|
||||
|
||||
> - The difference between `startTime` and `endTime` can only be up to 200 days
|
||||
> - Between `startTime` and `endTime`, the most recent `limit` data from `endTime` will be returned:
|
||||
> - If `startTime` and `endTime` are not sent, current timestamp will be set as `endTime`, and the most recent data will be returned.
|
||||
> - If `startTime` is sent only, the timestamp of 200 days after `startTime` will be set as `endTime`(up to the current time)
|
||||
> - If `endTime` is sent only, the timestamp of 200 days before `endTime` will be set as `startTime`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
|
||||
```
|
||||
[ [ 1591258320000, // Open time "9640.7", // Open "9642.4", // High "9640.6", // Low "9642.0", // Close (or latest price) "206", // Volume 1591258379999, // Close time "2.13660389", // Base asset volume 48, // Number of trades "119", // Taker buy volume "1.23424865", // Taker buy base asset volume "0" // Ignore. ]]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data)
|
||||
+79
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: "Long Short Ratio | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio"
|
||||
fetched_at: "2026-01-27T05:28:03.306Z"
|
||||
---
|
||||
# Long/Short Ratio
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
|
||||
Query symbol Long/Short Ratio
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
|
||||
GET `/futures/data/globalLongShortAccountRatio`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
BTCUSD
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Default 30,Max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "longShortRatio": "0.1960", "longAccount": "0.6622", //66.22% "shortAccount": "0.3378", //33.78% "timestamp": 1583139600000 }, { "pair": "BTCUSD", "longShortRatio": "1.9559", "longAccount": "0.6617", "shortAccount": "0.3382", "timestamp": 1583139900000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Long-Short-Ratio)
|
||||
+96
@@ -0,0 +1,96 @@
|
||||
---
|
||||
title: "Mark Price Kline Candlestick Data | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data"
|
||||
fetched_at: "2026-01-27T05:28:03.523Z"
|
||||
---
|
||||
# Mark Price Kline/Candlestick Data
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
|
||||
Kline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
|
||||
GET `/dapi/v1/markPriceKlines`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
|
||||
based on parameter `LIMIT`
|
||||
|
||||
LIMIT
|
||||
|
||||
weight
|
||||
|
||||
\[1,100)
|
||||
|
||||
1
|
||||
|
||||
\[100, 500)
|
||||
|
||||
2
|
||||
|
||||
\[500, 1000\]
|
||||
|
||||
5
|
||||
|
||||
> 1000 | 10
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
interval
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1500.
|
||||
|
||||
> - The difference between `startTime` and `endTime` can only be up to 200 days
|
||||
> - Between `startTime` and `endTime`, the most recent `limit` data from `endTime` will be returned:
|
||||
> - If `startTime` and `endTime` are not sent, current timestamp will be set as `endTime`, and the most recent data will be returned.
|
||||
> - If `startTime` is sent only, the timestamp of 200 days after `startTime` will be set as `endTime`(up to the current time)
|
||||
> - If `endTime` is sent only, the timestamp of 200 days before `endTime` will be set as `startTime`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
|
||||
```
|
||||
[ [ 1591256460000, // Open time "9653.29201333", // Open "9654.56401333", // High "9653.07367333", // Low "9653.07367333", // Close (or latest price) "0 ", // Ignore 1591256519999, // Close time "0", // Ignore 60, // Number of bisic data "0", // Ignore "0", // Ignore "0" // Ignore ]]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Mark-Price-Kline-Candlestick-Data)
|
||||
+64
@@ -0,0 +1,64 @@
|
||||
---
|
||||
title: "Old Trades Lookup | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup"
|
||||
fetched_at: "2026-01-27T05:28:03.656Z"
|
||||
---
|
||||
# Old Trades Lookup(MARKET\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
|
||||
Get older market historical trades.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
|
||||
GET `/dapi/v1/historicalTrades`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
|
||||
**20**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 100; max 500.
|
||||
|
||||
fromId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
TradeId to fetch from. Default gets most recent trades.
|
||||
|
||||
> - Market trades means trades filled in the order book. Only market trades will be returned, which means the insurance fund trades and ADL trades won't be returned.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
|
||||
```
|
||||
[ { "id": 595103, "price": "9642.2", "qty": "1", "baseQty": "0.01037108", "time": 1499865549590, "isBuyerMaker": true, }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Old-Trades-Lookup)
|
||||
+87
@@ -0,0 +1,87 @@
|
||||
---
|
||||
title: "Open Interest Statistics | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics"
|
||||
fetched_at: "2026-01-27T05:28:03.665Z"
|
||||
---
|
||||
# Open Interest Statistics
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
|
||||
Query open interest stats
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
|
||||
GET `/futures/data/openInterestHist`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
BTCUSD
|
||||
|
||||
contractType
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
ALL, CURRENT\_QUARTER, NEXT\_QUARTER, PERPETUAL
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Default 30,Max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "contractType": "CURRENT_QUARTER", "sumOpenInterest": "20403", //unit: cont "sumOpenInterestValue": "176196512.23400000", //unit: base asset "timestamp": 1591261042378 }, { "pair": "BTCUSD", "contractType": "CURRENT_QUARTER", "sumOpenInterest": "20401", "sumOpenInterestValue": "176178704.98700000", "timestamp": 1583128200000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest-Statistics)
|
||||
+46
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: "Open Interest | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest"
|
||||
fetched_at: "2026-01-27T05:28:03.560Z"
|
||||
---
|
||||
# Open Interest
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
|
||||
Get present open interest of a specific symbol.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
|
||||
GET `/dapi/v1/openInterest`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
|
||||
```
|
||||
{ "symbol": "BTCUSD_200626", "pair": "BTCUSD", "openInterest": "15004", "contractType": "CURRENT_QUARTER", "time": 1591261042378}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Open-Interest)
|
||||
+74
@@ -0,0 +1,74 @@
|
||||
---
|
||||
title: "Order Book | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book"
|
||||
fetched_at: "2026-01-27T05:28:03.777Z"
|
||||
---
|
||||
# Order Book
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
|
||||
Query orderbook on specific symbol
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
|
||||
GET `/dapi/v1/depth`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
|
||||
Adjusted based on the limit:
|
||||
|
||||
Limit
|
||||
|
||||
Weight
|
||||
|
||||
5, 10, 20, 50
|
||||
|
||||
2
|
||||
|
||||
100
|
||||
|
||||
5
|
||||
|
||||
500
|
||||
|
||||
10
|
||||
|
||||
1000
|
||||
|
||||
20
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; Valid limits:\[5, 10, 20, 50, 100, 500, 1000\]
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
|
||||
```
|
||||
{ "lastUpdateId": 16769853, "symbol": "BTCUSD_PERP", // Symbol "pair": "BTCUSD", // Pair "E": 1591250106370, // Message output time "T": 1591250106368, // Transaction time "bids": [ [ "9638.0", // PRICE "431" // QTY ] ], "asks": [ [ "9638.2", "12" ] ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book)
|
||||
+94
@@ -0,0 +1,94 @@
|
||||
---
|
||||
title: "Premium Index Kline Data | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data"
|
||||
fetched_at: "2026-01-27T05:28:03.812Z"
|
||||
---
|
||||
# Premium index Kline Data
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
|
||||
Premium index kline bars of a symbol. Klines are uniquely identified by their open time.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
|
||||
GET `/dapi/v1/premiumIndexKlines`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
|
||||
based on parameter `LIMIT`
|
||||
|
||||
LIMIT
|
||||
|
||||
weight
|
||||
|
||||
\[1,100)
|
||||
|
||||
1
|
||||
|
||||
\[100, 500)
|
||||
|
||||
2
|
||||
|
||||
\[500, 1000\]
|
||||
|
||||
5
|
||||
|
||||
\> 1000
|
||||
|
||||
10
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
interval
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1500.
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent klines are returned.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
|
||||
```
|
||||
[ [ 1691603820000, // Open time "-0.00042931", // Open "-0.00023641", // High "-0.00059406", // Low "-0.00043659", // Close "0", // Ignore 1691603879999, // Close time "0", // Ignore 12, // Ignore "0", // Ignore "0", // Ignore "0" // Ignore ]]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Premium-Index-Kline-Data)
|
||||
+56
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: "Recent Trades List | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List"
|
||||
fetched_at: "2026-01-27T05:28:04.045Z"
|
||||
---
|
||||
# Recent Trades List
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
|
||||
Get recent market trades
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
|
||||
GET `/dapi/v1/trades`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
|
||||
5
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 500; max 1000.
|
||||
|
||||
- Market trades means trades filled in the order book. Only market trades will be returned, which means the insurance fund trades and ADL trades won't be returned.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
|
||||
```
|
||||
[ { "id": 28457, "price": "9635.0", "qty": "1", "baseQty": "0.01037883", "time": 1591250192508, "isBuyerMaker": true, }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Recent-Trades-List)
|
||||
+56
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: "Symbol Order Book Ticker | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker"
|
||||
fetched_at: "2026-01-27T05:28:03.926Z"
|
||||
---
|
||||
# Symbol Order Book Ticker
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
|
||||
Best price/qty on the order book for a symbol or symbols.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
|
||||
GET `/dapi/v1/ticker/bookTicker`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
|
||||
**2** for a single symbol, **5** when the symbol parameter is omitted
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
> - Symbol and pair cannot be sent together
|
||||
> - If a pair is sent,tickers for all symbols of the pair will be returned
|
||||
> - If either a pair or symbol is sent, tickers for all symbols of all pairs will be returned
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
|
||||
```
|
||||
[ { "lastUpdateId": 1027024, "symbol": "BTCUSD_200626", "pair": "BTCUSD", "bidPrice": "9650.1", "bidQty": "16", "askPrice": "9650.3", "askQty": "7", "time": 1591257300345 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Order-Book-Ticker)
|
||||
+56
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: "Symbol Price Ticker | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker"
|
||||
fetched_at: "2026-01-27T05:28:04.184Z"
|
||||
---
|
||||
# Symbol Price Ticker
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
|
||||
Latest price for a symbol or symbols.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
|
||||
GET `/dapi/v1/ticker/price`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
|
||||
**1** for a single symbol, **2** when the symbol parameter is omitted
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
> - Symbol and pair cannot be sent together
|
||||
> - If a pair is sent,tickers for all symbols of the pair will be returned
|
||||
> - If either a pair or symbol is sent, tickers for all symbols of all pairs will be returned
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_200626", "ps": "9647.8", // pair "price": "9647.8", "time": 1591257246176 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Symbol-Price-Ticker)
|
||||
+87
@@ -0,0 +1,87 @@
|
||||
---
|
||||
title: "Taker Buy Sell Volume | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume"
|
||||
fetched_at: "2026-01-27T05:28:04.064Z"
|
||||
---
|
||||
# Taker Buy/Sell Volume
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
|
||||
Taker Buy Volume: the total volume of buy orders filled by takers within the period. Taker Sell Volume: the total volume of sell orders filled by takers within the period.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
|
||||
GET `/futures/data/takerBuySellVol`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
BTCUSD
|
||||
|
||||
contractType
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
ALL, CURRENT\_QUARTER, NEXT\_QUARTER, PERPETUAL
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Default 30,Max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "contractType": "CURRENT_QUARTER", "takerBuyVol": "387", //unit: cont "takerSellVol": "248", //unit: cont "takerBuyVolValue": "2342.1220", //unit: base asset "takerSellVolValue": "4213.9800", //unit: base asset "timestamp": 1591261042378 }, { "pair": "BTCUSD", "contractType": "CURRENT_QUARTER", "takerBuyVol": "234", //unit: cont "takerSellVol": "121", //unit: cont "takerBuyVolValue": "4563.1320", //unit: base asset "takerSellVolValue": "3313.3940", //unit: base asset "timestamp": 1585615200000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Taker-Buy-Sell-Volume)
|
||||
+77
@@ -0,0 +1,77 @@
|
||||
---
|
||||
title: "Top Trader Long Short Account Ratio | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio"
|
||||
fetched_at: "2026-01-27T05:28:04.309Z"
|
||||
---
|
||||
# Top Trader Long/Short Ratio (Accounts)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
|
||||
The proportion of net long and net short accounts to total accounts of the top 20% users with the highest margin balance. Each account is counted once only. Long Account % = Accounts of top traders with net long positions / Total accounts of top traders with open positions Short Account % = Accounts of top traders with net short positions / Total accounts of top traders with open positions Long/Short Ratio (Accounts) = Long Account % / Short Account %
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
|
||||
GET `/futures/data/topLongShortAccountRatio`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
default 30, max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "longShortRatio": "1.8105", "longAccount": "0.6442", //64.42% "shortAccount": "0.3558", //35.58% "timestamp": 1591261042378 }, { "pair": "BTCUSD", "longShortRatio": "1.1110", "longAccount": "0.5263", "shortAccount": "0.4737", "timestamp": 1592870400000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Long-Short-Account-Ratio)
|
||||
+79
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: "Top Trader Long Short Position Ratio | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio"
|
||||
fetched_at: "2026-01-27T05:28:04.350Z"
|
||||
---
|
||||
# Top Trader Long/Short Ratio (Positions)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
|
||||
The proportion of net long and net short positions to total open positions of the top 20% users with the highest margin balance. Long Position % = Long positions of top traders / Total open positions of top traders Short Position % = Short positions of top traders / Total open positions of top traders Long/Short Ratio (Positions) = Long Position % / Short Position %
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
|
||||
GET `/futures/data/topLongShortPositionRatio`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
BTCUSD
|
||||
|
||||
period
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
"5m","15m","30m","1h","2h","4h","6h","12h","1d"
|
||||
|
||||
limit
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Default 30,Max 500
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - If startTime and endTime are not sent, the most recent data is returned.
|
||||
> - Only the data of the latest 30 days is available.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
|
||||
```
|
||||
[ { "pair": "BTCUSD", "longShortRatio": "0.7869", "longPosition": "0.6442", //64.42% "shortPosition": "0.4404", //44.04% "timestamp": 1592870400000 }, { "pair": "BTCUSD", "longShortRatio": "1.1231", "longPosition": "0.2363", "shortPosition": "0.4537", "timestamp": 1592956800000 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Top-Trader-Long-Short-Ratio)
|
||||
+54
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: "Classic Portfolio Margin Account Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints"
|
||||
fetched_at: "2026-01-27T05:28:04.311Z"
|
||||
---
|
||||
# Classic Portfolio Margin Account Information (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
|
||||
Get Classic Portfolio Margin current account information.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
|
||||
GET `/dapi/v1/pmAccountInfo`
|
||||
|
||||
## Request Weight(IP)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
asset
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
> - maxWithdrawAmount is for asset transfer out to the spot wallet.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
|
||||
```
|
||||
{ "maxWithdrawAmountUSD": "25347.92083245", // Classic Portfolio margin maximum virtual amount for transfer out in USD "asset": "BTC", // asset name "maxWithdrawAmount": "1.33663654", // maximum amount for transfer out}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
- [Request Weight(IP)](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/portfolio-margin-endpoints)
|
||||
+251
@@ -0,0 +1,251 @@
|
||||
---
|
||||
title: "New Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api"
|
||||
fetched_at: "2026-01-27T05:28:04.582Z"
|
||||
---
|
||||
# New Order (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
|
||||
Send in a new order.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
|
||||
POST `/dapi/v1/order`
|
||||
|
||||
## Request Weight(IP)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
|
||||
1 on 1min order rate limit(X-MBX-ORDER-COUNT-1M)
|
||||
0 on IP rate limit(x-mbx-used-weight-1m)
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
positionSide
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
Default `BOTH` for One-way Mode ; `LONG` or `SHORT` for Hedge Mode. It must be sent in Hedge Mode.
|
||||
|
||||
type
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
timeInForce
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
quantity measured by contract number, Cannot be sent with `closePosition`\=`true`
|
||||
|
||||
reduceOnly
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"true" or "false". default "false". Cannot be sent in Hedge Mode; cannot be sent with `closePosition`\=`true`(Close-All)
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
newClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
A unique id among open orders. Automatically generated if not sent. Can only be string following the rule: `^[\.A-Z\:/a-z0-9_-]{1,36}$`
|
||||
|
||||
stopPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
closePosition
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
`true`, `false`；Close-All,used with `STOP_MARKET` or `TAKE_PROFIT_MARKET`.
|
||||
|
||||
activationPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, default as the latest price(supporting different `workingType`)
|
||||
|
||||
callbackRate
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, min 0.1, max 10 where 1 for 1%
|
||||
|
||||
workingType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
stopPrice triggered by: "MARK\_PRICE", "CONTRACT\_PRICE". Default "CONTRACT\_PRICE"
|
||||
|
||||
priceProtect
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"TRUE" or "FALSE", default "FALSE". Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
newOrderRespType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
"ACK", "RESULT", default "ACK"
|
||||
|
||||
priceMatch
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
only avaliable for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
|
||||
|
||||
selfTradePreventionMode
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
`EXPIRE_TAKER`:expire taker order when STP triggers/ `EXPIRE_MAKER`:expire taker order when STP triggers/ `EXPIRE_BOTH`:expire both orders when STP triggers; default `EXPIRE_MAKER`
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Additional mandatory parameters based on `type`:
|
||||
|
||||
Type
|
||||
|
||||
Additional mandatory parameters
|
||||
|
||||
`LIMIT`
|
||||
|
||||
`timeInForce`, `quantity`, `price`
|
||||
|
||||
`MARKET`
|
||||
|
||||
`quantity`
|
||||
|
||||
`STOP/TAKE_PROFIT`
|
||||
|
||||
`price`, `stopPrice`
|
||||
|
||||
`STOP_MARKET/TAKE_PROFIT_MARKET`
|
||||
|
||||
`stopPrice`
|
||||
|
||||
`TRAILING_STOP_MARKET`
|
||||
|
||||
`callbackRate`
|
||||
|
||||
> - Order with type `STOP`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
>
|
||||
> - Order with type `TAKE_PROFIT`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
>
|
||||
> - Condition orders will be triggered when:
|
||||
>
|
||||
> - If parameter`priceProtect`is sent as true:
|
||||
> - when price reaches the `stopPrice` ，the difference rate between "MARK\_PRICE" and "CONTRACT\_PRICE" cannot be larger than the "triggerProtect" of the symbol
|
||||
> - "triggerProtect" of a symbol can be got from `GET /dapi/v1/exchangeInfo`
|
||||
> - `STOP`, `STOP_MARKET`:
|
||||
> - BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
> - SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
> - `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`:
|
||||
> - BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
> - SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
> - `TRAILING_STOP_MARKET`:
|
||||
> - BUY: the lowest price after order placed `<=` activationPrice`, and the latest price >`\= the lowest price \* (1 + `callbackRate`)
|
||||
> - SELL: the highest price after order placed >= `activationPrice`, and the latest price <= the highest price \* (1 - `callbackRate`)
|
||||
> - For `TRAILING_STOP_MARKET`, if you got such error code.
|
||||
> `{"code": -2021, "msg": "Order would immediately trigger."}`
|
||||
> means that the parameters you send do not meet the following requirements:
|
||||
>
|
||||
> - BUY: `activationPrice` should be smaller than latest price.
|
||||
> - SELL: `activationPrice` should be larger than latest price.
|
||||
> - If `newOrderRespType` is sent as `RESULT` :
|
||||
>
|
||||
> - `MARKET` order: the final FILLED result of the order will be return directly.
|
||||
> - `LIMIT` order with special `timeInForce`: the final status result of the order(FILLED or EXPIRED) will be returned directly.
|
||||
> - `STOP_MARKET`, `TAKE_PROFIT_MARKET` with `closePosition`\=`true`:
|
||||
>
|
||||
> - Follow the same rules for condition orders.
|
||||
> - If triggered,**close all** current long position( if `SELL`) or current short position( if `BUY`).
|
||||
> - Cannot be used with `quantity` parameter
|
||||
> - Cannot be used with `reduceOnly` parameter
|
||||
> - In Hedge Mode,cannot be used with `BUY` orders in `LONG` position side. and cannot be used with `SELL` orders in `SHORT` position side
|
||||
> - `selfTradePreventionMode` is only effective when `timeInForce` set to `IOC` or `GTC`.
|
||||
>
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
|
||||
```
|
||||
{ "clientOrderId": "testOrder", "cumQty": "0", "cumBase": "0", "executedQty": "0", "orderId": 22542179, "avgPrice": "0.0", "origQty": "10", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "origType": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1566818724722, "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE", //self trading preventation mode}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
- [Request Weight(IP)](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api)
|
||||
+107
@@ -0,0 +1,107 @@
|
||||
---
|
||||
title: "Query Account Trade List | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List"
|
||||
fetched_at: "2026-01-27T05:28:04.620Z"
|
||||
---
|
||||
# Account Trade List (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
|
||||
Get trades for a specific account and symbol.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
|
||||
GET `/dapi/v1/userTrades`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
|
||||
**20** with symbol，**40** with pair
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
orderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
fromId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Trade id to fetch from. Default gets most recent trades.
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 50; max 1000
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either symbol or pair must be sent
|
||||
> - Symbol and pair cannot be sent together
|
||||
> - Pair and fromId cannot be sent together
|
||||
> - OrderId can only be sent together with symbol
|
||||
> - If a pair is sent,tickers for all symbols of the pair will be returned
|
||||
> - The parameter `fromId` cannot be sent with `startTime` or `endTime`
|
||||
> - If startTime and endTime are both not sent, then the last 7 days' data will be returned.
|
||||
> - The time between startTime and endTime cannot be longer than 7 days.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
|
||||
```
|
||||
[ { 'symbol': 'BTCUSD_200626', 'id': 6, 'orderId': 28, 'pair': 'BTCUSD', 'side': 'SELL', 'price': '8800', 'qty': '1', 'realizedPnl': '0', 'marginAsset': 'BTC', 'baseQty': '0.01136364', 'commission': '0.00000454', 'commissionAsset': 'BTC', 'time': 1590743483586, 'positionSide': 'BOTH', 'buyer': false, 'maker': false }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Account-Trade-List)
|
||||
+102
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Query All Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders"
|
||||
fetched_at: "2026-01-27T05:28:04.567Z"
|
||||
---
|
||||
# All Orders (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
|
||||
Get all account orders; active, canceled, or filled.
|
||||
|
||||
- These orders will not be found:
|
||||
- order status is CANCELED or EXPIRED AND order has NO filled trade AND created time + 3 days < current time
|
||||
- order create time + 90 days < current time
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
|
||||
GET `/dapi/v1/allOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
|
||||
**20** with symbol, **40** with pair
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 50; max 100.
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
**Notes:**
|
||||
|
||||
> - Either `symbol` or `pair` must be sent.
|
||||
> - `pair` can't be sent with `orderId`
|
||||
> - If `orderId` is set, it will get orders >= that `orderId`. Otherwise most recent orders are returned.
|
||||
> - If orderId is set, it will get orders >= that orderId. Otherwise most recent orders are returned.
|
||||
> - The query time period must be less then 7 days( default as the recent 7 days).
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
|
||||
```
|
||||
[ { "avgPrice": "0.0", "clientOrderId": "abc", "cumBase": "0", "executedQty": "0", "orderId": 1917641, "origQty": "0.40", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "time": 1579276756075, // order time "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1579276756075, // update time "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE", //self trading preventation mode }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/All-Orders)
|
||||
+72
@@ -0,0 +1,72 @@
|
||||
---
|
||||
title: "Auto Cancel All Open Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders"
|
||||
fetched_at: "2026-01-27T05:28:04.736Z"
|
||||
---
|
||||
# Auto-Cancel All Open Orders (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
|
||||
Cancel all open orders of the specified symbol at the end of the specified countdown. This rest endpoint means to ensure your open orders are canceled in case of an outage. The endpoint should be called repeatedly as heartbeats so that the existing countdown time can be canceled and repalced by a new one. The system will check all countdowns **approximately every 10 milliseconds**, so please note that sufficient redundancy should be considered when using this function. We do not recommend setting the countdown time to be too precise or too small.
|
||||
|
||||
- Example usage:
|
||||
|
||||
> Call this endpoint at 30s intervals with an countdownTime of 120000 (120s).
|
||||
> If this endpoint is not called within 120 seconds, all your orders of the specified symbol will be automatically canceled.
|
||||
> If this endpoint is called with an countdownTime of 0, the countdown timer will be stopped.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
|
||||
POST `/dapi/v1/countdownCancelAll`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
|
||||
**10**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
countdownTime
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
countdown time, 1000 for 1 second. 0 to cancel the timer
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
|
||||
```
|
||||
{ "symbol": "BTCUSD_200925", "countdownTime": "100000"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Auto-Cancel-All-Open-Orders)
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
---
|
||||
title: "Cancel All Open Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders"
|
||||
fetched_at: "2026-01-27T05:28:04.824Z"
|
||||
---
|
||||
# Cancel All Open Orders(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
|
||||
Cancel All Open Orders
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
|
||||
DELETE `/dapi/v1/allOpenOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
|
||||
```
|
||||
{ "code": 200, "msg": "The operation of cancel all open order is done."}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders)
|
||||
+78
@@ -0,0 +1,78 @@
|
||||
---
|
||||
title: "Cancel Multiple Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders"
|
||||
fetched_at: "2026-01-27T05:28:04.848Z"
|
||||
---
|
||||
# Cancel Multiple Orders(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
|
||||
Cancel Multiple Orders
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
|
||||
DELETE `/dapi/v1/batchOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderIdList
|
||||
|
||||
LIST<LONG>
|
||||
|
||||
NO
|
||||
|
||||
max length 10
|
||||
e.g. \[1234567,2345678\]
|
||||
|
||||
origClientOrderIdList
|
||||
|
||||
LIST<STRING>
|
||||
|
||||
NO
|
||||
|
||||
max length 10
|
||||
e.g. \["my\_id\_1","my\_id\_2"\], encode the double quotes. No space after comma.
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderIdList` or `origClientOrderIdList` must be sent.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
|
||||
```
|
||||
[ { "avgPrice": "0.0", "clientOrderId": "myOrder1", "cumQty": "0", "cumBase": "0", "executedQty": "0", "orderId": 283194212, "origQty": "11", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "CANCELED", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE", //self trading preventation mode "updateTime": 1571110484038 }, { "code": -2011, "msg": "Unknown order sent." }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Multiple-Orders)
|
||||
+69
@@ -0,0 +1,69 @@
|
||||
---
|
||||
title: "Cancel Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order"
|
||||
fetched_at: "2026-01-27T05:28:04.885Z"
|
||||
---
|
||||
# Cancel Order (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
|
||||
Cancel an active order.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
|
||||
DELETE `/dapi/v1/order`
|
||||
|
||||
**Weight:** **1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
|
||||
```
|
||||
{ "avgPrice": "0.0", "clientOrderId": "myOrder1", "cumQty": "0", "cumBase": "0", "executedQty": "0", "orderId": 283194212, "origQty": "11", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "CANCELED", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1571110484038, "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE" //self trading preventation mode}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order)
|
||||
+67
@@ -0,0 +1,67 @@
|
||||
---
|
||||
title: "Change Initial Leverage | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage"
|
||||
fetched_at: "2026-01-27T05:28:04.988Z"
|
||||
---
|
||||
# Change Initial Leverage (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
|
||||
Change user's initial leverage in the specific symbol market.
|
||||
For Hedge Mode, LONG and SHORT positions of one symbol use the same initial leverage and share a total notional value.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
|
||||
POST `/dapi/v1/leverage`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
leverage
|
||||
|
||||
INT
|
||||
|
||||
YES
|
||||
|
||||
target initial leverage: int from 1 to 125
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
|
||||
```
|
||||
{ "leverage": 21, "maxQty": "1000", // maximum quantity of base asset "symbol": "BTCUSD_200925"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Initial-Leverage)
|
||||
+67
@@ -0,0 +1,67 @@
|
||||
---
|
||||
title: "Change Margin Type | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type"
|
||||
fetched_at: "2026-01-27T05:28:05.211Z"
|
||||
---
|
||||
# Change Margin Type (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
|
||||
Change user's margin type in the specific symbol market.For Hedge Mode, LONG and SHORT positions of one symbol use the same margin type.
|
||||
With ISOLATED margin type, margins of the LONG and SHORT positions are isolated from each other.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
|
||||
POST `/dapi/v1/marginType`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
marginType
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
ISOLATED, CROSSED
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
|
||||
```
|
||||
{ "code": 200, "msg": "success"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Margin-Type)
|
||||
+60
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Change Position Mode | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode"
|
||||
fetched_at: "2026-01-27T05:28:05.099Z"
|
||||
---
|
||||
# Change Position Mode(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
|
||||
Change user's position mode (Hedge Mode or One-way Mode ) on _**EVERY symbol**_
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
|
||||
POST `/dapi/v1/positionSide/dual`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
dualSidePosition
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
"true": Hedge Mode; "false": One-way Mode
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
|
||||
```
|
||||
{ "code": 200, "msg": "success"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Change-Position-Mode)
|
||||
+64
@@ -0,0 +1,64 @@
|
||||
---
|
||||
title: "Query Current All Open Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders"
|
||||
fetched_at: "2026-01-27T05:28:05.137Z"
|
||||
---
|
||||
# Current All Open Orders (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
|
||||
Get all open orders on a symbol. **Careful** when accessing this with no symbol.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
|
||||
GET `/dapi/v1/openOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
|
||||
**1** for a single symbol, **40** for mutltiple symbols
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
|
||||
```
|
||||
[ { "avgPrice": "0.0", "clientOrderId": "abc", "cumBase": "0", "executedQty": "0", "orderId": 1917641, "origQty": "0.40", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "time": 1579276756075, // order time "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1579276756075, // update time "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE" //self trading preventation mode }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Current-All-Open-Orders)
|
||||
+97
@@ -0,0 +1,97 @@
|
||||
---
|
||||
title: "Get Order Modify History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History"
|
||||
fetched_at: "2026-01-27T05:28:05.239Z"
|
||||
---
|
||||
# Get Order Modify History (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
|
||||
Get order modification history
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
|
||||
GET `/dapi/v1/orderAmendment`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get modification history from INCLUSIVE
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
Timestamp in ms to get modification history until INCLUSIVE
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default 50; max 100
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent, and the `orderId` will prevail if both are sent.
|
||||
> - Order modify history longer than 3 month is not avaliable
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
|
||||
```
|
||||
[ { "amendmentId": 5363, // Order modification ID "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629184560899, // Order modification time "amendment": { "price": { "before": "30004", "after": "30003.2" }, "origQty": { "before": "1", "after": "1" }, "count": 3 // Order modification count, representing the number of times the order has been modified } }, { "amendmentId": 5361, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629184533946, "amendment": { "price": { "before": "30005", "after": "30004" }, "origQty": { "before": "1", "after": "1" }, "count": 2 } }, { "amendmentId": 5325, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629182711787, "amendment": { "price": { "before": "30002", "after": "30005" }, "origQty": { "before": "1", "after": "1" }, "count": 1 } }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Order-Modify-History)
|
||||
+86
@@ -0,0 +1,86 @@
|
||||
---
|
||||
title: "Get Position Margin Change History | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History"
|
||||
fetched_at: "2026-01-27T05:28:05.356Z"
|
||||
---
|
||||
# Get Position Margin Change History(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
|
||||
Get position margin change history
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
|
||||
GET `/dapi/v1/positionMargin/history`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
type
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
1: Add position margin,2: Reduce position margin
|
||||
|
||||
startTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
endTime
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
limit
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
Default: 50
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
|
||||
```
|
||||
[ { "amount": "23.36332311", "asset": "BTC", "symbol": "BTCUSD_200925", "time": 1578047897183, "type": 1, "positionSide": "BOTH" }, { "amount": "100", "asset": "BTC", "symbol": "BTCUSD_200925", "time": 1578047900425, "type": 1, "positionSide": "LONG" }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Get-Position-Margin-Change-History)
|
||||
+82
@@ -0,0 +1,82 @@
|
||||
---
|
||||
title: "Modify Isolated Position Margin | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin"
|
||||
fetched_at: "2026-01-27T05:28:05.388Z"
|
||||
---
|
||||
# Modify Isolated Position Margin(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
|
||||
Modify Isolated Position Margin
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
|
||||
POST `/dapi/v1/positionMargin`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
positionSide
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
Default `BOTH` for One-way Mode ; `LONG` or `SHORT` for Hedge Mode. It must be sent with Hedge Mode.
|
||||
|
||||
amount
|
||||
|
||||
DECIMAL
|
||||
|
||||
YES
|
||||
|
||||
type
|
||||
|
||||
INT
|
||||
|
||||
YES
|
||||
|
||||
1: Add position margin,2: Reduce position margin
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Only for isolated symbol
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
|
||||
```
|
||||
{ "amount": 100.0, "code": 200, "msg": "Successfully modify position margin.", "type": 1}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Isolated-Position-Margin)
|
||||
+127
@@ -0,0 +1,127 @@
|
||||
---
|
||||
title: "Modify Multiple Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders"
|
||||
fetched_at: "2026-01-27T05:28:05.471Z"
|
||||
---
|
||||
# Modify Multiple Orders(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
|
||||
Modify Multiple Orders
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
|
||||
PUT `/dapi/v1/batchOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
batchOrders
|
||||
|
||||
list<JSON>
|
||||
|
||||
YES
|
||||
|
||||
order list. Max 5 orders
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
**Where `batchOrders` is the list of order parameters in JSON**
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
`SELL`, `BUY`
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Order quantity, cannot be sent with `closePosition=true`
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Parameter rules are same with `Modify Order`
|
||||
> - Batch modify orders are processed concurrently, and the order of matching is not guaranteed.
|
||||
> - The order of returned contents for batch modify orders is the same as the order of the order list.
|
||||
> - One order can only be modfied for less than 10000 times
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
|
||||
```
|
||||
[ { "orderId": 20072994037, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "price": "30005", "avgPrice": "0.0", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE", //self trading preventation mode "updateTime": 1629182711600 }, { "code": -2022, "msg": "ReduceOnly Order is rejected." }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Multiple-Orders)
|
||||
+108
@@ -0,0 +1,108 @@
|
||||
---
|
||||
title: "Modify Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order"
|
||||
fetched_at: "2026-01-27T05:28:05.637Z"
|
||||
---
|
||||
# Modify Order (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
|
||||
Order modify function, currently only LIMIT order modification is supported, modified orders will be reordered in the match queue
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
|
||||
PUT `/dapi/v1/order`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
`SELL`, `BUY`
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Order quantity, cannot be sent with `closePosition=true`
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
priceMatch
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
only avaliable for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent, and the `orderId` will prevail if both are sent.
|
||||
> - Either `quantity` or `price` must be sent.
|
||||
> - When the new `quantity` or `price` doesn't satisfy PRICE\_FILTER / PERCENT\_FILTER / LOT\_SIZE, amendment will be rejected and the order will stay as it is.
|
||||
> - However the order will be cancelled by the amendment in the following situations:
|
||||
> - when the order is in partially filled status and the new `quantity` <= `executedQty`
|
||||
> - When the order is `GTX` and the new price will cause it to be executed immediately
|
||||
> - One order can only be modfied for less than 10000 times
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
|
||||
```
|
||||
{ "orderId": 20072994037, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "price": "30005", "avgPrice": "0.0", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE", //self trading preventation mode "updateTime": 1629182711600}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order)
|
||||
+201
@@ -0,0 +1,201 @@
|
||||
---
|
||||
title: "Place Multiple Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders"
|
||||
fetched_at: "2026-01-27T05:28:05.750Z"
|
||||
---
|
||||
# Place Multiple Orders(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
|
||||
Place multiple orders
|
||||
|
||||
- Parameter rules are same with `New Order`
|
||||
- Batch orders are processed concurrently, and the order of matching is not guaranteed.
|
||||
- The order of returned contents for batch orders is the same as the order of the order list.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
|
||||
POST `/dapi/v1/batchOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
batchOrders
|
||||
|
||||
LIST<JSON>
|
||||
|
||||
YES
|
||||
|
||||
order list. Max 5 orders
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
**Where `batchOrders` is the list of order parameters in JSON**
|
||||
|
||||
- **Example:** /dapi/v1/batchOrders?batchOrders=\[{"type":"LIMIT","timeInForce":"GTC",
|
||||
"symbol":"BTCUSD\_PERP","side":"BUY","price":"10001","quantity":"1"}\]
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
positionSide
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
Default `BOTH` for One-way Mode ; `LONG` or `SHORT` for Hedge Mode. It must be sent with Hedge Mode.
|
||||
|
||||
type
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
timeInForce
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
YES
|
||||
|
||||
reduceOnly
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"true" or "false". default "false".
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
newClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
A unique id among open orders. Automatically generated if not sent. Can only be string following the rule: `^[\.A-Z\:/a-z0-9_-]{1,36}$`
|
||||
|
||||
stopPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
activationPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, default as the latest price(supporting different `workingType`)
|
||||
|
||||
callbackRate
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, min 0.1, max 4 where 1 for 1%
|
||||
|
||||
workingType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
stopPrice triggered by: "MARK\_PRICE", "CONTRACT\_PRICE". Default "CONTRACT\_PRICE"
|
||||
|
||||
priceProtect
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
"TRUE" or "FALSE", default "FALSE". Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
newOrderRespType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
"ACK", "RESULT", default "ACK"
|
||||
|
||||
priceMatch
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
only avaliable for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
|
||||
|
||||
selfTradePreventionMode
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
`EXPIRE_TAKER`:expire taker order when STP triggers/ `EXPIRE_MAKER`:expire taker order when STP triggers/ `EXPIRE_BOTH`:expire both orders when STP triggers; default `EXPIRE_MAKER`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
|
||||
```
|
||||
[ { "clientOrderId": "testOrder", "cumQty": "0", "cumBase": "0", "executedQty": "0", "orderId": 22542179, "avgPrice": "0.0", "origQty": "10", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "symbol": "BTCUSD_200925", "pair": "BTCUSD", "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "origType": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1566818724722, "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE" //self trading preventation mode }, { "code": -2022, "msg": "ReduceOnly Order is rejected." }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders)
|
||||
+65
@@ -0,0 +1,65 @@
|
||||
---
|
||||
title: "Position Adl Quantile Estimation | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation"
|
||||
fetched_at: "2026-01-27T05:28:05.655Z"
|
||||
---
|
||||
# Position ADL Quantile Estimation(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
|
||||
Query position ADL quantile estimation
|
||||
|
||||
> - Values update every 30s.
|
||||
> - Values 0, 1, 2, 3, 4 shows the queue position and possibility of ADL from low to high.
|
||||
> - For positions of the symbol are in One-way Mode or isolated margined in Hedge Mode, "LONG", "SHORT", and "BOTH" will be returned to show the positions' adl quantiles of different position sides.
|
||||
> - If the positions of the symbol are crossed margined in Hedge Mode:
|
||||
> - "HEDGE" as a sign will be returned instead of "BOTH";
|
||||
> - A same value caculated on unrealized pnls on long and short sides' positions will be shown for "LONG" and "SHORT" when there are positions in both of long and short sides.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
|
||||
GET `/dapi/v1/adlQuantile`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_200925", "adlQuantile": { // if the positions of the symbol are crossed margined in Hedge Mode, "LONG" and "SHORT" will be returned a same quantile value, and "HEDGE" will be returned instead of "BOTH". "LONG": 3, "SHORT": 3, "HEDGE": 0 // only a sign, ignore the value } }, { "symbol": "BTCUSD_201225", "adlQuantile": { // for positions of the symbol are in One-way Mode or isolated margined in Hedge Mode "LONG": 1, // adl quantile for "LONG" position in hedge mode "SHORT": 2, // adl qauntile for "SHORT" position in hedge mode "BOTH": 0 // adl qunatile for position in one-way mode } } ]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-ADL-Quantile-Estimation)
|
||||
+72
@@ -0,0 +1,72 @@
|
||||
---
|
||||
title: "Position Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information"
|
||||
fetched_at: "2026-01-27T05:28:05.731Z"
|
||||
---
|
||||
# Position Information(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
|
||||
Get current account information.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
|
||||
GET `/dapi/v1/positionRisk`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
marginAsset
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - If neither `marginAsset` nor `pair` is sent, positions of all symbols with `TRADING` status will be returned.
|
||||
> - for One-way Mode user, the response will only show the "BOTH" positions
|
||||
> - for Hedge Mode user, the response will show "BOTH", "LONG", and "SHORT" positions.
|
||||
|
||||
**Note**
|
||||
|
||||
> Please use with user data stream `ACCOUNT_UPDATE` to meet your timeliness and accuracy needs.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
|
||||
```
|
||||
[ { "symbol": "BTCUSD_201225", "positionAmt": "0", "entryPrice": "0.0", "breakEvenPrice": "0.0", // break-even price "markPrice": "0.00000000", "unRealizedProfit": "0.00000000", "liquidationPrice": "0", "leverage": "125", "maxQty": "50", // maximum quantity of base asset "marginType": "cross", "isolatedMargin": "0.00000000", "isAutoAddMargin": "false", "positionSide": "BOTH", "updateTime": 0 }, { "symbol": "BTCUSD_201225", "positionAmt": "1", "entryPrice": "11707.70000003", "breakEvenPrice": "11707.80000005", // break-even price "markPrice": "11788.66626667", "unRealizedProfit": "0.00005866", "liquidationPrice": "11667.63509587", "leverage": "125", "maxQty": "50", "marginType": "cross", "isolatedMargin": "0.00000000", "isAutoAddMargin": "false", "positionSide": "LONG", "updateTime": 1627026881327 }, { "symbol": "BTCUSD_201225", "positionAmt": "0", "entryPrice": "0.0", "breakEvenPrice": "0.0", // break-even price "markPrice": "0.00000000", "unRealizedProfit": "0.00000000", "liquidationPrice": "0", "leverage": "125", "maxQty": "50", "marginType": "cross", "isolatedMargin": "0.00000000", "isAutoAddMargin": "false", "positionSide": "SHORT", "updateTime":1627026881327 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Position-Information)
|
||||
+73
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: "Query Current Open Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order"
|
||||
fetched_at: "2026-01-27T05:28:05.895Z"
|
||||
---
|
||||
# Query Current Open Order(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
|
||||
Query Current Open Order
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
|
||||
GET `/dapi/v1/openOrder`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either`orderId` or `origClientOrderId` must be sent
|
||||
> - If the queried order has been filled or cancelled, the error message "Order does not exist" will be returned.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
|
||||
```
|
||||
{ "avgPrice": "0.0", "clientOrderId": "abc", "cumBase": "0", "executedQty": "0", "orderId": 1917641, "origQty": "0.40", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD" "time": 1579276756075, // order time "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1579276756075, "workingType": "CONTRACT_PRICE", "priceProtect": false // if conditional order trigger is protected "priceMatch": "NONE", // price match mode "selfTradePreventionMode": "NONE" // self trading preventation mode }
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Current-Open-Order)
|
||||
+76
@@ -0,0 +1,76 @@
|
||||
---
|
||||
title: "Query Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order"
|
||||
fetched_at: "2026-01-27T05:28:05.913Z"
|
||||
---
|
||||
# Query Order (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
|
||||
Check an order's status.
|
||||
|
||||
- These orders will not be found:
|
||||
- order status is CANCELED or EXPIRED AND order has NO filled trade AND created time + 3 days < current time
|
||||
- order create time + 90 days < current time
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
|
||||
GET `/dapi/v1/order`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
|
||||
```
|
||||
{ "avgPrice": "0.0", "clientOrderId": "abc", "cumBase": "0", "executedQty": "0", "orderId": 1917641, "origQty": "0.40", "origType": "TRAILING_STOP_MARKET", "price": "0", "reduceOnly": false, "side": "BUY", "positionSide": "SHORT", "status": "NEW", "stopPrice": "9300", // please ignore when order type is TRAILING_STOP_MARKET "closePosition": false, // if Close-All "symbol": "BTCUSD_200925", "pair": "BTCUSD", "time": 1579276756075, // order time "timeInForce": "GTC", "type": "TRAILING_STOP_MARKET", "activatePrice": "9020", // activation price, only return with TRAILING_STOP_MARKET order "priceRate": "0.3", // callback rate, only return with TRAILING_STOP_MARKET order "updateTime": 1579276756075, // update time "workingType": "CONTRACT_PRICE", "priceProtect": false, // if conditional order trigger is protected "priceMatch": "NONE", //price match mode "selfTradePreventionMode": "NONE" //self trading preventation mode}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order)
|
||||
+41
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: "Query Users Force Orders | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders"
|
||||
fetched_at: "2026-01-27T05:28:05.996Z"
|
||||
---
|
||||
# User's Force Orders(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
|
||||
User's Force Orders
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
|
||||
GET `/dapi/v1/forceOrders`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
|
||||
**20** with symbol, **50** without symbol
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
|
||||
```
|
||||
Name | Type | Mandatory | Description
|
||||
```
|
||||
|
||||
\------------- | ------ | --------- | ----------------------------------------------------------- symbol | STRING | NO | autoCloseType | ENUM | NO | "LIQUIDATION" for liquidation orders, "ADL" for ADL orders. startTime | LONG | NO | endTime | LONG | NO | limit | INT | NO | Default 50; max 100. recvWindow | LONG | NO | timestamp | LONG | YES |
|
||||
|
||||
> - If "autoCloseType" is not sent, orders with both of the types will be returned
|
||||
> - If "startTime" is not sent, data within 200 days before "endTime" can be queried
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
|
||||
```
|
||||
[ { "orderId": 165123080, "symbol": "BTCUSD_200925", "pair": "BTCUSD", "status": "FILLED", "clientOrderId": "autoclose-1596542005017000006", "price": "11326.9", "avgPrice": "11326.9", "origQty": "1", "executedQty": "1", "cumBase": "0.00882854", "timeInForce": "IOC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "SELL", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "time": 1596542005019, "updateTime": 1596542005050 }, { "orderId": 207251986, "symbol": "BTCUSD_200925", "pair": "BTCUSD", "status": "FILLED", "clientOrderId": "autoclose-1597307316020000006", "price": "11619.4", "avgPrice": "11661.2", "origQty": "1", "executedQty": "1", "cumBase": "0.00857544", "timeInForce": "IOC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "SELL", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "time": 1597307316022, "updateTime": 1597307316035 }]
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Users-Force-Orders)
|
||||
+251
@@ -0,0 +1,251 @@
|
||||
---
|
||||
title: "New Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api"
|
||||
fetched_at: "2026-01-27T05:28:06.014Z"
|
||||
---
|
||||
# New Order(TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
Send in a new order.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
`order.place`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "60fa4366-f96e-42fe-a82b-f819952c6db4", "method": "order.place", "params": { "apiKey": "", "price": "50000", "quantity": 1, "side": "BUY", "symbol": "BTCUSD_PERP", "timeInForce": "GTC", "timestamp": 1728413737111, "type": "LIMIT", "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
**0**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
BUY or SELL
|
||||
|
||||
positionSide
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
Default `BOTH` for One-way Mode; `LONG` or `SHORT` for Hedge Mode. It must be sent in Hedge Mode.
|
||||
|
||||
type
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
`LIMIT`, `MARKET`, `STOP`, `STOP_MARKET`, `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`, `TRAILING_STOP_MARKET`
|
||||
|
||||
timeInForce
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Quantity measured by contract number, Cannot be sent with `closePosition`\=`true`
|
||||
|
||||
reduceOnly
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
`true` or `false`. default `false`. Cannot be sent in Hedge Mode; cannot be sent with `closePosition`\=`true` (Close-All)
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
newClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
A unique id among open orders. Automatically generated if not sent. Can only be string following the rule: `^[\.A-Z\:/a-z0-9_-]{1,36}$`
|
||||
|
||||
stopPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
closePosition
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
`true`, `false`；Close-All，used with `STOP_MARKET` or `TAKE_PROFIT_MARKET`.
|
||||
|
||||
activationPrice
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, default as the latest price(supporting different workingType)
|
||||
|
||||
callbackRate
|
||||
|
||||
DECIMAL
|
||||
|
||||
NO
|
||||
|
||||
Used with `TRAILING_STOP_MARKET` orders, min 0.1, max 10 where 1 for 1%
|
||||
|
||||
workingType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
stopPrice triggered by: "MARK\_PRICE", "CONTRACT\_PRICE". Default "CONTRACT\_PRICE"
|
||||
|
||||
priceProtect
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
"TRUE" or "FALSE", default "FALSE". Used with `STOP/STOP_MARKET` or `TAKE_PROFIT/TAKE_PROFIT_MARKET` orders.
|
||||
|
||||
newOrderRespType
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
`ACK`,`RESULT`, default `ACK`
|
||||
|
||||
priceMatch
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
only available for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
|
||||
|
||||
selfTradePreventionMode
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
`NONE`: No STP / `EXPIRE_TAKER`:expire taker order when STP triggers/ `EXPIRE_MAKER`:expire taker order when STP triggers/ `EXPIRE_BOTH`:expire both orders when STP triggers; default `NONE`
|
||||
|
||||
recvWindow
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
INT
|
||||
|
||||
YES
|
||||
|
||||
Additional mandatory parameters based on `type`:
|
||||
|
||||
Type
|
||||
|
||||
Additional mandatory parameters
|
||||
|
||||
`LIMIT`
|
||||
|
||||
`timeInForce`, `quantity`, `price`
|
||||
|
||||
`MARKET`
|
||||
|
||||
`quantity`
|
||||
|
||||
`STOP/TAKE_PROFIT`
|
||||
|
||||
`quantity`, `price`, `stopPrice`
|
||||
|
||||
`STOP_MARKET/TAKE_PROFIT_MARKET`
|
||||
|
||||
`stopPrice`
|
||||
|
||||
`TRAILING_STOP_MARKET`
|
||||
|
||||
`callbackRate`
|
||||
|
||||
- Order with type `STOP`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
- Order with type `TAKE_PROFIT`, parameter `timeInForce` can be sent ( default `GTC`).
|
||||
- Condition orders will be triggered when:
|
||||
- If parameter `priceProtect` is sent as true:
|
||||
- when price reaches the `stopPrice`，the difference rate between "MARK\_PRICE" and "CONTRACT\_PRICE" cannot be larger than the "triggerProtect" of the symbol
|
||||
- "triggerProtect" of a symbol can be got from `GET /dapi/v1/exchangeInfo`
|
||||
- `STOP`, `STOP_MARKET`:
|
||||
- BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
- SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
- `TAKE_PROFIT`, `TAKE_PROFIT_MARKET`:
|
||||
- BUY: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") <= `stopPrice`
|
||||
- SELL: latest price ("MARK\_PRICE" or "CONTRACT\_PRICE") >= `stopPrice`
|
||||
- `TRAILING_STOP_MARKET`:
|
||||
- BUY: the lowest price after order placed <= `activationPrice`, and the latest price >= the lowest price \* (1 + `callbackRate`)
|
||||
- SELL: the highest price after order placed >= `activationPrice`, and the latest price <= the highest price \* (1 - `callbackRate`)
|
||||
- For `TRAILING_STOP_MARKET`, if you got such error code. `{"code": -2021, "msg": "Order would immediately trigger."}` means that the parameters you send do not meet the following requirements:
|
||||
- BUY: `activationPrice` should be smaller than latest price.
|
||||
- SELL: `activationPrice` should be larger than latest price.
|
||||
- If `newOrderRespType` is sent as `RESULT`:
|
||||
- `MARKET` order: the final FILLED result of the order will be return directly.
|
||||
- `LIMIT` order with special `timeInForce`: the final status result of the order(FILLED or EXPIRED) will be returned directly.
|
||||
- `STOP_MARKET`, `TAKE_PROFIT_MARKET` with `closePosition=true`:
|
||||
- Follow the same rules for condition orders.
|
||||
- If triggered，**close all** current long position(if `SELL`) or current short position(if `BUY`).
|
||||
- Cannot be used with `quantity` parameter
|
||||
- Cannot be used with `reduceOnly` parameter
|
||||
- In Hedge Mode, cannot be used with `BUY` orders in `LONG` position side. and cannot be used with `SELL` orders in `SHORT` position side
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
|
||||
```
|
||||
{ "id": "60fa4366-f96e-42fe-a82b-f819952c6db4", "status": 200, "result": { "orderId": 333245211, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA", "price": "50000", "avgPrice": "0.00", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "updateTime": 1728413795125 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "count": 1 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api)
|
||||
+79
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: "Cancel Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order"
|
||||
fetched_at: "2026-01-27T05:28:06.150Z"
|
||||
---
|
||||
# Cancel Order (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
Cancel an active order.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
`order.cancel`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
```
|
||||
{ "id": "a8627ea5-8b9f-452f-90ae-4136f2b442e2", "method": "order.cancel", "params": { "apiKey": "", "orderId": 333245211, "symbol": "BTCUSD_PERP", "timestamp": 1728416090517, "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
|
||||
```
|
||||
{ "id": "a8627ea5-8b9f-452f-90ae-4136f2b442e2", "status": 200, "result": { "orderId": 333245211, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "CANCELED", "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA", "price": "51000", "avgPrice": "0.00", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "updateTime": 1728416138285 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Cancel-Order)
|
||||
+115
@@ -0,0 +1,115 @@
|
||||
---
|
||||
title: "Modify Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order"
|
||||
fetched_at: "2026-01-27T05:28:06.318Z"
|
||||
---
|
||||
# Modify Order (TRADE)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
Order modify function, currently only LIMIT order modification is supported, modified orders will be reordered in the match queue
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
`order.modify`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
```
|
||||
{ "id": "88601d02-bd0d-430d-8733-2708a569ebda", "method": "order.modify", "params": { "apiKey": "", "orderId": 333245211, "price": "51000", "quantity": 1, "side": "BUY", "symbol": "BTCUSD_PERP", "timestamp": 1728415697189, "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
1 on 10s order rate limit(X-MBX-ORDER-COUNT-10S); 1 on 1min order rate limit(X-MBX-ORDER-COUNT-1M); 1 on IP rate limit(x-mbx-used-weight-1m)
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
side
|
||||
|
||||
ENUM
|
||||
|
||||
YES
|
||||
|
||||
`SELL`, `BUY`
|
||||
|
||||
quantity
|
||||
|
||||
DECIMAL
|
||||
|
||||
YES
|
||||
|
||||
Order quantity, cannot be sent with `closePosition=true`
|
||||
|
||||
price
|
||||
|
||||
DECIMAL
|
||||
|
||||
YES
|
||||
|
||||
priceMatch
|
||||
|
||||
ENUM
|
||||
|
||||
NO
|
||||
|
||||
only avaliable for `LIMIT`/`STOP`/`TAKE_PROFIT` order; can be set to `OPPONENT`/ `OPPONENT_5`/ `OPPONENT_10`/ `OPPONENT_20`: /`QUEUE`/ `QUEUE_5`/ `QUEUE_10`/ `QUEUE_20`; Can't be passed together with `price`
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent, and the `orderId` will prevail if both are sent.
|
||||
> - Both `quantity` and `price` must be sent, which is different from dapi modify order endpoint.
|
||||
> - When the new `quantity` or `price` doesn't satisfy PRICE\_FILTER / PERCENT\_FILTER / LOT\_SIZE, amendment will be rejected and the order will stay as it is.
|
||||
> - However the order will be cancelled by the amendment in the following situations:
|
||||
> - when the order is in partially filled status and the new `quantity` <= `executedQty`
|
||||
> - When the order is `GTX` and the new price will cause it to be executed immediately
|
||||
> - One order can only be modfied for less than 10000 times
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
|
||||
```
|
||||
{ "id": "88601d02-bd0d-430d-8733-2708a569ebda", "status": 200, "result": { "orderId": 333245211, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA", "price": "51000", "avgPrice": "0.00", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "updateTime": 1728415765493 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "count": 1 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Modify-Order)
|
||||
+75
@@ -0,0 +1,75 @@
|
||||
---
|
||||
title: "Position Information | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information"
|
||||
fetched_at: "2026-01-27T05:28:06.392Z"
|
||||
---
|
||||
# Position Information(USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
Get current position information.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
`account.position`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
```
|
||||
{ "id": "233b8741-a96d-48e8-8ce1-160f43548aeb", "method": "account.position", "params": { "apiKey": "", "pair": "BTCUSD", "timestamp": 1727825241779, "signature": "0f04368b2d22aafd0ggc8809ea34297eff602272917b5f01267db4efbc1c9422" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
**5**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
marginAsset
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
pair
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
**Note**
|
||||
|
||||
> - Please use with user data stream `ACCOUNT_UPDATE` to meet your timeliness and accuracy needs.
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
|
||||
```
|
||||
{ "id": "233b8741-a96d-48e8-8ce1-160f43548aeb", "status": 200, "result": [ { "symbol": "BTCUSD_PERP", "positionAmt": "0", "entryPrice": "0.00000000", "markPrice": "62297.60417296", "unRealizedProfit": "0.00000000", "liquidationPrice": "0", "leverage": "7", "maxQty": "100", "marginType": "cross", "isolatedMargin": "0.00000000", "isAutoAddMargin": "false", "positionSide": "BOTH", "notionalValue": "0", "isolatedWallet": "0", "updateTime": 1726731195634, "breakEvenPrice": "0.00000000" }, // ... ... ], "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 10 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Position-Information)
|
||||
+86
@@ -0,0 +1,86 @@
|
||||
---
|
||||
title: "Query Order | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order"
|
||||
fetched_at: "2026-01-27T05:28:06.284Z"
|
||||
---
|
||||
# Query Order (USER\_DATA)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
Check an order's status.
|
||||
|
||||
- These orders will not be found:
|
||||
- order status is `CANCELED` or `EXPIRED` **AND** order has NO filled trade **AND** created time + 3 days < current time
|
||||
- order create time + 90 days < current time
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
`order.status`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
```
|
||||
{ "id": "0ce5d070-a5e5-4ff2-b57f-1556741a4204", "method": "order.status", "params": { "apiKey": "HMOchcfii9ZRZnhjp2XjGXhsOBd6msAhKz9joQaWwZ7arcJTlD2hGPHQj1lGdTjR", "orderId": 328999071, "symbol": "BTCUSD_PERP", "timestamp": 1703441060152, "signature": "ba48184fc38a71d03d2b5435bd67c1206e3191e989fe99bda1bc643a880dfdbf" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
symbol
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
orderId
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
origClientOrderId
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
recvWindow
|
||||
|
||||
LONG
|
||||
|
||||
NO
|
||||
|
||||
timestamp
|
||||
|
||||
LONG
|
||||
|
||||
YES
|
||||
|
||||
Notes:
|
||||
|
||||
> - Either `orderId` or `origClientOrderId` must be sent.
|
||||
> - `orderId` is self-increment for each specific `symbol`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
|
||||
```
|
||||
{ "id": "0ce5d070-a5e5-4ff2-b57f-1556741a4204", "status": 200, "result": { "orderId": 328999071, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "ArY8Ng1rln0s9x3fclmAHy", "price": "58000", "avgPrice": "0.00", "origQty": "1", "executedQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "selfTradePreventionMode": "EXPIRE_TAKER", "time": 1733740063619, "updateTime": 1733740063619, "priceMatch": "NONE" }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/websocket-api/Query-Order)
|
||||
+38
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: "Connect | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams"
|
||||
fetched_at: "2026-01-27T05:28:06.403Z"
|
||||
---
|
||||
# User Data Streams Connect
|
||||
|
||||
- The base API endpoint is: **[https://dapi.binance.com](https://dapi.binance.com/)**
|
||||
|
||||
- A User Data Stream `listenKey` is valid for 60 minutes after creation.
|
||||
|
||||
- Doing a `PUT` on a `listenKey` will extend its validity for 60 minutes, if response `-1125` error "This listenKey does not exist." Please use `POST /dapi/v1/listenKey` to recreate `listenKey`.
|
||||
|
||||
- Doing a `DELETE` on a `listenKey` will close the stream and invalidate the `listenKey`.
|
||||
|
||||
- Doing a `POST` on an account with an active `listenKey` will return the currently active `listenKey` and extend its validity for 60 minutes.
|
||||
|
||||
- There are two connection methods for Websocket：
|
||||
|
||||
- Base Url 1: **wss://dstream.binance.com**
|
||||
|
||||
- User Data Streams are accessed at **/ws/<listenKey>**
|
||||
|
||||
- Example: `wss://dstream.binance.com/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh`
|
||||
|
||||
- Base Url 2: **wss://dstream-auth.binance.com**
|
||||
|
||||
- User Data Streams are accessed at **/ws/<listenKey>?listenKey=<validateListenKey>**
|
||||
|
||||
- **<validateListenKey> must be a valid listenKey when you establish a connection**
|
||||
|
||||
- Example:
|
||||
|
||||
- `wss://dstream-auth.binance.com/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh？listenKey=XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh`
|
||||
|
||||
- For one connection(one user data), the user data stream payloads can guaranteed to be in order during heavy periods; **Strongly recommend you order your updates using E**
|
||||
|
||||
- A single connection is only valid for 24 hours; expect to be disconnected at the 24 hour mark
|
||||
+55
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "Close User Data Stream(Websocket API) | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp"
|
||||
fetched_at: "2026-01-27T05:28:06.577Z"
|
||||
---
|
||||
# Close User Data Stream (USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
Close out a user data stream.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
`userDataStream.stop`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "819e1b1b-8c06-485b-a13e-131326c69599", "method": "userDataStream.stop", "params": { "apiKey": "vmPUZE6mv9SD5VNHk9HlWFsOr9aLE2zvsw0MuIgwCIPy8atIco14y7Ju91duEh8A" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`apiKey`
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
Required if session is not authenticated via `session.logon`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "819e1b1b-8c06-485b-a13e-131326c69599", "status": 200, "result": {}, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 2 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream-Wsp)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Close User Data Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream"
|
||||
fetched_at: "2026-01-27T05:28:06.545Z"
|
||||
---
|
||||
# Close User Data Stream(USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
|
||||
Close out a user data stream.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
|
||||
DELETE `/dapi/v1/listenKey`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
|
||||
None
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
|
||||
```
|
||||
{}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Close-User-Data-Stream)
|
||||
+24
@@ -0,0 +1,24 @@
|
||||
---
|
||||
title: "Event Account Configuration Update | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update"
|
||||
fetched_at: "2026-01-27T05:28:06.648Z"
|
||||
---
|
||||
# Event: Account Configuration Update (Leverage Update)
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
|
||||
When the account configuration is changed, the event type will be pushed as `ACCOUNT_CONFIG_UPDATE` When the leverage of a trade pair changes, the payload will contain the object `ac` to represent the account configuration of the trade pair, where `s` represents the specific trade pair and `l` represents the leverage
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
|
||||
`ACCOUNT_CONFIG_UPDATE`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
|
||||
```
|
||||
{ "e":"ACCOUNT_CONFIG_UPDATE", // Event Type "E":1611646737479, // Event Time "T":1611646737476, // Transaction Time "ac":{ "s":"BTCUSD_PERP", // symbol "l":25 // leverage }}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Account-Configuration-Update)
|
||||
+47
@@ -0,0 +1,47 @@
|
||||
---
|
||||
title: "Event Balance And Position Update | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update"
|
||||
fetched_at: "2026-01-27T05:28:06.670Z"
|
||||
---
|
||||
# Event: Balance and Position Update
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
|
||||
Event type is `ACCOUNT_UPDATE`.
|
||||
|
||||
- When balance or position get updated, this event will be pushed.
|
||||
|
||||
- `ACCOUNT_UPDATE` will be pushed only when update happens on user's account, including changes on balances, positions, or margin type.
|
||||
- Unfilled orders or cancelled orders will not make the event `ACCOUNT_UPDATE` pushed, since there's no change on positions.
|
||||
- "position" in `ACCOUNT_UPDATE`: All symbols will be pushed.
|
||||
- The field "m" represents the reason type for the event and may shows the following possible types:
|
||||
|
||||
- DEPOSIT
|
||||
- WITHDRAW
|
||||
- ORDER
|
||||
- FUNDING\_FEE
|
||||
- ADJUSTMENT
|
||||
- INSURANCE\_CLEAR
|
||||
- ADMIN\_DEPOSIT
|
||||
- ADMIN\_WITHDRAW
|
||||
- MARGIN\_TRANSFER
|
||||
- MARGIN\_TYPE\_CHANGE
|
||||
- ASSET\_TRANSFER
|
||||
- COIN\_SWAP\_DEPOSIT
|
||||
- COIN\_SWAP\_WITHDRAW
|
||||
- The field "bc" represents the balance change except for PnL and commission.
|
||||
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
|
||||
`ACCOUNT_UPDATE`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
|
||||
```
|
||||
{ "e": "ACCOUNT_UPDATE", // Event Type "E": 1564745798939, // Event Time "T": 1564745798938 , // Transaction "i": "SfsR", // Account Alias "a": // Update Data { "m":"ORDER", // Event reason type "B":[ // Balances { "a":"BTC", // Asset "wb":"122624.12345678", // Wallet Balance "cw":"100.12345678", // Cross Wallet Balance "bc":"50.12345678" // Balance Change except PnL and Commission }, { "a":"ETH", "wb":"1.00000000", "cw":"0.00000000", "bc":"-49.12345678" } ], "P":[ { "s":"BTCUSD_200925", // Symbol "pa":"0", // Position Amount "ep":"0.0", // Entry Price "bep":"0.0", // Break-Even Price "cr":"200", // (Pre-fee) Accumulated Realized "up":"0", // Unrealized PnL "mt":"isolated", // Margin Type "iw":"0.00000000", // Isolated Wallet (if isolated position) "ps":"BOTH" // Position Side }, { "s":"BTCUSD_200925", "pa":"20", "ep":"6563.6", "bep":"6563.7", "cr":"0", "up":"2850.21200000", "mt":"isolated", "iw":"13200.70726908", "ps":"LONG" }, { "s":"BTCUSD_200925", "pa":"-10", "ep":"6563.8" "bep":"6563.6",, "cr":"-45.04000000", "up":"-1423.15600000", "mt":"isolated", "iw":"6570.42511771", "ps":"SHORT" } ] }}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Balance-and-Position-Update)
|
||||
+31
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: "Event Grid Update | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE"
|
||||
fetched_at: "2026-01-27T05:28:06.805Z"
|
||||
---
|
||||
# Event: GRID\_UPDATE
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
|
||||
`GRID_UPDATE` update when a sub order of a grid is filled or partially filled.
|
||||
|
||||
**Strategy Status**
|
||||
|
||||
- NEW
|
||||
- WORKING
|
||||
- CANCELLED
|
||||
- EXPIRED
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
|
||||
`GRID_UPDATE`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
|
||||
```
|
||||
{ "e": "GRID_UPDATE", // Event Type "T": 1669262908216, // Transaction Time "E": 1669262908218, // Event Time "gu": { "si": 176057039, // Strategy ID "st": "GRID", // Strategy Type "ss": "WORKING", // Strategy Status "s": "BTCUSDT", // Symbol "r": "-0.00300716", // Realized PNL "up": "16720", // Unmatched Average Price "uq": "-0.001", // Unmatched Qty "uf": "-0.00300716", // Unmatched Fee "mp": "0.0", // Matched PNL "ut": 1669262908197 // Update Time }}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-GRID-UPDATE)
|
||||
+26
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: "Event Margin Call | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call"
|
||||
fetched_at: "2026-01-27T05:28:06.838Z"
|
||||
---
|
||||
# Event: Margin Call
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
|
||||
- When the user's position risk ratio is too high, this stream will be pushed.
|
||||
- This message is only used as risk guidance information and is not recommended for investment strategies.
|
||||
- In the case of a highly volatile market, there may be the possibility that the user's position has been liquidated at the same time when this stream is pushed out.
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
|
||||
`MARGIN_CALL`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
|
||||
```
|
||||
{ "e":"MARGIN_CALL", // Event Type "E":1587727187525, // Event Time "i": "SfsR", // Account Alias "cw":"3.16812045", // Cross Wallet Balance. Only pushed with crossed position margin call "p":[ // Position(s) of Margin Call { "s":"BTCUSD_200925", // Symbol "ps":"LONG", // Position Side "pa":"132", // Position Amount "mt":"CROSSED", // Margin Type "iw":"0", // Isolated Wallet (if isolated position) "mp":"9187.17127000", // Mark Price "up":"-1.166074", // Unrealized PnL "mm":"1.614445" // Maintenance Margin Required } ]}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Margin-Call)
|
||||
+92
@@ -0,0 +1,92 @@
|
||||
---
|
||||
title: "Event Order Update | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update"
|
||||
fetched_at: "2026-01-27T05:28:06.914Z"
|
||||
---
|
||||
# Event: Order Update
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
|
||||
When new order created, modified, order status changed will push such event. event type is `ORDER_TRADE_UPDATE`.
|
||||
|
||||
**Side**
|
||||
|
||||
- BUY
|
||||
- SELL
|
||||
|
||||
**Position side:**
|
||||
|
||||
- BOTH
|
||||
- LONG
|
||||
- SHORT
|
||||
|
||||
**Order Type**
|
||||
|
||||
- MARKET
|
||||
- LIMIT
|
||||
- STOP
|
||||
- TAKE\_PROFIT
|
||||
- LIQUIDATION
|
||||
|
||||
**Execution Type**
|
||||
|
||||
- NEW
|
||||
- CANCELED
|
||||
- CALCULATED - Liquidation Execution
|
||||
- EXPIRED
|
||||
- TRADE
|
||||
- AMENDMENT - Order Modified
|
||||
|
||||
**Order Status**
|
||||
|
||||
- NEW
|
||||
- PARTIALLY\_FILLED
|
||||
- FILLED
|
||||
- CANCELED
|
||||
- EXPIRED
|
||||
- EXPIRED\_IN\_MATCH
|
||||
|
||||
**Time in force**
|
||||
|
||||
- GTC
|
||||
- IOC
|
||||
- FOK
|
||||
- GTX
|
||||
|
||||
**Liquidation and ADL:**
|
||||
|
||||
- If user gets liquidated due to insufficient margin balance:
|
||||
|
||||
- `c` shows as "autoclose-XXX"，`X` shows as "NEW"
|
||||
- If user has enough margin balance but gets ADL:
|
||||
|
||||
- `c` shows as “adl\_autoclose”，`X` shows as “NEW”
|
||||
|
||||
**Expiry Reason**
|
||||
|
||||
- `0`: None, the default value
|
||||
- `1`: Order has expired to prevent users from inadvertently trading against themselves
|
||||
- `2`: IOC order could not be filled completely, remaining quantity is canceled
|
||||
- `3`: IOC order could not be filled completely to prevent users from inadvertently trading against themselves, remaining quantity is canceled
|
||||
- `4`: Order has been canceled, as it's knocked out by another higher priority RO (market) order or reversed positions would be opened
|
||||
- `5`: Order has expired when the account was liquidated
|
||||
- `6`: Order has expired as GTE condition unsatisfied
|
||||
- `7`: Order has been canceled as the symbol is delisted
|
||||
- `8`: The initial order has expired after the stop order is triggered
|
||||
- `9`: Market order could not be filled completely, remaining quantity is canceled
|
||||
- `10`: FOK order could not be filled completely, the order is canceled
|
||||
- `11`: Order has been canceled, as it's failed Post-only check.
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
|
||||
`ORDER_TRADE_UPDATE`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
|
||||
```
|
||||
{ "e":"ORDER_TRADE_UPDATE", // Event Type "E":1591274595442, // Event Time "T":1591274595442, // Transaction Time "i":"SfsR", // Account Alias "o":{ "s":"BTCUSD_200925", // Symbol "c":"TEST", // Client Order Id // special client order id: // starts with "autoclose-": liquidation order // "adl_autoclose": ADL auto close order // "delivery_autoclose-": settlement order for delisting or delivery "S":"SELL", // Side "o":"TRAILING_STOP_MARKET", // Order Type "f":"GTC", // Time in Force "q":"2", // Original Quantity "p":"0", // Original Price "ap":"0", // Average Price "sp":"9103.1", // Stop Price. Please ignore with TRAILING_STOP_MARKET order "x":"NEW", // Execution Type "X":"NEW", // Order Status "i":8888888, // Order Id "l":"0", // Order Last Filled Quantity "z":"0", // Order Filled Accumulated Quantity "L":"0", // Last Filled Price "ma": "BTC", // Margin Asset "N":"BTC", // Commission Asset of the trade, will not push if no commission "n":"0", // Commission of the trade, will not push if no commission "T":1591274595442, // Order Trade Time "t":0, // Trade Id "rp": "0", // Realized Profit of the trade "b":"0", // Bid quantity of base asset "a":"0", // Ask quantity of base asset "m":false, // Is this trade the maker side? "R":false, // Is this reduce only "wt":"CONTRACT_PRICE", // Stop Price Working Type "ot":"TRAILING_STOP_MARKET",// Original Order Type "ps":"LONG", // Position Side "cp":false, // If Close-All, pushed with conditional order "AP":"9476.8", // Activation Price, only puhed with TRAILING_STOP_MARKET order "cr":"5.0", // Callback Rate, only puhed with TRAILING_STOP_MARKET order "pP": false, // If conditional order trigger is protected "V":"EXPIRE_TAKER", // STP mode "pm":"OPPONENT", // Price match mode "er":"0" // Expiry Reason }}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update)
|
||||
+49
@@ -0,0 +1,49 @@
|
||||
---
|
||||
title: "Event Strategy Update | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE"
|
||||
fetched_at: "2026-01-27T05:28:06.931Z"
|
||||
---
|
||||
# Event: STRATEGY\_UPDATE
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
|
||||
`STRATEGY_UPDATE` update when a strategy is created/cancelled/expired, ...etc.
|
||||
|
||||
**Strategy Status**
|
||||
|
||||
- NEW
|
||||
- WORKING
|
||||
- CANCELLED
|
||||
- EXPIRED
|
||||
|
||||
**opCode**
|
||||
|
||||
- 8001: The strategy params have been updated
|
||||
- 8002: User cancelled the strategy
|
||||
- 8003: User manually placed or cancelled an order
|
||||
- 8004: The stop limit of this order reached
|
||||
- 8005: User position liquidated
|
||||
- 8006: Max open order limit reached
|
||||
- 8007: New grid order
|
||||
- 8008: Margin not enough
|
||||
- 8009: Price out of bounds
|
||||
- 8010: Market is closed or paused
|
||||
- 8011: Close position failed, unable to fill
|
||||
- 8012: Exceeded the maximum allowable notional value at current leverage
|
||||
- 8013: Grid expired due to incomplete KYC verification or access from a restricted jurisdiction
|
||||
- 8014: User can only place reduce only order
|
||||
- 8015: User position empty or liquidated
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
|
||||
`STRATEGY_UPDATE`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
|
||||
```
|
||||
{ "e": "STRATEGY_UPDATE", // Event Type "T": 1669261797627, // Transaction Time "E": 1669261797628, // Event Time "su": { "si": 176054594, // Strategy ID "st": "GRID", // Strategy Type "ss": "NEW", // Strategy Status "s": "BTCUSDT", // Symbol "ut": 1669261797627, // Update Time "c": 8007 // opCode }}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-STRATEGY-UPDATE)
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: "Event User Data Stream Expired | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired"
|
||||
fetched_at: "2026-01-27T05:28:07.191Z"
|
||||
---
|
||||
# Event: User Data Stream Expired
|
||||
|
||||
## Event Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
|
||||
When the `listenKey` used for the user data stream turns expired, this event will be pushed.
|
||||
|
||||
**Notice:**
|
||||
|
||||
> - This event is not related to the websocket disconnection.
|
||||
> - This event will be received only when a valid `listenKey` in connection got expired.
|
||||
> - No more user data event will be updated after this event received until a new valid `listenKey` used.
|
||||
|
||||
## Event Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
|
||||
`listenKeyExpired`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
|
||||
```
|
||||
{ 'e': 'listenKeyExpired', // event type 'E': 1576653824250 // event time "listenKey":"WsCMN0a4KHUPTQuX6IUnqEZfB1inxmv1qR4kbf1LuEjur5VdbzqvyxqG9TSjVVxv"}
|
||||
```
|
||||
|
||||
- [Event Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
- [Event Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-User-Data-Stream-Expired)
|
||||
+55
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "Keepalive User Data Stream(Websocket API) | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp"
|
||||
fetched_at: "2026-01-27T05:28:07.307Z"
|
||||
---
|
||||
# Keepalive User Data Stream (USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
Keepalive a user data stream to prevent a time out. User data streams will close after 60 minutes. It's recommended to send a ping about every 60 minutes.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
`userDataStream.ping`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "815d5fce-0880-4287-a567-80badf004c74", "method": "userDataStream.ping", "params": { "apiKey": "vmPUZE6mv9SD5VNHk9HlWFsOr9aLE2zvsw0MuIgwCIPy8atIco14y7Ju91duEh8A" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`apiKey`
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
Required if session is not authenticated via `session.logon`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "815d5fce-0880-4287-a567-80badf004c74", "status": 200, "result": { "listenKey": "3HBntNTepshgEdjIwSUIBgB9keLyOCg5qv3n6bYAtktG8ejcaW5HXz9Vx1JgIieg" }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 2 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream-Wsp)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Keepalive User Data Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream"
|
||||
fetched_at: "2026-01-27T05:28:07.092Z"
|
||||
---
|
||||
# Keepalive User Data Stream (USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
|
||||
Keepalive a user data stream to prevent a time out. User data streams will close after 60 minutes.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
|
||||
PUT `/dapi/v1/listenKey`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
|
||||
None
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
|
||||
```
|
||||
{ "listenKey": "vmNt6gl1so8bXVsaAY153FG5tf63QaODxUarKUM8V8rY4ElSwEe431DNIYNKOkQp"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream)
|
||||
+55
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "Start User Data Stream(Websocket API) | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp"
|
||||
fetched_at: "2026-01-27T05:28:07.410Z"
|
||||
---
|
||||
# Start User Data Stream (USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
Start a new user data stream. The stream will close after 60 minutes unless a keepalive is sent. If the account has an active `listenKey`, that `listenKey` will be returned and its validity will be extended for 60 minutes.
|
||||
|
||||
## Method[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
`userDataStream.start`
|
||||
|
||||
## Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0", "method": "userDataStream.start", "params": { "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" }}
|
||||
```
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`apiKey`
|
||||
|
||||
STRING
|
||||
|
||||
NO
|
||||
|
||||
Required if session is not authenticated via session.logon
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
|
||||
```
|
||||
{ "id": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0", "status": 200, "result": { "listenKey": "xs0mRXdAKlIPDRFrlPcw0qI41Eh3ixNntmymGyhrhgqo7L6FuLaWArTD7RLP" }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 8 } ]}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
- [Method](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
- [Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream-Wsp)
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: "Start User Data Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream"
|
||||
fetched_at: "2026-01-27T05:28:07.324Z"
|
||||
---
|
||||
# Start User Data Stream (USER\_STREAM)
|
||||
|
||||
## API Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
|
||||
Start a new user data stream. The stream will close after 60 minutes unless a keepalive is sent. If the account has an active `listenKey`, that `listenKey` will be returned and its validity will be extended for 60 minutes.
|
||||
|
||||
## HTTP Request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
|
||||
POST `/dapi/v1/listenKey`
|
||||
|
||||
## Request Weight[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
|
||||
**1**
|
||||
|
||||
## Request Parameters[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
|
||||
None
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
|
||||
```
|
||||
{ "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"}
|
||||
```
|
||||
|
||||
- [API Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
- [HTTP Request](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
- [Request Weight](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
- [Request Parameters](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream)
|
||||
+338
@@ -0,0 +1,338 @@
|
||||
---
|
||||
title: "Websocket API General Info | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info"
|
||||
fetched_at: "2026-01-27T05:28:07.643Z"
|
||||
---
|
||||
# WebSocket API General Info
|
||||
|
||||
- The base endpoint is: **`wss://ws-dapi.binance.com/ws-dapi/v1`**
|
||||
- The base endpoint for testnet is: `wss://testnet.binancefuture.com/ws-dapi/v1`
|
||||
- A single connection to the API is only valid for 24 hours; expect to be disconnected after the 24-hour mark.
|
||||
- Websocket server will send a ping frame every 3 minutes.
|
||||
- If the websocket server does not receive a `pong frame` back from the connection within a 10 minute period, the connection will be disconnected.
|
||||
- When you receive a ping, you must send a pong with a copy of ping's payload as soon as possible.
|
||||
- Unsolicited pong frames are allowed, but will not prevent disconnection. **It is recommended that the payload for these pong frames are empty.**
|
||||
- **Signature payload must be generated by taking all request params except for the signature and sorting them by name in alphabetical order.**
|
||||
- Lists are returned in **chronological order**, unless noted otherwise.
|
||||
- All timestamps are in **milliseconds in UTC**, unless noted otherwise.
|
||||
- All field names and values are **case-sensitive**, unless noted otherwise.
|
||||
- **`INT` parameters such as timestamp are expected as JSON integers, not strings.**
|
||||
- **`DECIMAL` parameters such as price are expected as JSON strings, not floats.**
|
||||
- **User Data Stream requests - you will need to establish a separate WebSocket connection to listen to [user data streams](https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams)**
|
||||
|
||||
## WebSocket API Request format[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Requests must be sent as JSON in **text frames**, one request per frame.
|
||||
|
||||
> Example of request:
|
||||
|
||||
```
|
||||
{ "id": "60fa4366-f96e-42fe-a82b-f819952c6db4", "method": "order.place", "params": { "apiKey": "", "price": "50000", "quantity": 1, "side": "BUY", "symbol": "BTCUSD_PERP", "timeInForce": "GTC", "timestamp": 1728413737111, "type": "LIMIT", "signature": "996962a19802b5a09d7bc6ab1524227894533322a2f8a1f8934991689cabf8fe", }}
|
||||
```
|
||||
|
||||
Request fields:
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`id`
|
||||
|
||||
INT/STRING/null
|
||||
|
||||
YES
|
||||
|
||||
Arbitrary ID used to match responses to requests
|
||||
|
||||
`method`
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
Request method name
|
||||
|
||||
`params`
|
||||
|
||||
OBJECT
|
||||
|
||||
NO
|
||||
|
||||
Request parameters. May be omitted if there are no parameters
|
||||
|
||||
|
||||
|
||||
- Request `id` is truly arbitrary. You can use UUIDs, sequential IDs, current timestamp, etc. The server does not interpret `id` in any way, simply echoing it back in the response.
|
||||
|
||||
You can freely reuse IDs within a session. However, be careful to not send more than one request at a time with the same ID, since otherwise it might be impossible to tell the responses apart.
|
||||
|
||||
- Request method names may be prefixed with explicit version: e.g., "`v3/order.place`".
|
||||
- The order of `params` is not significant.
|
||||
|
||||
## Response format[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Responses are returned as JSON in text frames, one response per frame.
|
||||
|
||||
> Example of successful response:
|
||||
|
||||
```
|
||||
{ "id": "60fa4366-f96e-42fe-a82b-f819952c6db4", "status": 200, "result": { "orderId": 333245211, "symbol": "BTCUSD_PERP", "pair": "BTCUSD", "status": "NEW", "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA", "price": "50000", "avgPrice": "0.00", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "updateTime": 1728413795125 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "count": 1 } ]}
|
||||
```
|
||||
|
||||
> Example of failed response:
|
||||
|
||||
```
|
||||
{ "id": "9ca10e58-7452-467e-9454-f669bb9c764e", "status": 400, "error": { "code": -1102, "msg": "Mandatory parameter 'quantity' was not sent, was empty/null, or malformed." }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 1 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "count": 1 } ]}
|
||||
```
|
||||
|
||||
Response fields:
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`id`
|
||||
|
||||
INT/STRING/null
|
||||
|
||||
YES
|
||||
|
||||
Same as in the original request
|
||||
|
||||
`status`
|
||||
|
||||
INT
|
||||
|
||||
YES
|
||||
|
||||
Response status. See status codes
|
||||
|
||||
`result`
|
||||
|
||||
OBJECT/ARRAY
|
||||
|
||||
YES
|
||||
|
||||
Response content. Present if request succeeded
|
||||
|
||||
`error`
|
||||
|
||||
OBJECT
|
||||
|
||||
YES
|
||||
|
||||
Error description. Present if request failed
|
||||
|
||||
`rateLimits`
|
||||
|
||||
ARRAY
|
||||
|
||||
NO
|
||||
|
||||
Rate limiting status. See Rate limits
|
||||
|
||||
## WebSocket API Rate limits[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
- Rate limits are the same as on REST API and are shared with REST API.
|
||||
- WebSocket handshake attempt costs 5 weight.
|
||||
- Rate limit for ping/pong frames: maximum 5 per second.
|
||||
- Rate limit information is included in responses by default, see the `rateLimits` field.
|
||||
- `rateLimits` field visibility can be controlled with `returnRateLimits` boolean parameter in connection string or individual requests.
|
||||
- E.g., use `wss://ws-dapi.binance.com/ws-dapi/v1?returnRateLimits=false` to hide `rateLimits` in responses by default. With that, you can pass extra `"returnRateLimits": true` parameter in requests to show rate limit in response when it is otherwise hidden by default.
|
||||
|
||||
## WebSocket API Authenticate after connection[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
You can authenticate an already established connection using session authentication requests:
|
||||
|
||||
- `session.logon` - authenticate, or change the API key associated with the connection
|
||||
- `session.status` - check connection status and the current API key
|
||||
- `session.logout` - forget the API key associated with the connection
|
||||
|
||||
## WebSocket API API key revocation[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
If during an active session the API key becomes invalid for any reason (e.g. IP address is not whitelisted, API key was deleted, API key doesn't have correct permissions, etc), after the next request the session will be revoked with the following error message:
|
||||
|
||||
```
|
||||
{ "id": null, "status": 401, "error": { "code": -2015, "msg": "Invalid API-key, IP, or permissions for action." }}
|
||||
```
|
||||
|
||||
## WebSocket API Authorize ad hoc requests[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Only one API key can be authenticated with the WebSocket connection. The authenticated API key is used by default for requests that require an apiKey parameter. However, you can always specify the apiKey and signature explicitly for individual requests, overriding the authenticated API key and using a different one to authorize a specific request.
|
||||
|
||||
For example, you might want to authenticate your USER\_DATA key to be used by default, but specify the TRADE key with an explicit signature when placing orders.
|
||||
|
||||
## WebSocket API Authentication request[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Authenticate WebSocket connection using the provided API key.
|
||||
|
||||
After calling `session.logon`, you can omit `apiKey` and `signature` parameters for future requests that require them.
|
||||
|
||||
Note that only one API key can be authenticated. Calling `session.logon` multiple times changes the current authenticated API key.
|
||||
|
||||
**Weight:** 2
|
||||
|
||||
**Method**: "session.logon"
|
||||
|
||||
**Parameters**
|
||||
|
||||
Name
|
||||
|
||||
Type
|
||||
|
||||
Mandatory
|
||||
|
||||
Description
|
||||
|
||||
`apiKey`
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
`recvWindow`
|
||||
|
||||
INT
|
||||
|
||||
NO
|
||||
|
||||
`signature`
|
||||
|
||||
STRING
|
||||
|
||||
YES
|
||||
|
||||
`timestamp`
|
||||
|
||||
INT
|
||||
|
||||
YES
|
||||
|
||||
**Note**:
|
||||
|
||||
> Only _Ed25519_ keys are supported for this feature.
|
||||
|
||||
### Log in with API key (SIGNED)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
> **Request**
|
||||
|
||||
```
|
||||
{ "id": "c174a2b1-3f51-4580-b200-8528bd237cb7", "method": "session.logon", "params": { "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A", "signature": "1cf54395b336b0a9727ef27d5d98987962bc47aca6e13fe978612d0adee066ed", "timestamp": 1649729878532 }}
|
||||
```
|
||||
|
||||
> **Response**
|
||||
|
||||
```
|
||||
{ "id": "c174a2b1-3f51-4580-b200-8528bd237cb7", "status": 200, "result": { "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A", "authorizedSince": 1649729878532, "connectedSince": 1649729873021, "returnRateLimits": true, "serverTime": 1649729878630 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 2 } ]}
|
||||
```
|
||||
|
||||
### Query session status[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Query the status of the WebSocket connection, inspecting which API key (if any) is used to authorize requests.
|
||||
|
||||
**Weight:** 2
|
||||
|
||||
**Method**: "session.status"
|
||||
|
||||
**Parameters**: None
|
||||
|
||||
> **Request**
|
||||
|
||||
```
|
||||
{ "id": "b50c16cd-62c9-4e29-89e4-37f10111f5bf", "method": "session.status"}
|
||||
```
|
||||
|
||||
> **Response**
|
||||
|
||||
```
|
||||
{ "id": "b50c16cd-62c9-4e29-89e4-37f10111f5bf", "status": 200, "result": { // if the connection is not authenticated, "apiKey" and "authorizedSince" will be shown as null "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A", "authorizedSince": 1649729878532, "connectedSince": 1649729873021, "returnRateLimits": true, "serverTime": 1649730611671 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 4 } ]}
|
||||
```
|
||||
|
||||
### Log out of the session[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Forget the API key previously authenticated. If the connection is not authenticated, this request does nothing.
|
||||
|
||||
Note that the WebSocket connection stays open after `session.logout` request. You can continue using the connection, but now you will have to explicitly provide the `apiKey` and `signature` parameters where needed.
|
||||
|
||||
**Weight:** 2
|
||||
|
||||
**Method**: "session.logout"
|
||||
|
||||
**Parameters**: None
|
||||
|
||||
## SIGNED (TRADE and USER\_DATA) Endpoint Security[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
### SIGNED request example (Ed25519)[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
|
||||
Parameter
|
||||
|
||||
Value
|
||||
|
||||
symbol
|
||||
|
||||
BTCUSD\_PERP
|
||||
|
||||
side
|
||||
|
||||
SELL
|
||||
|
||||
type
|
||||
|
||||
LIMIT
|
||||
|
||||
timeInForce
|
||||
|
||||
GTC
|
||||
|
||||
quantity
|
||||
|
||||
1
|
||||
|
||||
price
|
||||
|
||||
0.2
|
||||
|
||||
timestamp
|
||||
|
||||
1668481559918
|
||||
|
||||
> **Request**
|
||||
|
||||
```
|
||||
{ "id": "c174a2b1-3f51-4580-b200-8528bd237cb7", "method": "session.logout"}
|
||||
```
|
||||
|
||||
> **Response**
|
||||
|
||||
```
|
||||
{ "id": "c174a2b1-3f51-4580-b200-8528bd237cb7", "status": 200, "result": { "apiKey": null, "authorizedSince": null, "connectedSince": 1649729873021, "returnRateLimits": false, "serverTime": 1649730611671 }, "rateLimits": [ { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400, "count": 6 } ]}
|
||||
```
|
||||
|
||||
A sample code in Python to show how to sign the payload with an Ed25519 key is available below.
|
||||
|
||||
```
|
||||
#!/usr/bin/env python3import base64import timeimport jsonfrom cryptography.hazmat.primitives.serialization import load_pem_private_keyfrom websocket import create_connection# Set up authenticationAPI_KEY='put your own API Key here'PRIVATE_KEY_PATH='test-prv-key.pem'# Load the private key.# In this example the key is expected to be stored without encryption,# but we recommend using a strong password for improved security.with open(PRIVATE_KEY_PATH, 'rb') as f: private_key = load_pem_private_key(data=f.read(), password=None)# Set up the request parametersparams = { 'apiKey': API_KEY, 'symbol': 'BTCUSD_PERP', 'side': 'SELL', 'type': 'LIMIT', 'timeInForce': 'GTC', 'quantity': '1.0000000', 'price': '0.20'}# Timestamp the requesttimestamp = int(time.time() * 1000) # UNIX timestamp in millisecondsparams['timestamp'] = timestamp# Sign the requestpayload = '&'.join([f'{param}={value}' for param, value in sorted(params.items())])signature = base64.b64encode(private_key.sign(payload.encode('ASCII')))params['signature'] = signature.decode('ASCII')# Send the requestrequest = { 'id': 'my_new_order', 'method': 'order.place', 'params': params}ws = create_connection("wss://ws-dapi.binance.com/ws-dapi/v1")ws.send(json.dumps(request))result = ws.recv()ws.close()print(result)
|
||||
```
|
||||
|
||||
A sample code in Python to show how to sign the payload with an Ed25519 key is available on the right side.
|
||||
|
||||
- [WebSocket API Request format](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [Response format](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [WebSocket API Rate limits](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [WebSocket API Authenticate after connection](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [WebSocket API API key revocation](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [WebSocket API Authorize ad hoc requests](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [WebSocket API Authentication request](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [Log in with API key (SIGNED)](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [Query session status](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [Log out of the session](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [SIGNED (TRADE and USER\_DATA) Endpoint Security](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
- [SIGNED request example (Ed25519)](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-api-general-info)
|
||||
+31
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: "Connect | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams"
|
||||
fetched_at: "2026-01-27T05:28:07.568Z"
|
||||
---
|
||||
# Websocket Market Streams
|
||||
|
||||
- There are two connection methods for Websocket：
|
||||
|
||||
- Base Url: **wss://dstream.binance.com**
|
||||
- Streams can be access either in a single raw stream or a combined stream
|
||||
- Raw streams are accessed at **/ws/<streamName>**
|
||||
- Combined streams are accessed at **/stream?streams=<streamName1>/<streamName2>/<streamName3>**
|
||||
- Example:
|
||||
- `wss://dstream.binance.com/ws/bnbusdt@aggTrade`
|
||||
- `wss://dstream.binance.com/stream?streams=bnbusdt@aggTrade/btcusdt@markPrice`
|
||||
- Combined stream events are wrapped as follows: **{"stream":"<streamName>","data":<rawPayload>}**
|
||||
|
||||
- All symbols for streams are **lowercase**
|
||||
|
||||
- A single connection is only valid for 24 hours; expect to be disconnected at the 24 hour mark
|
||||
|
||||
- The websocket server will send a `ping frame` every 3 minutes. If the websocket server does not receive a `pong frame` back from the connection within a 10 minute period, the connection will be disconnected. Unsolicited `pong frames` are allowed(Client can send `pong frames` with frequency higher than 10 minutes).
|
||||
|
||||
- WebSocket connections have a limit of 10 incoming messages per second.
|
||||
|
||||
- A connection that goes beyond the limit will be disconnected; IPs that are repeatedly disconnected may be banned.
|
||||
|
||||
- A single connection can listen to a maximum of **1024** streams.
|
||||
|
||||
- Considering the possible data latency from RESTful endpoints during an extremely volatile market, it is highly recommended to get the order status, position, etc from the Websocket user data stream.
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "Aggregate Trade Streams | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams"
|
||||
fetched_at: "2026-01-27T05:28:07.577Z"
|
||||
---
|
||||
# Aggregate Trade Streams
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
|
||||
The Aggregate Trade Streams push market trade information that is aggregated for fills with same price and taking side every 100 milliseconds.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
|
||||
`<symbol>@aggTrade`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
|
||||
**100ms**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
|
||||
```
|
||||
{ "e":"aggTrade", // Event type "E":1591261134288, // Event time "a":424951, // Aggregate trade ID "s":"BTCUSD_200626", // Symbol "p":"9643.5", // Price "q":"2", // Quantity "f":606073, // First trade ID "l":606073, // Last trade ID "T":1591261134199, // Trade time "m":false // Is the buyer the market maker?}
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Aggregate-Trade-Streams)
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "All Book Tickers Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream"
|
||||
fetched_at: "2026-01-27T05:28:07.841Z"
|
||||
---
|
||||
# All Book Tickers Stream
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
|
||||
Pushes any update to the best bid or ask's price or quantity in real-time for all symbols.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
|
||||
`!bookTicker`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
|
||||
`Real-time`
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
|
||||
```
|
||||
{ "e":"bookTicker", // Event type "u":17242169, // Order book update Id "s":"BTCUSD_200626", // Symbol "ps":"BTCUSD", // Pair "b":"9548.1", // Best bid price "B":"52", // Best bid qty "a":"9548.5", // Best ask price "A":"11", // Best ask qty "T":1591268628155, // Transaction time "E":1591268628166 // Event time}
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream)
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "All Market Liquidation Order Streams | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams"
|
||||
fetched_at: "2026-01-27T05:28:07.844Z"
|
||||
---
|
||||
# All Market Liquidation Order Streams
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
|
||||
The All Liquidation Order Snapshot Streams push force liquidation order information for all symbols in the market. For each symbol，only the latest one liquidation order within 1000ms will be pushed as the snapshot. If no liquidation happens in the interval of 1000ms, no stream will be pushed.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
|
||||
`!forceOrder@arr`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
|
||||
**1000ms**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
|
||||
```
|
||||
{ "e":"forceOrder", // Event Type "E": 1591154240950, // Event Time "o":{ "s":"BTCUSD_200925", // Symbol "ps": "BTCUSD", // Pair "S":"SELL", // Side "o":"LIMIT", // Order Type "f":"IOC", // Time in Force "q":"1", // Original Quantity "p":"9425.5", // Price "ap":"9496.5", // Average Price "X":"FILLED", // Order Status "l":"1", // Order Last Filled Quantity "z":"1", // Order Filled Accumulated Quantity "T": 1591154240949, // Order Trade Time }}
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams)
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "All Market Mini Tickers Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream"
|
||||
fetched_at: "2026-01-27T05:28:07.845Z"
|
||||
---
|
||||
# All Market Mini Tickers Stream
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
|
||||
24hr rolling window mini-ticker statistics for all symbols. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before. Note that only tickers that have changed will be present in the array.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
|
||||
`!miniTicker@arr`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
|
||||
**1000ms**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
|
||||
```
|
||||
[ { "e":"24hrMiniTicker", // Event type "E":1591267704450, // Event time "s":"BTCUSD_200626", // Symbol "ps":"BTCUSD", // Pair "c":"9561.7", // Close price "o":"9580.9", // Open price "h":"10000.0", // High price "l":"7000.0", // Low price "v":"487476", // Total traded volume "q":"33264343847.22378500" // Total traded base asset volume }]
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Mini-Tickers-Stream)
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "All Market Tickers Streams | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams"
|
||||
fetched_at: "2026-01-27T05:28:07.963Z"
|
||||
---
|
||||
# All Market Tickers Streams
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
|
||||
24hr rolling window ticker statistics for all symbols. These are NOT the statistics of the UTC day, but a 24hr rolling window from requestTime to 24hrs before. Note that only tickers that have changed will be present in the array.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
|
||||
`!ticker@arr`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
|
||||
**1000ms**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
|
||||
```
|
||||
[ { "e":"24hrTicker", // Event type "E":1591268262453, // Event time "s":"BTCUSD_200626", // Symbol "ps":"BTCUSD", // Pair "p":"-43.4", // Price change "P":"-0.452", // Price change percent "w":"0.00147974", // Weighted average price "c":"9548.5", // Last price "Q":"2", // Last quantity "o":"9591.9", // Open price "h":"10000.0", // High price "l":"7000.0", // Low price "v":"487850", // Total traded volume "q":"32968676323.46222700", // Total traded base asset volume "O":1591181820000, // Statistics open time "C":1591268262442, // Statistics close time "F":512014, // First trade ID "L":615289, // Last trade Id "n":103272 // Total number of trades }]
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Tickers-Streams)
|
||||
+55
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "Continuous Contract Kline Candlestick Streams | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams"
|
||||
fetched_at: "2026-01-27T05:28:08.093Z"
|
||||
---
|
||||
# Continuous Contract Kline/Candlestick Streams
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
|
||||
Kline update every second
|
||||
|
||||
**Contract type:**
|
||||
|
||||
- perpetual
|
||||
- current\_quarter
|
||||
- next\_quarter
|
||||
|
||||
**Kline/Candlestick chart intervals:**
|
||||
|
||||
m -> minutes; h -> hours; d -> days; w -> weeks; M -> months
|
||||
|
||||
- 1m
|
||||
- 3m
|
||||
- 5m
|
||||
- 15m
|
||||
- 30m
|
||||
- 1h
|
||||
- 2h
|
||||
- 4h
|
||||
- 6h
|
||||
- 8h
|
||||
- 12h
|
||||
- 1d
|
||||
- 3d
|
||||
- 1w
|
||||
- 1M
|
||||
|
||||
**Stream Name:**
|
||||
`<pair>_<contractType>@continuousKline_<interval>`
|
||||
|
||||
e.g. "btcusd\_next\_quarter@continuousKline\_1m"
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
|
||||
**250ms**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
|
||||
```
|
||||
{ "e":"continuous_kline", // Event type "E":1591261542539, // Event time "ps":"BTCUSD", // Pair "ct":"NEXT_QUARTER" // Contract type "k":{ "t":1591261500000, // Kline start time "T":1591261559999, // Kline close time "i":"1m", // Interval "f":606400, // First update ID "L":606430, // Last update ID "o":"9638.9", // Open price "c":"9639.8", // Close price "h":"9639.8", // High price "l":"9638.6", // Low price "v":"156", // volume "n":31, // Number of trades "x":false, // Is this kline closed? "q":"1.61836886", // Base asset volume "V":"73", // Taker buy volume "Q":"0.75731156", // Taker buy base asset volume "B":"0" // Ignore }}
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Continuous-Contract-Kline-Candlestick-Streams)
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "Contract Info Stream | Binance Open Platform"
|
||||
source: "https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream"
|
||||
fetched_at: "2026-01-27T05:28:08.089Z"
|
||||
---
|
||||
# Contract Info Stream
|
||||
|
||||
## Stream Description[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
|
||||
ContractInfo stream pushes when contract info updates(listing/settlement/contract bracket update). `bks` field only shows up when bracket gets updated.
|
||||
|
||||
## Stream Name[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
|
||||
`!contractInfo`
|
||||
|
||||
## Update Speed[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
|
||||
**Real-time**
|
||||
|
||||
## Response Example[](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
|
||||
```
|
||||
{ "e":"contractInfo", // Event Type "E":1669647330375, // Event Time "s":"APTUSD_PERP", // Symbol "ps":"APTUSD", // Pair "ct":"PERPETUAL", // Contract type "dt":4133404800000, // Delivery date time "ot":1666594800000, // onboard date time "cs":"TRADING", // Contract status "bks":[ { "bs":1, // Notional bracket "bnf":0, // Floor notional of this bracket "bnc":5000, // Cap notional of this bracket "mmr":0.01, // Maintenance ratio for this bracket "cf":0, // Auxiliary number for quick calculation "mi":21, // Min leverage for this bracket "ma":50 // Max leverage for this bracket }, { "bs":2, "bnf":5000, "bnc":25000, "mmr":0.025, "cf":75, "mi":11, "ma":20 } ]}
|
||||
```
|
||||
|
||||
- [Stream Description](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
- [Stream Name](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
- [Update Speed](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
- [Response Example](https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Contract-Info-Stream)
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user