Trade

Endpoint

Cancel Order (TRADE)

Cancel an active order.

WSS

order.cancel

wss://ws-dapi.binance.com/ws-dapi/v1

Cancel Order (TRADE) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Cancel Order (TRADE) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Cancel Order (TRADE) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

order.cancel

Example: order.cancel

object · required

symbol

string · required

Example: BTCUSD_PERP

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

orderId

integer · int64

Example: 1

origClientOrderId

string

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Cancel Order (TRADE) › Responses

Successful Response

Cancel Order

id

string

positionId

Example: a8627ea5-8b9f-452f-90ae-4136f2b442e2

status

integer · int64

Enum：completed，processing

Example: 200

object

Indicates that combined is set to true.

orderId

integer · int64

Sub-order ID

Example: 333245211

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

status

string

Enum：completed，processing

Example: CANCELED

clientOrderId

string

Client order ID.

Example: 5SztZiGFAxgAqw4J9EN9fA

price

string

Latest token price.

Example: 51000

origQty

string

Original order quantity

Example: 1

executedQty

string

Executed quantity

Example: 0

cumQty

string

Cumulative filled quantity.

Example: 0

timeInForce

string

Time in force

Example: GTC

type

string

Order type.

Example: LIMIT

reduceOnly

boolean

Whether the order is reduce-only.

Example: false

closePosition

boolean

if Close-All

Example: false

side

string

Trading side

Example: BUY

positionSide

string

Position side

Example: BOTH

stopPrice

string

please ignore when order type is TRAILING_STOP_MARKET

Example: 0

workingType

string

Stop trigger price type.

Example: CONTRACT_PRICE

priceProtect

boolean

if conditional order trigger is protected

Example: false

origType

string

Original order type.

Example: LIMIT

updateTime

integer · int64

update time

Example: 1728416138285

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 6

WSSorder.cancel

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.cancel",
  "params": {
    "symbol": "BTCUSD_PERP",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.cancel",
  "params": {
    "symbol": "BTCUSD_PERP",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "a8627ea5-8b9f-452f-90ae-4136f2b442e2",
  "status": 200,
  "result": {
    "orderId": 333245211,
    "symbol": "BTCUSD_PERP",
    "pair": "BTCUSD",
    "status": "CANCELED",
    "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA",
    "price": "51000",
    "origQty": "1",
    "executedQty": "0",
    "cumQty": "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
    }
  ]
}

json

application/json

Modify Order (TRADE)

Order modify function, currently only LIMIT order modification is supported, modified orders will be reordered in the match queue

WSS

order.modify

wss://ws-dapi.binance.com/ws-dapi/v1

Modify Order (TRADE) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Modify Order (TRADE) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

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)

Modify Order (TRADE) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

order.modify

Example: order.modify

object · required

symbol

string · required

Example: BTCUSD_PERP

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

quantity

number · float · required

Order quantity, cannot be sent with closePosition=true

Example: 1.0

price

number · float · required

Example: 1.0

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

orderId

integer · int64

Example: 1

origClientOrderId

string

Example: 1

priceMatch

string · enum

only avaliable for LIMIT/STOP/TAKE_PROFIT order; Can't be passed together with price

Enum values:

OPPONENT

OPPONENT_5

OPPONENT_10

OPPONENT_20

QUEUE

QUEUE_5

QUEUE_10

QUEUE_20

Example: OPPONENT

modifyId

integer · int64

User-defined modification identifier, returned as-is in the response. Optional; not validated for uniqueness.

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Modify Order (TRADE) › Responses

Successful Response

Modify Order

id

string

positionId

Example: 88601d02-bd0d-430d-8733-2708a569ebda

status

integer · int64

Enum：completed，processing

Example: 200

object

Indicates that combined is set to true.

orderId

integer · int64

Sub-order ID

Example: 333245211

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

status

string

Enum：completed，processing

Example: NEW

clientOrderId

string

Client order ID.

Example: 5SztZiGFAxgAqw4J9EN9fA

modifyId

integer · int64

user-defined modification identifier, only returned if provided in the request

Example: 1

price

string

Latest token price.

Example: 51000

origQty

string

Original order quantity

Example: 1

executedQty

string

Executed quantity

Example: 0

cumQty

string

Cumulative filled quantity.

Example: 0

timeInForce

string

Time in force

Example: GTC

type

string

Order type.

Example: LIMIT

reduceOnly

boolean

Whether the order is reduce-only.

Example: false

closePosition

boolean

if Close-All

Example: false

side

string

Trading side

Example: BUY

positionSide

string

Position side

Example: BOTH

stopPrice

string

please ignore when order type is TRAILING_STOP_MARKET

Example: 0

workingType

string

Stop trigger price type.

Example: CONTRACT_PRICE

priceProtect

boolean

if conditional order trigger is protected

Example: false

origType

string

Original order type.

Example: LIMIT

updateTime

integer · int64

update time

Example: 1728415765493

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 6

WSSorder.modify

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.modify",
  "params": {
    "symbol": "BTCUSD_PERP",
    "side": "BUY",
    "quantity": "1.0",
    "price": "1.0",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.modify",
  "params": {
    "symbol": "BTCUSD_PERP",
    "side": "BUY",
    "quantity": "1.0",
    "price": "1.0",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "88601d02-bd0d-430d-8733-2708a569ebda",
  "status": 200,
  "result": {
    "orderId": 333245211,
    "symbol": "BTCUSD_PERP",
    "pair": "BTCUSD",
    "status": "NEW",
    "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA",
    "modifyId": 1,
    "price": "51000",
    "origQty": "1",
    "executedQty": "0",
    "cumQty": "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
    }
  ]
}

json

application/json

New Order (TRADE)

Send in a new order.

WSS

order.place

wss://ws-dapi.binance.com/ws-dapi/v1

New Order (TRADE) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

New Order (TRADE) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

New Order (TRADE) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

order.place

Example: order.place

object · required

symbol

string · required

Example: BTCUSD_PERP

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

After CM migration, stop-type values (STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET) are no longer accepted and will return -4120. Use the REST /dapi/v1/algoOrder endpoint instead.

Enum values:

LIMIT

MARKET

STOP

STOP_MARKET

TAKE_PROFIT

TAKE_PROFIT_MARKET

TRAILING_STOP_MARKET

Example: LIMIT

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

positionSide

string · enum

Default BOTH for One-way Mode; LONG or SHORT for Hedge Mode. It must be sent in Hedge Mode.

Enum values:

BOTH

LONG

SHORT

Example: BOTH

timeInForce

string · enum

Enum values:

GTC

IOC

FOK

GTX

Example: GTC

quantity

number · float

Quantity measured by contract number, Cannot be sent with closePosition=true

Example: 1.0

reduceOnly

string · enum

Cannot be sent in Hedge Mode; cannot be sent with closePosition=true (Close-All)"

Enum values:

true

false

Example: true

Default: false

price

number · float

Example: 1.0

newClientOrderId

string

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}$

Example: 1

stopPrice

number · float

Used with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders.

Example: 1.0

closePosition

string · enum

true, false；Close-All，used with STOP_MARKET or TAKE_PROFIT_MARKET.

Enum values:

true

false

Example: true

activationPrice

number · float

Used with TRAILING_STOP_MARKET orders, default as the latest price(supporting different workingType)

Example: 1.0

callbackRate

number · float

Used with TRAILING_STOP_MARKET orders, min 0.1, max 10 where 1 for 1%

Example: 5000.0

workingType

string · enum

stopPrice triggered by: "MARK_PRICE", "CONTRACT_PRICE". Default "CONTRACT_PRICE"

Enum values:

MARK_PRICE

CONTRACT_PRICE

Example: MARK_PRICE

Default: CONTRACT_PRICE

priceProtect

string · enum

Used with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders.'

Enum values:

true

false

Example: true

Default: false

newOrderRespType

string · enum

Enum values:

ACK

RESULT

Example: ACK

Default: ACK

priceMatch

string · enum

only available for LIMIT/STOP/TAKE_PROFIT order; Can't be passed together with price

Enum values:

OPPONENT

OPPONENT_5

OPPONENT_10

OPPONENT_20

QUEUE

QUEUE_5

QUEUE_10

QUEUE_20

Example: OPPONENT

selfTradePreventionMode

string · enum

NONE: No STP / EXPIRE_TAKER taker order when STP triggers/ EXPIRE_MAKER taker order when STP triggers/ EXPIRE_BOTH both orders when STP triggers

Enum values:

NONE

EXPIRE_TAKER

EXPIRE_BOTH

EXPIRE_MAKER

Example: NONE

Default: NONE

recvWindow

integer · int64 · max: 60000

Example: 5000

New Order (TRADE) › Responses

Successful Response

New Order

id

string

positionId

Example: 60fa4366-f96e-42fe-a82b-f819952c6db4

status

integer · int64

Enum：completed，processing

Example: 200

object

Indicates that combined is set to true.

orderId

integer · int64

Sub-order ID

Example: 333245211

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

status

string

Enum：completed，processing

Example: NEW

clientOrderId

string

Client order ID.

Example: 5SztZiGFAxgAqw4J9EN9fA

price

string

Latest token price.

Example: 50000

origQty

string

Original order quantity

Example: 1

executedQty

string

Executed quantity

Example: 0

cumQty

string

Cumulative filled quantity.

Example: 0

timeInForce

string

Time in force

Example: GTC

type

string

Order type.

Example: LIMIT

reduceOnly

boolean

Whether the order is reduce-only.

Example: false

closePosition

boolean

if Close-All

Example: false

side

string

Trading side

Example: BUY

positionSide

string

Position side

Example: BOTH

stopPrice

string

please ignore when order type is TRAILING_STOP_MARKET

Example: 0

workingType

string

Stop trigger price type.

Example: CONTRACT_PRICE

priceProtect

boolean

if conditional order trigger is protected

Example: false

origType

string

Original order type.

Example: LIMIT

updateTime

integer · int64

update time

Example: 1728413795125

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 6

WSSorder.place

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.place",
  "params": {
    "symbol": "BTCUSD_PERP",
    "side": "BUY",
    "type": "LIMIT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.place",
  "params": {
    "symbol": "BTCUSD_PERP",
    "side": "BUY",
    "type": "LIMIT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "60fa4366-f96e-42fe-a82b-f819952c6db4",
  "status": 200,
  "result": {
    "orderId": 333245211,
    "symbol": "BTCUSD_PERP",
    "pair": "BTCUSD",
    "status": "NEW",
    "clientOrderId": "5SztZiGFAxgAqw4J9EN9fA",
    "price": "50000",
    "origQty": "1",
    "executedQty": "0",
    "cumQty": "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
    }
  ]
}

json

application/json

Position Information (USER_DATA)

Get current position information.

WSS

account.position

wss://ws-dapi.binance.com/ws-dapi/v1

Position Information (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Position Information (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Position Information (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

account.position

Example: account.position

object · required

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

marginAsset

string

Example: USDT

pair

string

Example: BTCUSD

recvWindow

integer · int64 · max: 60000

Example: 5000

Position Information (USER_DATA) › Responses

Successful Response

Position Information

id

string

positionId

Example: 233b8741-a96d-48e8-8ce1-160f43548aeb

status

integer · int64

Enum：completed，processing

Example: 200

object[]

Indicates that combined is set to true.

symbol

string

Trading symbol

Example: BTCUSD_PERP

positionAmt

string

position amount

Example: 0

entryPrice

string

Position entry price.

Example: 0.00000000

markPrice

string

mark price

Example: 62297.60417296

unRealizedProfit

string

Unrealized profit.

Example: 0.00000000

liquidationPrice

string

Liquidation price.

Example: 0

leverage

string

Leverage value.

Example: 7

maxQty

string

maximum quantity of base asset

Example: 100

marginType

string

Margin type.

Example: cross

isolatedMargin

string

Isolated margin amount.

Example: 0.00000000

isAutoAddMargin

string

Whether auto-add margin is enabled.

Example: false

positionSide

string

Position side

Example: BOTH

notionalValue

string

Notional value.

Example: 0

isolatedWallet

string

Isolated wallet balance.

Example: 0

updateTime

integer · int64

update time

Example: 1726731195634

breakEvenPrice

string

break-even price

Example: 0.00000000

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 10

WSSaccount.position

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.position",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "account.position",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

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

json

application/json

Query Order (USER_DATA)

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

WSS

order.status

wss://ws-dapi.binance.com/ws-dapi/v1

Query Order (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Order (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Query Order (USER_DATA) › Request Parameters

id

string · required

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

order.status

Example: order.status

object · required

symbol

string · required

Example: BTCUSD_PERP

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

apiKey

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

orderId

integer · int64

Example: 1

origClientOrderId

string

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Order (USER_DATA) › Responses

Successful Response

Order

id

string

positionId

Example: 0ce5d070-a5e5-4ff2-b57f-1556741a4204

status

integer · int64

Enum：completed，processing

Example: 200

object

Indicates that combined is set to true.

orderId

integer · int64

Sub-order ID

Example: 328999071

symbol

string

Trading symbol

Example: BTCUSD_PERP

pair

string

Pair

Example: BTCUSD

status

string

Enum：completed，processing

Example: NEW

clientOrderId

string

Client order ID.

Example: ArY8Ng1rln0s9x3fclmAHy

price

string

Latest token price.

Example: 58000

avgPrice

string

Average execution price

Example: 0.00

origQty

string

Original order quantity

Example: 1

executedQty

string

Executed quantity

Example: 0

cumQty

string

Cumulative filled quantity.

Example: 0

cumBase

string

Cumulative base asset amount.

Example: 0

timeInForce

string

Time in force

Example: GTC

type

string

Order type.

Example: LIMIT

reduceOnly

boolean

Whether the order is reduce-only.

Example: false

closePosition

boolean

if Close-All

Example: false

side

string

Trading side

Example: BUY

positionSide

string

Position side

Example: LONG

stopPrice

string

please ignore when order type is TRAILING_STOP_MARKET

Example: 0

workingType

string

Stop trigger price type.

Example: CONTRACT_PRICE

priceProtect

boolean

if conditional order trigger is protected

Example: false

origType

string

Original order type.

Example: LIMIT

selfTradePreventionMode

string

self trading preventation mode

Example: EXPIRE_TAKER

time

integer · int64

Time

Example: 1733740063619

updateTime

integer · int64

update time

Example: 1733740063619

priceMatch

string

price match mode

Example: NONE

object[]

Rate limit definitions.

rateLimitType

string

Rate limit type.

Example: REQUEST_WEIGHT

interval

string

Rate limit interval.

Example: MINUTE

intervalNum

integer · int64

Rate limit interval multiplier.

Example: 1

limit

integer · int64

Maximum allowed orders for this rule.

Example: 2400

count

integer · int64

Total number of trades in the 24h window.

Example: 6

WSSorder.status

wscat -c wss://ws-dapi.binance.com/ws-dapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.status",
  "params": {
    "symbol": "BTCUSD_PERP",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "order.status",
  "params": {
    "symbol": "BTCUSD_PERP",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "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",
    "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",
    "selfTradePreventionMode": "EXPIRE_TAKER",
    "time": 1733740063619,
    "updateTime": 1733740063619,
    "priceMatch": "NONE"
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 6
    }
  ]
}

json

application/json