---
title: "Query Order (USER_DATA)"
method: GET
path: "/api/v3/order"
tags: ["Trade"]
---

# Query Order (USER_DATA)

`GET /api/v3/order`

Check an order's status.

- Either `orderId` or `origClientOrderId` must be sent.
- For some historical orders `cummulativeQuoteQty` will be < 0, meaning the data is not available at this time.

Weight(IP): 4

## Query parameters

- `symbol` string, required
- `orderId` integer
- `origClientOrderId` string
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Order details

- OrderDetails
  - `symbol` string, required
  - `orderId` integer, required
  - `orderListId` integer, required — Unless OCO, value will be -1
  - `clientOrderId` string, required
  - `price` string, required
  - `origQty` string, required
  - `executedQty` string, required
  - `cummulativeQuoteQty` string, required
  - `status` string, required
  - `timeInForce` string, required
  - `type` string, required
  - `side` string, required
  - `stopPrice` string, required
  - `icebergQty` string, required
  - `time` integer, required
  - `updateTime` integer, required
  - `isWorking` boolean, required
  - `workingTime` integer, required
  - `origQuoteOrderQty` string, required
  - `selfTradePreventionMode` string, required
  - `preventedMatchId` integer
  - `preventedQuantity` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Request

---

[API](https://skmtc.net/binance/apis/binance-public-spot-api.md) · [All operations](https://skmtc.net/binance/apis/binance-public-spot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/binance/binance-public-spot-api/revisions/0dd2f133e12d/schema)