Account

Endpoint

Account Commission Rates (USER_DATA)

Get current account commission rates.

WSS

account.commission

wss://ws-api.binance.com:443/ws-api/v3

Account Commission Rates (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

Account Commission Rates (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 Weight20

Account Commission Rates (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.commission

Example: account.commission

object · required

symbol

string · required

Example: BNBUSDT

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

Account Commission Rates (USER_DATA) › Responses

Successful Response

Account Commission Rates

id

string

Example: d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0

status

integer · int64

Example: 200

object

symbol

string

Example: BTCUSDT

object

Standard commission rates on trades from the order.

maker

string

Example: 0.00000010

taker

string

Example: 0.00000020

buyer

string

Example: 0.00000030

seller

string

Example: 0.00000040

object

Special commission rates from the order.

maker

string

Example: 0.01000000

taker

string

Example: 0.02000000

buyer

string

Example: 0.03000000

seller

string

Example: 0.04000000

object

Tax commission rates on trades from the order.

maker

string

Example: 0.00000112

taker

string

Example: 0.00000114

buyer

string

Example: 0.00000118

seller

string

Example: 0.00000116

object

Discount on standard commissions when paying in BNB.

enabledForAccount

boolean

Example: true

enabledForSymbol

boolean

Example: true

discountAsset

string

Example: BNB

discount

string

Standard commission is reduced by this rate when paying commission in BNB.

Example: 0.75000000

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSaccount.commission

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.commission",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.commission",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0",
  "status": 200,
  "result": {
    "symbol": "BTCUSDT",
    "standardCommission": {
      "maker": "0.00000010",
      "taker": "0.00000020",
      "buyer": "0.00000030",
      "seller": "0.00000040"
    },
    "specialCommission": {
      "maker": "0.01000000",
      "taker": "0.02000000",
      "buyer": "0.03000000",
      "seller": "0.04000000"
    },
    "taxCommission": {
      "maker": 0.00000112,
      "taker": 0.00000114,
      "buyer": 0.00000118,
      "seller": 0.00000116
    },
    "discount": {
      "enabledForAccount": true,
      "enabledForSymbol": true,
      "discountAsset": "BNB",
      "discount": "0.75000000"
    }
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Unfilled Order Count (USER_DATA)

Query your current unfilled order count for all intervals.

WSS

account.rateLimits.orders

wss://ws-api.binance.com:443/ws-api/v3

Unfilled Order Count (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

Unfilled Order Count (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 Weight40

Unfilled Order Count (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.rateLimits.orders

Example: account.rateLimits.orders

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

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Unfilled Order Count (USER_DATA) › Responses

Successful Response

Unfilled Order Count

id

string

Example: d3783d8d-f8d1-4d2c-b8a0-b7596af5a664

status

integer · int64

Example: 200

object[]

rateLimitType

string

Example: ORDERS

interval

string

Example: SECOND

intervalNum

integer · int64

Example: 10

limit

integer · int64

Example: 50

count

integer · int64

Example: 0

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSaccount.rateLimits.orders

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.rateLimits.orders",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.rateLimits.orders",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "d3783d8d-f8d1-4d2c-b8a0-b7596af5a664",
  "status": 200,
  "result": [
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "intervalNum": 10,
      "limit": 50,
      "count": 0
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account information (USER_DATA)

Query information about your account.

WSS

account.status

wss://ws-api.binance.com:443/ws-api/v3

Account 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

Account 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 Weight20

Account information (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.status

Example: account.status

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

omitZeroBalances

boolean

When set to true, emits only the non-zero balances of an account. Default value: false.

Example: false

Default: false

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Account information (USER_DATA) › Responses

Successful Response

Account information

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

makerCommission

integer · int64

Example: 15

takerCommission

integer · int64

Example: 15

buyerCommission

integer · int64

Example: 0

sellerCommission

integer · int64

Example: 0

canTrade

boolean

Example: true

canWithdraw

boolean

Example: true

canDeposit

boolean

Example: true

object

maker

string

Example: 0.0015

taker

string

Example: 0.0015

buyer

string

Example: 0

seller

string

Example: 0

brokered

boolean

Example: false

requireSelfTradePrevention

boolean

Example: false

preventSor

boolean

Example: false

updateTime

integer · int64

Example: 1660801833000

accountType

string

Example: SPOT

object[]

asset

string

Example: BNB

free

string

Example: 0

locked

string

Example: 0

permissions

string[]

uid

integer · int64

Example: 354937868

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSaccount.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": {
    "makerCommission": 15,
    "takerCommission": 15,
    "buyerCommission": 0,
    "sellerCommission": 0,
    "canTrade": true,
    "canWithdraw": true,
    "canDeposit": true,
    "commissionRates": {
      "maker": 0.0015,
      "taker": 0.0015,
      "buyer": 0,
      "seller": 0
    },
    "brokered": false,
    "requireSelfTradePrevention": false,
    "preventSor": false,
    "updateTime": 1660801833000,
    "accountType": "SPOT",
    "balances": [
      {
        "asset": "BNB",
        "free": 0,
        "locked": 0
      }
    ],
    "permissions": [
      "SPOT"
    ],
    "uid": 354937868
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account order list history (USER_DATA)

Query information about all your order lists, filtered by time range.

WSS

allOrderLists

wss://ws-api.binance.com:443/ws-api/v3

Account order list history (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

Account order list history (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 Weight20

Account order list history (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

allOrderLists

Example: allOrderLists

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

fromId

integer

Order list ID to begin at

Example: 1

startTime

integer · int64

Timestamp in ms

Example: 1735693200000

endTime

integer · int64

Timestamp in ms

Example: 1735693200000

limit

integer · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Account order list history (USER_DATA) › Responses

Successful Response

Account order list history

id

string

Example: 8617b7b3-1b3d-4dec-94cd-eefd929b8ceb

status

integer · int64

Example: 200

object[]

orderListId

integer · int64

Example: 1274512

contingencyType

string

Example: OCO

listStatusType

string

Example: EXEC_STARTED

listOrderStatus

string

Example: EXECUTING

listClientOrderId

string

Example: 08985fedd9ea2cf6b28996

transactionTime

integer · int64

Example: 1660801713793

symbol

string

Example: BTCUSDT

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 12569138901

clientOrderId

string

Example: BqtFCj5odMoWtSqGk2X9tU

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSallOrderLists

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrderLists",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrderLists",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "8617b7b3-1b3d-4dec-94cd-eefd929b8ceb",
  "status": 200,
  "result": [
    {
      "orderListId": 1274512,
      "contingencyType": "OCO",
      "listStatusType": "EXEC_STARTED",
      "listOrderStatus": "EXECUTING",
      "listClientOrderId": "08985fedd9ea2cf6b28996",
      "transactionTime": 1660801713793,
      "symbol": "BTCUSDT",
      "orders": [
        {
          "symbol": "BTCUSDT",
          "orderId": 12569138901,
          "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
        }
      ]
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account order history (USER_DATA)

Query information about all your orders – active, canceled, filled – filtered by time range.

WSS

allOrders

wss://ws-api.binance.com:443/ws-api/v3

Account order history (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

Account order history (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 Weight20

Account order history (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

allOrders

Example: allOrders

object · required

symbol

string · required

Example: BNBUSDT

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

Order ID to begin at

Example: 1

startTime

integer · int64

Timestamp in ms

Example: 1735693200000

endTime

integer · int64

Timestamp in ms

Example: 1735693200000

limit

integer · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Account order history (USER_DATA) › Responses

Successful Response

Account order history

id

string

Example: 734235c2-13d2-4574-be68-723e818c08f3

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 12569099453

orderListId

integer · int64

Present only for orders that belong to an order list.

Example: -1

clientOrderId

string

Example: 4d96324ff9d44481926157

price

string

Example: 23416.1

origQty

string

Example: 0.00847

executedQty

string

Example: 0.00847

cummulativeQuoteQty

string

Example: 198.335215

status

string

Example: FILLED

timeInForce

string

Example: GTC

type

string

Example: LIMIT

side

string

Example: SELL

time

integer · int64

Order placement time.

Example: 1660801715639

updateTime

integer · int64

Time of the last update to the order.

Example: 1660801717945

isWorking

boolean

Example: true

workingTime

integer · int64

Example: 1660801715639

origQuoteOrderQty

string

Always present. Zero if the order type does not use quoteOrderQty.

Example: 0

selfTradePreventionMode

string

Example: NONE

preventedMatchId

integer · int64

Present only if the order expired due to STP.

Example: 0

preventedQuantity

string

Present only if the order expired due to STP.

Example: 1.2

icebergQty

string

Appears only if the parameter icebergQty was sent in the request.

Example: 0.00000000

stopPrice

string

Appears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.

Example: 0.00000000

strategyId

integer · int64

Appears only if the strategyId parameter was provided upon order placement.

Example: 1

strategyType

integer · int64

Appears only if the strategyType parameter was provided upon order placement.

Example: 1000000

trailingDelta

integer · int64

Delta price change required before order activation.

Example: 10

trailingTime

integer · int64

Time when the trailing order is now active and tracking price changes.

Example: -1

usedSor

boolean

Field that determines whether order used SOR.

Example: true

workingFloor

string

Determines whether the order is being filled by the SOR or by the order book.

Example: SOR

pegPriceType

string

Price peg type. Only for pegged orders.

Example: PRIMARY_PEG

pegOffsetType

string

Price peg offset type. Only for pegged orders, if requested.

Example: PRICE_LEVEL

pegOffsetValue

integer · int64

Price peg offset value. Only for pegged orders, if requested.

Example: 5

peggedPrice

string

Current price order is pegged at. Only for pegged orders, once determined.

Example: 87523.83710000

expiryReason

string

Cause of the order's expiration. Appears when an order has expired.

Example: INSUFFICIENT_LIQUIDITY

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSallOrders

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrders",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrders",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "734235c2-13d2-4574-be68-723e818c08f3",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 12569099453,
      "orderListId": -1,
      "clientOrderId": "4d96324ff9d44481926157",
      "price": 23416.1,
      "origQty": 0.00847,
      "executedQty": 0.00847,
      "cummulativeQuoteQty": 198.335215,
      "status": "FILLED",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "time": 1660801715639,
      "updateTime": 1660801717945,
      "isWorking": true,
      "workingTime": 1660801715639,
      "origQuoteOrderQty": 0,
      "selfTradePreventionMode": "NONE",
      "preventedMatchId": 0,
      "preventedQuantity": 1.2,
      "icebergQty": "0.00000000",
      "stopPrice": "0.00000000",
      "strategyId": 1,
      "strategyType": 1000000,
      "trailingDelta": 10,
      "trailingTime": -1,
      "usedSor": true,
      "workingFloor": "SOR",
      "pegPriceType": "PRIMARY_PEG",
      "pegOffsetType": "PRICE_LEVEL",
      "pegOffsetValue": 5,
      "peggedPrice": "87523.83710000",
      "expiryReason": "INSUFFICIENT_LIQUIDITY"
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account allocations (USER_DATA)

Retrieves allocations resulting from SOR order placement.

WSS

myAllocations

wss://ws-api.binance.com:443/ws-api/v3

Account allocations (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

Account allocations (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 Weight20

Account allocations (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myAllocations

Example: myAllocations

object · required

symbol

string · required

Example: BNBUSDT

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

startTime

integer · int64

Timestamp in ms

Example: 1735693200000

endTime

integer · int64

Timestamp in ms

Example: 1735693200000

fromAllocationId

integer

Allocation ID to begin at

Example: 1

limit

integer · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

orderId

integer · int64

Order ID

Example: 1

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Data Source: Database

Supported parameter combinations:

Parameters	Response
`symbol`	allocations from oldest to newest
`symbol` + `startTime`	oldest allocations since `startTime`
`symbol` + `endTime`	newest allocations until `endTime`
`symbol` + `startTime` + `endTime`	allocations within the time range
`symbol` + `fromAllocationId`	allocations by allocation ID
`symbol` + `orderId`	allocations related to an order starting with oldest
`symbol` + `orderId` + `fromAllocationId`	allocations related to an order by allocation ID

Note: The time between startTime and endTime can't be longer than 24 hours.

Account allocations (USER_DATA) › Responses

Successful Response

Account allocations

id

string

Example: g4ce6a53-a39d-4f71-823b-4ab5r391d6y8

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

allocationId

integer · int64

Example: 0

allocationType

string

Example: SOR

orderId

integer · int64

Example: 500

orderListId

integer · int64

Example: -1

price

string

Example: 1

qty

string

Example: 0.1

quoteQty

string

Example: 0.1

commission

string

Example: 0

commissionAsset

string

Example: BTC

time

integer · int64

Example: 1687319487614

isBuyer

boolean

Example: false

isMaker

boolean

Example: false

isAllocator

boolean

Example: false

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSmyAllocations

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myAllocations",
  "params": {
    "symbol": "BNBUSDT",
    "apiKey": "API_KEY",
    "timestamp": 1770736694138
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myAllocations",
  "params": {
    "symbol": "BNBUSDT",
    "apiKey": "API_KEY",
    "timestamp": 1770736694138
  }
}

json

application/json

Example Responses

{
  "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "allocationId": 0,
      "allocationType": "SOR",
      "orderId": 500,
      "orderListId": -1,
      "price": 1,
      "qty": 0.1,
      "quoteQty": 0.1,
      "commission": 0,
      "commissionAsset": "BTC",
      "time": 1687319487614,
      "isBuyer": false,
      "isMaker": false,
      "isAllocator": false
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Relevant Filters (USER_DATA)

Retrieves the list of filters relevant to an account on a given symbol. This is the only method that shows if an account has MAX_ASSET filters applied to it.

WSS

myFilters

wss://ws-api.binance.com:443/ws-api/v3

Query Relevant Filters (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 Relevant Filters (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 Weight40

Query Relevant Filters (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myFilters

Example: myFilters

object · required

symbol

string · required

Example: BNBUSDT

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

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Query Relevant Filters (USER_DATA) › Responses

Successful Response

Query Relevant Filters

id

string

Example: 1758009606869

status

integer · int64

Example: 200

object

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="EXCHANGE_MAX_NUM_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ALGO_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="EXCHANGE_MAX_NUM_ORDER_LISTS"

Properties for EXCHANGE_MAX_NUM_ORDERS:

filterType

string

Example: EXCHANGE_MAX_NUM_ORDERS

maxNumOrders

integer · int64

Example: 1000

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="PRICE_FILTER"
	type = object · filterType="PERCENT_PRICE"
	type = object · filterType="PERCENT_PRICE_BY_SIDE"
	type = object · filterType="LOT_SIZE"
	type = object · filterType="MIN_NOTIONAL"
	type = object · filterType="NOTIONAL"
	type = object · filterType="ICEBERG_PARTS"
	type = object · filterType="MARKET_LOT_SIZE"
	type = object · filterType="MAX_NUM_ORDERS"
	type = object · filterType="MAX_NUM_ALGO_ORDERS"
	type = object · filterType="MAX_NUM_ICEBERG_ORDERS"
	type = object · filterType="MAX_POSITION"
	type = object · filterType="TRAILING_DELTA"
	type = object · filterType="T_PLUS_SELL"
	type = object · filterType="MAX_NUM_ORDER_LISTS"
	type = object · filterType="MAX_NUM_ORDER_AMENDS"

Properties for PRICE_FILTER:

filterType

string

Example: PRICE_FILTER

priceExponent

integer

Example: 8

minPrice

string

Example: 0.00000100

maxPrice

string

Example: 100000.00000000

tickSize

string

Example: 0.00000100

array

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · filterType="MAX_ASSET"

Properties for MAX_ASSET:

filterType

string

Example: MAX_ASSET

qtyExponent

integer

Example: 8

limit

string

Example: 1000000.00000000

asset

string

Example: JPY

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSmyFilters

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myFilters",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myFilters",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": 1758009606869,
  "status": 200,
  "result": {
    "exchangeFilters": [
      {
        "filterType": "EXCHANGE_MAX_NUM_ORDERS",
        "maxNumOrders": 1000
      }
    ],
    "symbolFilters": [
      {
        "filterType": "PRICE_FILTER",
        "priceExponent": 8,
        "minPrice": "0.00000100",
        "maxPrice": "100000.00000000",
        "tickSize": "0.00000100"
      }
    ],
    "assetFilters": [
      {
        "filterType": "MAX_ASSET",
        "qtyExponent": 8,
        "limit": "1000000.00000000",
        "asset": "JPY"
      }
    ],
    "rateLimits": [
      {
        "rateLimitType": "REQUEST_WEIGHT",
        "interval": "MINUTE",
        "intervalNum": 1,
        "limit": 6000,
        "count": 321
      }
    ]
  }
}

json

application/json

Account prevented matches (USER_DATA)

Displays the list of orders that were expired due to STP.

These are the combinations supported:

symbol + preventedMatchId
symbol + orderId
symbol + orderId + fromPreventedMatchId (limit will default to 500)
symbol + orderId + fromPreventedMatchId + limit

WSS

myPreventedMatches

wss://ws-api.binance.com:443/ws-api/v3

Account prevented matches (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

Account prevented matches (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 Weight

Case	Weight
If `symbol` is invalid	2
Querying by `preventedMatchId`	2
Querying by `orderId`	20

Account prevented matches (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myPreventedMatches

Example: myPreventedMatches

object · required

symbol

string · required

Example: BNBUSDT

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

preventedMatchId

integer · int64

Prevented match ID

Example: 1

orderId

integer · int64

Order ID

Example: 1

fromPreventedMatchId

integer · int64

Prevented match ID to begin at

Example: 1

limit

integer · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Account prevented matches (USER_DATA) › Responses

Successful Response

Account prevented matches

id

string

Example: g4ce6a53-a39d-4f71-823b-4ab5r391d6y8

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

preventedMatchId

integer · int64

Example: 1

takerOrderId

integer · int64

Example: 5

makerSymbol

string

Example: BTCUSDT

makerOrderId

integer · int64

Example: 3

tradeGroupId

integer · int64

Example: 1

selfTradePreventionMode

string

Example: EXPIRE_MAKER

price

string

Example: 1.1

makerPreventedQuantity

string

Example: 1.3

transactTime

integer · int64

Example: 1669101687094

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSmyPreventedMatches

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myPreventedMatches",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myPreventedMatches",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "preventedMatchId": 1,
      "takerOrderId": 5,
      "makerSymbol": "BTCUSDT",
      "makerOrderId": 3,
      "tradeGroupId": 1,
      "selfTradePreventionMode": "EXPIRE_MAKER",
      "price": 1.1,
      "makerPreventedQuantity": 1.3,
      "transactTime": 1669101687094
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account trade history (USER_DATA)

Query information about all your trades, filtered by time range.

WSS

myTrades

wss://ws-api.binance.com:443/ws-api/v3

Account trade history (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

Account trade history (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 Weight

Condition	Weight
Without orderId	20
With orderId	5

Account trade history (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myTrades

Example: myTrades

object · required

symbol

string · required

Example: BNBUSDT

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

This can only be used in combination with symbol.

Example: 1

startTime

integer · int64

Timestamp in ms

Example: 1735693200000

endTime

integer · int64

Timestamp in ms

Example: 1735693200000

fromId

integer

First trade ID to query

Example: 1

limit

integer · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Account trade history (USER_DATA) › Responses

Successful Response

Account trade history

id

string

Example: f4ce6a53-a29d-4f70-823b-4ab59391d6e8

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

id

integer · int64

Example: 1650422481

orderId

integer · int64

Example: 12569099453

orderListId

integer · int64

Example: -1

price

string

Example: 23416.1

qty

string

Example: 0.00635

quoteQty

string

Example: 148.692235

commission

string

Example: 0

commissionAsset

string

Example: BNB

time

integer · int64

Example: 1660801715793

isBuyer

boolean

Example: false

isMaker

boolean

Example: true

isBestMatch

boolean

Example: true

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSmyTrades

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myTrades",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myTrades",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "f4ce6a53-a29d-4f70-823b-4ab59391d6e8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "id": 1650422481,
      "orderId": 12569099453,
      "orderListId": -1,
      "price": 23416.1,
      "qty": 0.00635,
      "quoteQty": 148.692235,
      "commission": 0,
      "commissionAsset": "BNB",
      "time": 1660801715793,
      "isBuyer": false,
      "isMaker": true,
      "isBestMatch": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Current open Order lists (USER_DATA)

Query execution status of all open order lists.

If you need to continuously monitor order status updates, please consider using WebSocket Streams:

userDataStream.subscribe if on an authenticated session
userDataStream.subscribe.signature if subscribing through signature subscription

WSS

openOrderLists.status

wss://ws-api.binance.com:443/ws-api/v3

Current open Order lists (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

Current open Order lists (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 Weight6

Current open Order lists (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

openOrderLists.status

Example: openOrderLists.status

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

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Current open Order lists (USER_DATA) › Responses

Successful Response

Current open Order lists

id

string

Example: 3a4437e2-41a3-4c19-897c-9cadc5dce8b6

status

integer · int64

Example: 200

object[]

orderListId

integer · int64

Example: 0

contingencyType

string

Example: OCO

listStatusType

string

Example: EXEC_STARTED

listOrderStatus

string

Example: EXECUTING

listClientOrderId

string

Example: 08985fedd9ea2cf6b28996

transactionTime

integer · int64

Example: 1660801713793

symbol

string

Example: BTCUSDT

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 4

clientOrderId

string

Example: CUhLgTXnX5n2c0gWiLpV4d

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSopenOrderLists.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrderLists.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrderLists.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "3a4437e2-41a3-4c19-897c-9cadc5dce8b6",
  "status": 200,
  "result": [
    {
      "orderListId": 0,
      "contingencyType": "OCO",
      "listStatusType": "EXEC_STARTED",
      "listOrderStatus": "EXECUTING",
      "listClientOrderId": "08985fedd9ea2cf6b28996",
      "transactionTime": 1660801713793,
      "symbol": "BTCUSDT",
      "orders": [
        {
          "symbol": "BTCUSDT",
          "orderId": 4,
          "clientOrderId": "CUhLgTXnX5n2c0gWiLpV4d"
        }
      ]
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Current open orders (USER_DATA)

Query execution status of all open orders.

If you need to continuously monitor order status updates, please consider using WebSocket Streams:

userDataStream.subscribe if on an authenticated session
userDataStream.subscribe.signature if subscribing through signature subscription

WSS

openOrders.status

wss://ws-api.binance.com:443/ws-api/v3

Current open orders (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

Current open orders (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 Weight

Parameter	Weight
`symbol`	6
none	80

Current open orders (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

openOrders.status

Example: openOrders.status

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

symbol

string

If omitted, open orders for all symbols are returned

Example: BNBUSDT

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Current open orders (USER_DATA) › Responses

Successful Response

Current open orders

id

string

Example: 55f07876-4f6f-4c47-87dc-43e5fff3f2e7

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 12569099453

orderListId

integer · int64

Present only for orders that belong to an order list.

Example: -1

clientOrderId

string

Example: 4d96324ff9d44481926157

price

string

Example: 23416.1

origQty

string

Example: 0.00847

executedQty

string

Example: 0.0072

origQuoteOrderQty

string

Always present. Zero if the order type does not use quoteOrderQty.

Example: 0

cummulativeQuoteQty

string

Example: 172.43931

status

string

Example: PARTIALLY_FILLED

timeInForce

string

Example: GTC

type

string

Example: LIMIT

side

string

Example: SELL

time

integer · int64

Order placement time.

Example: 1660801715639

updateTime

integer · int64

Time of the last update to the order.

Example: 1660801717945

isWorking

boolean

Example: true

workingTime

integer · int64

Example: 1660801715639

selfTradePreventionMode

string

Example: NONE

icebergQty

string

Appears only if the parameter icebergQty was sent in the request.

Example: 0.00000000

preventedMatchId

integer · int64

Appears only if the order expired due to STP.

Example: 0

preventedQuantity

string

Order quantity that expired due to STP.

Example: 1.200000

stopPrice

string

Appears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.

Example: 0.00000000

strategyId

integer · int64

Appears only if the strategyId parameter was provided upon order placement.

Example: 1

strategyType

integer · int64

Appears only if the strategyType parameter was provided upon order placement.

Example: 1000000

trailingDelta

integer · int64

Delta price change required before order activation.

Example: 10

trailingTime

integer · int64

Time when the trailing order is now active and tracking price changes.

Example: -1

usedSor

boolean

Field that determines whether order used SOR.

Example: true

workingFloor

string

Determines whether the order is being filled by the SOR or by the order book.

Example: SOR

pegPriceType

string

Price peg type. Only for pegged orders.

Example: PRIMARY_PEG

pegOffsetType

string

Price peg offset type. Only for pegged orders, if requested.

Example: PRICE_LEVEL

pegOffsetValue

integer · int64

Price peg offset value. Only for pegged orders, if requested.

Example: 5

peggedPrice

string

Current price order is pegged at. Only for pegged orders, once determined.

Example: 87523.83710000

expiryReason

string

Cause of the order's expiration. Appears when an order has expired.

Example: INSUFFICIENT_LIQUIDITY

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSopenOrders.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrders.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrders.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "55f07876-4f6f-4c47-87dc-43e5fff3f2e7",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 12569099453,
      "orderListId": -1,
      "clientOrderId": "4d96324ff9d44481926157",
      "price": 23416.1,
      "origQty": 0.00847,
      "executedQty": 0.0072,
      "origQuoteOrderQty": 0,
      "cummulativeQuoteQty": 172.43931,
      "status": "PARTIALLY_FILLED",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "time": 1660801715639,
      "updateTime": 1660801717945,
      "isWorking": true,
      "workingTime": 1660801715639,
      "selfTradePreventionMode": "NONE",
      "icebergQty": "0.00000000",
      "preventedMatchId": 0,
      "preventedQuantity": "1.200000",
      "stopPrice": "0.00000000",
      "strategyId": 1,
      "strategyType": 1000000,
      "trailingDelta": 10,
      "trailingTime": -1,
      "usedSor": true,
      "workingFloor": "SOR",
      "pegPriceType": "PRIMARY_PEG",
      "pegOffsetType": "PRICE_LEVEL",
      "pegOffsetValue": 5,
      "peggedPrice": "87523.83710000",
      "expiryReason": "INSUFFICIENT_LIQUIDITY"
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Order Amendments (USER_DATA)

Queries all amendments of a single order.

WSS

order.amendments

wss://ws-api.binance.com:443/ws-api/v3

Query Order Amendments (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 Amendments (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 Weight4

Query Order Amendments (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

order.amendments

Example: order.amendments

object · required

symbol

string · required

Example: BNBUSDT

orderId

integer · int64 · required

Order ID

Example: 1

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

fromExecutionId

integer · int64

Execution ID to begin at

Example: 1

limit

integer · int64 · max: 1000

Default: 500; Maximum: 1000

Example: 1

Default: 500

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Query Order Amendments (USER_DATA) › Responses

Successful Response

Query Order Amendments

id

string

Example: 6f5ebe91-01d9-43ac-be99-57cf062e0e30

status

integer · int64

Example: 200

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 23

executionId

integer · int64

Example: 60

origClientOrderId

string

Example: my_pending_order

newClientOrderId

string

Example: xbxXh5SSwaHS7oUEOCI88B

origQty

string

Example: 7

newQty

string

Example: 5

time

integer · int64

Example: 1741924229819

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSorder.amendments

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.amendments",
  "params": {
    "symbol": "BNBUSDT",
    "orderId": 1,
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.amendments",
  "params": {
    "symbol": "BNBUSDT",
    "orderId": 1,
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "6f5ebe91-01d9-43ac-be99-57cf062e0e30",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 23,
      "executionId": 60,
      "origClientOrderId": "my_pending_order",
      "newClientOrderId": "xbxXh5SSwaHS7oUEOCI88B",
      "origQty": 7,
      "newQty": 5,
      "time": 1741924229819
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Order list (USER_DATA)

Check execution status of an Order list.

For execution status of individual orders, use order.status.

WSS

orderList.status

wss://ws-api.binance.com:443/ws-api/v3

Query Order list (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 list (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 Weight4

Query Order list (USER_DATA) › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

orderList.status

Example: orderList.status

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

origClientOrderId

string

Query order list by listClientOrderId. orderListId or origClientOrderId must be provided.

Example: 08985fedd9ea2cf6b28996

orderListId

integer

Query order list by orderListId. orderListId or origClientOrderId must be provided.

Example: 1

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Query Order list (USER_DATA) › Responses

Successful Response

Query Order list

id

string

Example: b53fd5ff-82c7-4a04-bd64-5f9dc42c2100

status

integer · int64

Example: 200

object

orderListId

integer · int64

Example: 1274512

contingencyType

string

Example: OCO

listStatusType

string

Example: EXEC_STARTED

listOrderStatus

string

Example: EXECUTING

listClientOrderId

string

Example: 08985fedd9ea2cf6b28996

transactionTime

integer · int64

Example: 1660801713793

symbol

string

Example: BTCUSDT

object[]

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 12569138901

clientOrderId

string

Example: BqtFCj5odMoWtSqGk2X9tU

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSorderList.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "orderList.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "orderList.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "b53fd5ff-82c7-4a04-bd64-5f9dc42c2100",
  "status": 200,
  "result": {
    "orderListId": 1274512,
    "contingencyType": "OCO",
    "listStatusType": "EXEC_STARTED",
    "listOrderStatus": "EXECUTING",
    "listClientOrderId": "08985fedd9ea2cf6b28996",
    "transactionTime": 1660801713793,
    "symbol": "BTCUSDT",
    "orders": [
      {
        "symbol": "BTCUSDT",
        "orderId": 12569138901,
        "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
      }
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query order (USER_DATA)

Check execution status of an order.

WSS

order.status

wss://ws-api.binance.com:443/ws-api/v3

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 Weight4

Query order (USER_DATA) › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

order.status

Example: order.status

object · required

symbol

string · required

Example: BNBUSDT

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

Lookup order by orderId

Example: 1

origClientOrderId

string

Lookup order by clientOrderId

Example: myOrder1

recvWindow

number · float · max: 60000

Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.

Example: 5000

Query order (USER_DATA) › Responses

Successful Response

Query order

id

string

Example: aa62318a-5a97-4f3b-bdc7-640bbe33b291

status

integer · int64

Example: 200

object

symbol

string

Example: BTCUSDT

orderId

integer · int64

Example: 12569099453

orderListId

integer · int64

Present only for orders that belong to an order list.

Example: -1

clientOrderId

string

Example: 4d96324ff9d44481926157

price

string

Example: 23416.1

origQty

string

Example: 0.00847

executedQty

string

Example: 0.00847

origQuoteOrderQty

string

Always present. Zero if the order type does not use quoteOrderQty.

Example: 0

cummulativeQuoteQty

string

Example: 198.335215

status

string

Example: FILLED

timeInForce

string

Example: GTC

type

string

Example: LIMIT

side

string

Example: SELL

stopPrice

string

Always present. Zero if the order type does not use stopPrice.

Example: 0

trailingDelta

integer · int64

Present only if trailingDelta was set on the order.

Example: 10

trailingTime

integer · int64

Present only if trailingDelta was set on the order.

Example: -1

icebergQty

string

Always present. Zero for non-iceberg orders.

Example: 0

time

integer · int64

Order placement time.

Example: 1660801715639

updateTime

integer · int64

Time of the last update to the order.

Example: 1660801717945

isWorking

boolean

Example: true

workingTime

integer · int64

Example: 1660801715639

strategyId

integer · int64

Present only if strategyId was set on the order.

Example: 37463720

strategyType

integer · int64

Present only if strategyType was set on the order.

Example: 1000000

selfTradePreventionMode

string

Example: NONE

preventedMatchId

integer · int64

Present only if the order expired due to STP.

Example: 0

preventedQuantity

string

Present only if the order expired due to STP.

Example: 1.2

usedSor

boolean

Field that determines whether order used SOR.

Example: true

workingFloor

string

Determines whether the order is being filled by the SOR or by the order book.

Example: SOR

pegPriceType

string

Price peg type. Only for pegged orders.

Example: PRIMARY_PEG

pegOffsetType

string

Price peg offset type. Only for pegged orders, if requested.

Example: PRICE_LEVEL

pegOffsetValue

integer · int64

Price peg offset value. Only for pegged orders, if requested.

Example: 5

peggedPrice

string

Current price order is pegged at. Only for pegged orders, once determined.

Example: 87523.83710000

expiryReason

string

Cause of the order's expiration. Appears when an order has expired.

Example: INSUFFICIENT_LIQUIDITY

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 6000

count

integer · int64

Example: 321

WSSorder.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.status",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.status",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "aa62318a-5a97-4f3b-bdc7-640bbe33b291",
  "status": 200,
  "result": {
    "symbol": "BTCUSDT",
    "orderId": 12569099453,
    "orderListId": -1,
    "clientOrderId": "4d96324ff9d44481926157",
    "price": 23416.1,
    "origQty": 0.00847,
    "executedQty": 0.00847,
    "origQuoteOrderQty": 0,
    "cummulativeQuoteQty": 198.335215,
    "status": "FILLED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "SELL",
    "stopPrice": 0,
    "trailingDelta": 10,
    "trailingTime": -1,
    "icebergQty": 0,
    "time": 1660801715639,
    "updateTime": 1660801717945,
    "isWorking": true,
    "workingTime": 1660801715639,
    "strategyId": 37463720,
    "strategyType": 1000000,
    "selfTradePreventionMode": "NONE",
    "preventedMatchId": 0,
    "preventedQuantity": 1.2,
    "usedSor": true,
    "workingFloor": "SOR",
    "pegPriceType": "PRIMARY_PEG",
    "pegOffsetType": "PRICE_LEVEL",
    "pegOffsetValue": 5,
    "peggedPrice": "87523.83710000",
    "expiryReason": "INSUFFICIENT_LIQUIDITY"
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json