Trade

Endpointhttps://api.binance.com

Place Equity Order (TRADE)

Place a new equity order. Supports all combinations of LIMIT / MARKET × BUY / SELL. For LIMIT BUY orders the commission fee is automatically computed and reserved by the server at placement time — callers submit price and quantity only, no fee field is required.

Field combination matrix

| Side | OrderType | Required | Forbidden | | ---- | --------- | -------- | --------- | | BUY | LIMIT | price, quantity, tradingSession | notional | | BUY | MARKET | notional | price, quantity, tradingSession | | SELL | LIMIT | price, quantity, tradingSession | notional | | SELL | MARKET | quantity | price, notional, tradingSession |

Fractional shares: when quantity has a decimal component, or an order is placed by notional, it is treated as a fractional-share order. A fractional-share GTC order must be paired with tradingSession = EXTENDED or 24H.

Rate limit: 200 requests / min (UID).

POST

/sapi/v1/equity/order/place

https://api.binance.com

Place Equity 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

Place Equity 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

Place Equity Order (TRADE) › Headers

X-MBX-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

Place Equity Order (TRADE) › Query Parameters

symbol

string · required

US stock ticker, e.g. AAPL, TSLA. Must be a symbol with tokenization enabled — check via /market/tokenized-assets.

Example: AAPL

side

string · enum · required

BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderType

string · enum · required

MARKET / LIMIT.

Enum values:

MARKET

LIMIT

Example: LIMIT

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

quoteAsset

string

Quote asset. Defaults to USDC; must be within the server's allowed set.

Example: USDC

price

string

Required for LIMIT; forbidden for MARKET. Maximum 2 decimal places.

Example: 180.50

quantity

string

Required for LIMIT (both sides) and SELL MARKET; forbidden for BUY MARKET.

Example: 1

notional

string

Required for BUY MARKET; forbidden for LIMIT and SELL MARKET.

Example: 1000.00

timeInForce

string · enum

DAY (default) / GTC. GTC is only supported for LIMIT orders; a fractional-share GTC order must be paired with tradingSession = EXTENDED or 24H.

Enum values:

DAY

GTC

Example: DAY

tradingSession

string · enum

RTH / EXTENDED / 24H. Required for LIMIT; forbidden for MARKET.

Enum values:

RTH

EXTENDED

24H

Example: RTH

walletType

string · enum

Payment wallet for BUY orders: CARD (default) / MAIN. SELL orders always settle to CARD.

Enum values:

CARD

MAIN

Example: CARD

clientOrderId

string

Client-supplied order id. Format ^[a-zA-Z0-9-_]{32,36}$. Auto-generated when omitted.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

tokenize

boolean

Whether to tokenize the purchased stock asset upon settlement. Default true. Set to false to receive the underlying equity directly instead of a tokenized asset.

Example: true

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Place Equity Order (TRADE) › Responses

200

Place Equity Order

status

string

Acknowledgement code: S = accepted, F = failed. Not an order lifecycle status — to poll lifecycle, call /order/detail or /order/history.

Example: S

orderId

string

Order id (UUID).

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Echoes the supplied or server-generated client order id.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

Cancel Equity Order (TRADE)

Cancel a single open order by its orderId.

POST

/sapi/v1/equity/order/cancel

https://api.binance.com

Cancel Equity 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 Equity 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 Equity Order (TRADE) › Headers

X-MBX-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

Cancel Equity Order (TRADE) › Query Parameters

orderId

string · required

Equity order id returned by /order/place or a query endpoint.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Cancel Equity Order (TRADE) › Responses

200

Cancel Equity Order

orderId

string

Echoes the requested order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

status

string

Acknowledgement code: S = cancel accepted by upstream, F = cancel failed. Not an order lifecycle status — use /order/detail for lifecycle poll.

Example: S

Cancel All Equity Orders (TRADE)

Cancel all open orders for the caller. No request body is required — the scope is all of the caller's open orders. The downstream service handles idempotency; to inspect per-order outcomes, query /order/history after the call.

POST

/sapi/v1/equity/order/cancel-all

https://api.binance.com

Cancel All Equity Orders (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 All Equity Orders (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 All Equity Orders (TRADE) › Headers

X-MBX-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

Cancel All Equity Orders (TRADE) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Cancel All Equity Orders (TRADE) › Responses

200

Cancel All Equity Orders

success

boolean

true when the cancel-all request was accepted by upstream. Per-order outcomes live in /order/history.

Example: true

Current Open Orders (USER_DATA)

Query all unfinished (open) orders for the caller. No business parameters are needed — user identity is derived from the signature.

GET

/sapi/v1/equity/order/open-orders

https://api.binance.com

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 Weight1

Current Open Orders (USER_DATA) › Headers

X-MBX-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

Current Open Orders (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Current Open Orders (USER_DATA) › Responses

200

Current Open Orders

object

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset (e.g. USDC).

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT orders, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). null until the first fill.

Example: null

qty

string | null

Requested quantity. null for BUY MARKET (use notional instead).

Example: 1

notional

string | null

Requested notional. Non-null for BUY MARKET; null otherwise.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 0

filledTotal

string | null

Cumulative filled notional. Populated only for BUY MARKET.

Example: null

fee

string

Total commission fee (USD).

Example: 0

session

string | null

Trading session the order was placed under: RTH / EXTENDED / 24H. null for MARKET orders.

Example: RTH

status

string

Order lifecycle status — one of NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED.

Example: NEW

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900000000

Equity Order History (USER_DATA)

Paged order history for the caller. Filters by symbol, order type, side, status, and time range.

GET

/sapi/v1/equity/order/history

https://api.binance.com

Equity 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

Equity 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 Weight1

Equity Order History (USER_DATA) › Headers

X-MBX-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

Equity Order History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Start time (ms epoch).

Example: 1735800000000

endTime

integer · int64 · required

End time (ms epoch).

Example: 1735900000000

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

symbol

string

US-equity ticker filter, e.g. NVDA.

Example: NVDA

orderType

string · enum

Order type filter: MARKET / LIMIT.

Enum values:

MARKET

LIMIT

Example: LIMIT

side

string · enum

Side filter: BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderStatus

string

Comma-separated status filter. Allowed values: FILLED, PARTIALLY_FILLED, CANCELED, EXPIRED, REJECTED.

Example: FILLED,CANCELED

current

integer

Page number, 1-based. Default 1.

Example: 1

size

integer

Page size. Default 20, max 100.

Example: 20

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Order History (USER_DATA) › Responses

200

Equity Order History

total

integer · int64

Total number of rows matching the filter.

Example: 2

page

integer

Current page (echoes current).

Example: 1

size

integer

Current page size (echoes size).

Example: 20

object[]

Order rows on this page. Empty array if nothing matches.

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset (e.g. USDC).

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT orders, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). null until the first fill. For MARKET orders this is the only meaningful price field.

Example: 180.48

qty

string | null

Requested quantity. null for BUY MARKET (use notional instead).

Example: 1

notional

string | null

Requested notional. Non-null for BUY MARKET; null otherwise.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 1

filledTotal

string | null

Cumulative filled notional. Populated only for BUY MARKET.

Example: null

fee

string

Total commission fee (USD).

Example: 0.10

session

string | null

Trading session the order was placed under: RTH / EXTENDED / 24H. null for MARKET orders.

Example: RTH

status

string

Order lifecycle status — one of NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED.

Example: FILLED

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900120000

Equity Order Detail (USER_DATA)

Returns a single order along with its trade execution list. Callers can only read their own orders — the user identity is derived from the signed request.

GET

/sapi/v1/equity/order/detail

https://api.binance.com

Equity Order Detail (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

Equity Order Detail (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

Equity Order Detail (USER_DATA) › Headers

X-MBX-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

Equity Order Detail (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

orderId

string

Equity order id. Either orderId or clientOrderId must be provided.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Client-supplied order id. Either orderId or clientOrderId must be provided.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Order Detail (USER_DATA) › Responses

200

Equity Order Detail

Top-level fields mirror an order row from `/order/history` (orderId, symbol, quote, side, orderType, limitPrice, avgFilledPrice, qty, notional, filledQty, filledTotal, fee, session, status, createdAt, updatedAt), plus a `trades` array. `clientOrderId` is present only in Order Detail, not in Order History.

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Client-supplied order id. Present only in Order Detail, not in Order History.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset.

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). Only present when the order has at least one fill.

Example: 180.48

qty

string | null

Requested quantity.

Example: 1

notional

string | null

Requested notional.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 1

filledTotal

string | null

Cumulative filled notional.

Example: null

fee

string

Total commission fee (USD).

Example: 0.10

session

string | null

Trading session.

Example: RTH

status

string

Order lifecycle status.

Example: FILLED

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900120000

object[]

Trade executions for this order, most recent first. Empty array when no fills.

executionId

string

Execution (fill) id.

Example: exec-20260504-0001

executionAt

integer · int64

Execution time (ms epoch).

Example: 1735900115000

price

string

Fill price for this execution (USD).

Example: 180.48

qty

string

Fill quantity.

Example: 1

GET/sapi/v1/equity/order/detail

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/equity/order/detail?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "orderId": "c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71",
  "clientOrderId": "web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a",
  "symbol": "AAPL",
  "quote": "USDC",
  "side": "BUY",
  "orderType": "LIMIT",
  "limitPrice": "180.50",
  "avgFilledPrice": "180.48",
  "qty": "1",
  "notional": null,
  "filledQty": "1",
  "filledTotal": null,
  "fee": "0.10",
  "session": "RTH",
  "status": "FILLED",
  "createdAt": 1735900000000,
  "updatedAt": 1735900120000,
  "trades": [
    {
      "executionId": "exec-20260504-0001",
      "executionAt": 1735900115000,
      "price": "180.48",
      "qty": "1"
    }
  ]
}

json

application/json

Equity Trade History (USER_DATA)

Paged equity trade (per-fill) history for the caller. Each row is one execution, not one order — a partially filled order produces multiple rows. Filters by symbol, side, specific orderId, and time range.

GET

/sapi/v1/equity/trade/history

https://api.binance.com

Equity 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

Equity 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 Weight1

Equity Trade History (USER_DATA) › Headers

X-MBX-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

Equity Trade History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Start time (ms epoch).

Example: 1735800000000

endTime

integer · int64 · required

End time (ms epoch).

Example: 1735900000000

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

symbol

string

US-equity ticker filter, e.g. NVDA.

Example: NVDA

side

string · enum

Side filter: BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderId

string

Narrow the result to executions of a single order.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

current

integer

Page number, 1-based. Default 1.

Example: 1

size

integer

Page size. Default 20, max 100.

Example: 20

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Trade History (USER_DATA) › Responses

200

Equity Trade History

total

integer · int64

Total number of rows matching the filter.

Example: 1

page

integer

Current page.

Example: 1

size

integer

Current page size.

Example: 20

object[]

Trade rows on this page. Empty when nothing matches.

executionId

string

Execution (per-fill) id.

Example: exec-20260504-0001

orderId

string

The owning order's id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset.

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

price

string

Execution price (USD).

Example: 180.50

qty

string

Executed quantity.

Example: 1

total

string

Notional of this execution (qty × price).

Example: 180.50

executionAt

integer · int64

Execution time (ms epoch).

Example: 1735900115000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900115200

Trade

Endpointhttps://api.binance.com

Download schema

Place Equity Order (TRADE)

Field combination matrix

Rate limit: 200 requests / min (UID).

POST

/sapi/v1/equity/order/place

https://api.binance.com

Place Equity 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

Place Equity 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

Place Equity Order (TRADE) › Headers

X-MBX-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

Place Equity Order (TRADE) › Query Parameters

symbol

string · required

US stock ticker, e.g. AAPL, TSLA. Must be a symbol with tokenization enabled — check via /market/tokenized-assets.

Example: AAPL

side

string · enum · required

BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderType

string · enum · required

MARKET / LIMIT.

Enum values:

MARKET

LIMIT

Example: LIMIT

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

quoteAsset

string

Quote asset. Defaults to USDC; must be within the server's allowed set.

Example: USDC

price

string

Required for LIMIT; forbidden for MARKET. Maximum 2 decimal places.

Example: 180.50

quantity

string

Required for LIMIT (both sides) and SELL MARKET; forbidden for BUY MARKET.

Example: 1

notional

string

Required for BUY MARKET; forbidden for LIMIT and SELL MARKET.

Example: 1000.00

timeInForce

string · enum

DAY (default) / GTC. GTC is only supported for LIMIT orders; a fractional-share GTC order must be paired with tradingSession = EXTENDED or 24H.

Enum values:

DAY

GTC

Example: DAY

tradingSession

string · enum

RTH / EXTENDED / 24H. Required for LIMIT; forbidden for MARKET.

Enum values:

RTH

EXTENDED

24H

Example: RTH

walletType

string · enum

Payment wallet for BUY orders: CARD (default) / MAIN. SELL orders always settle to CARD.

Enum values:

CARD

MAIN

Example: CARD

clientOrderId

string

Client-supplied order id. Format ^[a-zA-Z0-9-_]{32,36}$. Auto-generated when omitted.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

tokenize

boolean

Whether to tokenize the purchased stock asset upon settlement. Default true. Set to false to receive the underlying equity directly instead of a tokenized asset.

Example: true

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Place Equity Order (TRADE) › Responses

200

Place Equity Order

status

string

Acknowledgement code: S = accepted, F = failed. Not an order lifecycle status — to poll lifecycle, call /order/detail or /order/history.

Example: S

orderId

string

Order id (UUID).

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Echoes the supplied or server-generated client order id.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

Cancel Equity Order (TRADE)

Cancel a single open order by its orderId.

POST

/sapi/v1/equity/order/cancel

https://api.binance.com

Cancel Equity 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 Equity 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 Equity Order (TRADE) › Headers

X-MBX-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

Cancel Equity Order (TRADE) › Query Parameters

orderId

string · required

Equity order id returned by /order/place or a query endpoint.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Cancel Equity Order (TRADE) › Responses

200

Cancel Equity Order

orderId

string

Echoes the requested order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

status

string

Acknowledgement code: S = cancel accepted by upstream, F = cancel failed. Not an order lifecycle status — use /order/detail for lifecycle poll.

Example: S

Cancel All Equity Orders (TRADE)

POST

/sapi/v1/equity/order/cancel-all

https://api.binance.com

Cancel All Equity Orders (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 All Equity Orders (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 All Equity Orders (TRADE) › Headers

X-MBX-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

Cancel All Equity Orders (TRADE) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Cancel All Equity Orders (TRADE) › Responses

200

Cancel All Equity Orders

success

boolean

true when the cancel-all request was accepted by upstream. Per-order outcomes live in /order/history.

Example: true

Current Open Orders (USER_DATA)

Query all unfinished (open) orders for the caller. No business parameters are needed — user identity is derived from the signature.

GET

/sapi/v1/equity/order/open-orders

https://api.binance.com

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 Weight1

Current Open Orders (USER_DATA) › Headers

X-MBX-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

Current Open Orders (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Current Open Orders (USER_DATA) › Responses

200

Current Open Orders

object

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset (e.g. USDC).

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT orders, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). null until the first fill.

Example: null

qty

string | null

Requested quantity. null for BUY MARKET (use notional instead).

Example: 1

notional

string | null

Requested notional. Non-null for BUY MARKET; null otherwise.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 0

filledTotal

string | null

Cumulative filled notional. Populated only for BUY MARKET.

Example: null

fee

string

Total commission fee (USD).

Example: 0

session

string | null

Trading session the order was placed under: RTH / EXTENDED / 24H. null for MARKET orders.

Example: RTH

status

string

Order lifecycle status — one of NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED.

Example: NEW

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900000000

Equity Order History (USER_DATA)

Paged order history for the caller. Filters by symbol, order type, side, status, and time range.

GET

/sapi/v1/equity/order/history

https://api.binance.com

Equity 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

Equity 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 Weight1

Equity Order History (USER_DATA) › Headers

X-MBX-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

Equity Order History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Start time (ms epoch).

Example: 1735800000000

endTime

integer · int64 · required

End time (ms epoch).

Example: 1735900000000

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

symbol

string

US-equity ticker filter, e.g. NVDA.

Example: NVDA

orderType

string · enum

Order type filter: MARKET / LIMIT.

Enum values:

MARKET

LIMIT

Example: LIMIT

side

string · enum

Side filter: BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderStatus

string

Comma-separated status filter. Allowed values: FILLED, PARTIALLY_FILLED, CANCELED, EXPIRED, REJECTED.

Example: FILLED,CANCELED

current

integer

Page number, 1-based. Default 1.

Example: 1

size

integer

Page size. Default 20, max 100.

Example: 20

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Order History (USER_DATA) › Responses

200

Equity Order History

total

integer · int64

Total number of rows matching the filter.

Example: 2

page

integer

Current page (echoes current).

Example: 1

size

integer

Current page size (echoes size).

Example: 20

object[]

Order rows on this page. Empty array if nothing matches.

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset (e.g. USDC).

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT orders, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). null until the first fill. For MARKET orders this is the only meaningful price field.

Example: 180.48

qty

string | null

Requested quantity. null for BUY MARKET (use notional instead).

Example: 1

notional

string | null

Requested notional. Non-null for BUY MARKET; null otherwise.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 1

filledTotal

string | null

Cumulative filled notional. Populated only for BUY MARKET.

Example: null

fee

string

Total commission fee (USD).

Example: 0.10

session

string | null

Trading session the order was placed under: RTH / EXTENDED / 24H. null for MARKET orders.

Example: RTH

status

string

Order lifecycle status — one of NEW / ACCEPTED / PARTIALLY_FILLED / FILLED / CANCELED / EXPIRED / REJECTED.

Example: FILLED

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900120000

Equity Order Detail (USER_DATA)

Returns a single order along with its trade execution list. Callers can only read their own orders — the user identity is derived from the signed request.

GET

/sapi/v1/equity/order/detail

https://api.binance.com

Equity Order Detail (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

Equity Order Detail (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

Equity Order Detail (USER_DATA) › Headers

X-MBX-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

Equity Order Detail (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

orderId

string

Equity order id. Either orderId or clientOrderId must be provided.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Client-supplied order id. Either orderId or clientOrderId must be provided.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Order Detail (USER_DATA) › Responses

200

Equity Order Detail

orderId

string

Equity order id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

clientOrderId

string

Client-supplied order id. Present only in Order Detail, not in Order History.

Example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset.

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

limitPrice

string | null

Limit price (USD). Non-null for LIMIT, null for MARKET.

Example: 180.50

avgFilledPrice

string | null

Average fill price (USD). Only present when the order has at least one fill.

Example: 180.48

qty

string | null

Requested quantity.

Example: 1

notional

string | null

Requested notional.

Example: null

filledQty

string

Cumulative filled quantity.

Example: 1

filledTotal

string | null

Cumulative filled notional.

Example: null

fee

string

Total commission fee (USD).

Example: 0.10

session

string | null

Trading session.

Example: RTH

status

string

Order lifecycle status.

Example: FILLED

createdAt

integer · int64

Order creation time (ms epoch).

Example: 1735900000000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900120000

object[]

Trade executions for this order, most recent first. Empty array when no fills.

executionId

string

Execution (fill) id.

Example: exec-20260504-0001

executionAt

integer · int64

Execution time (ms epoch).

Example: 1735900115000

price

string

Fill price for this execution (USD).

Example: 180.48

qty

string

Fill quantity.

Example: 1

GET/sapi/v1/equity/order/detail

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/equity/order/detail?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "orderId": "c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71",
  "clientOrderId": "web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a",
  "symbol": "AAPL",
  "quote": "USDC",
  "side": "BUY",
  "orderType": "LIMIT",
  "limitPrice": "180.50",
  "avgFilledPrice": "180.48",
  "qty": "1",
  "notional": null,
  "filledQty": "1",
  "filledTotal": null,
  "fee": "0.10",
  "session": "RTH",
  "status": "FILLED",
  "createdAt": 1735900000000,
  "updatedAt": 1735900120000,
  "trades": [
    {
      "executionId": "exec-20260504-0001",
      "executionAt": 1735900115000,
      "price": "180.48",
      "qty": "1"
    }
  ]
}

json

application/json

Equity Trade History (USER_DATA)

GET

/sapi/v1/equity/trade/history

https://api.binance.com

Equity 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

Equity 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 Weight1

Equity Trade History (USER_DATA) › Headers

X-MBX-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

Equity Trade History (USER_DATA) › Query Parameters

startTime

integer · int64 · required

Start time (ms epoch).

Example: 1735800000000

endTime

integer · int64 · required

End time (ms epoch).

Example: 1735900000000

timestamp

integer · int64 · required

Timestamp in milliseconds.

Example: 1770736694138

symbol

string

US-equity ticker filter, e.g. NVDA.

Example: NVDA

side

string · enum

Side filter: BUY / SELL.

Enum values:

BUY

SELL

Example: BUY

orderId

string

Narrow the result to executions of a single order.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

current

integer

Page number, 1-based. Default 1.

Example: 1

size

integer

Page size. Default 20, max 100.

Example: 20

recvWindow

integer · int64

The value cannot be greater than 60000.

Example: 5000

Equity Trade History (USER_DATA) › Responses

200

Equity Trade History

total

integer · int64

Total number of rows matching the filter.

Example: 1

page

integer

Current page.

Example: 1

size

integer

Current page size.

Example: 20

object[]

Trade rows on this page. Empty when nothing matches.

executionId

string

Execution (per-fill) id.

Example: exec-20260504-0001

orderId

string

The owning order's id.

Example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71

symbol

string

US-equity ticker.

Example: AAPL

quote

string

Quote asset.

Example: USDC

side

string

BUY / SELL.

Example: BUY

orderType

string

MARKET / LIMIT.

Example: LIMIT

price

string

Execution price (USD).

Example: 180.50

qty

string

Executed quantity.

Example: 1

total

string

Notional of this execution (qty × price).

Example: 180.50

executionAt

integer · int64

Execution time (ms epoch).

Example: 1735900115000

updatedAt

integer · int64

Last update time (ms epoch).

Example: 1735900115200