Overview
Query the status of a limit order on a decentralized exchange (DEX) using this API endpoint.
Endpoint
GET https://web3.okx.com/api/v5/dex/aggregator/limit-order/detail
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| orderHash | String | Yes | Post-signature data |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| createTime | string | Order creation timestamp |
| expireTime | string | Order expiration deadline |
| failureReason | string | Error message (if applicable) |
| orderHash | string | Post-signature data |
| signature | string | Wallet-signed data |
| chainId | string | Blockchain ID (e.g., 1 for Ethereum) |
| makerAssetAddress | string | Order creator's wallet address |
| makerTokenAddress | string | Sold token contract address |
| makingAmount | string | Amount of sold tokens |
| takerTokenAddress | string | Purchased token contract address |
| takingAmount | string | Amount of purchased tokens |
| makerRate | string | takingAmount/makingAmount |
| takerRate | string | makingAmount/takingAmount |
| receiver | string | Default: zero address. If set, assets route to specified address |
| remainingMakerAmount | string | Remaining tradable quantity |
| salt | string | Random nonce for idempotency (current timestamp in seconds) |
| status | string | Order status (1–7; see details below) |
| takerAssetAddress | string | Default: zero address. If set, order executes only at specified address |
Order Status Codes
- Active
- Temporarily inactive
- Processing on-chain
- Expired
- Cancelled
- Successful
- Failed
👉 Explore advanced DEX trading strategies
FAQ
How do I find my orderHash?
The orderHash is generated after signing the order data via your wallet. Check your transaction logs or API response from order placement.
What chain IDs are supported?
Refer to the official chain ID list. Common examples include Ethereum (1) and BSC (56).
Can I modify a limit order after submission?
No. DEX limit orders are immutable once signed. To change terms, cancel the existing order and create a new one.