getBidOrder

Retrieves full details for a single active buy-side (bid) order by its unique $64$-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 getBidOrder.
order	long / String	Yes	Unique $64$-bit identifier of the bid 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=getBidOrder" \
  -d "chain=2" \
  -d "order=47382019481029384"

---

Successful Response

{
  "order": "47382019481029384",
  "totem": "9876543210123456789",
  "currency": "5544332211",
  "account": "9876543210987654321",
  "accountRS": "SHAMWARI-WXYZ-EFGH-JKLM-NOPQR",
  "quantityQNT": "500000",
  "priceNQT": "50000",
  "height": 500122,
  "type": "bid"
}

---

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.