getAskOrder
Retrieves full details for a single active sell-side (ask) order by its unique -bit order identifier.
Endpoint Details
- HTTP Method:
POST - Gateway Path:
/nxt - Content-Type:
application/x-www-form-urlencoded - API Tags:
AE - Chain Specific: Yes
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
requestType | String | Yes | Must be set to getAskOrder. |
order | long / String | Yes | Unique -bit identifier of the ask order to look up. |
chain | int | Yes | Sovereign BetaChain ID where the order resides. |
Example Request
curl -X POST http://localhost:22024/nxt \
-d "requestType=getAskOrder" \
-d "chain=2" \
-d "order=88492019481029384"
Successful Response
{
"order": "88492019481029384",
"totem": "9876543210123456789",
"currency": "5544332211",
"account": "1234567890123456789",
"accountRS": "SHAMWARI-ABCD-EFGH-JKLM-NOPQR",
"quantityQNT": "1000000",
"priceNQT": "50000",
"height": 500120,
"type": "ask"
}
Error Codes
| Error Code | Cause / Description |
|---|---|
UNKNOWN_ORDER | The specified order ID does not exist on the specified BetaChain order book. |
INCORRECT_CHAIN | Invalid or inactive BetaChain ID specified. |