getBidOrderIds

Retrieves a paginated array of unsigned $64$-bit order identifiers for active buy-side (bid) orders matching a specific Totem-currency pair, sorted by price descending.

---

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 getBidOrderIds.
totem	long / String	Yes	Unique $64$-bit identifier of the Totem.
currency	long / String	Yes	Unique $64$-bit identifier of the payment currency.
chain	int	Yes	Sovereign BetaChain ID.
firstIndex	int	No	Zero-based start index for pagination. Default: 0.
lastIndex	int	No	End index for pagination. Default: -1.

---

Example Request

curl -X POST http://localhost:22024/nxt \
  -d "requestType=getBidOrderIds" \
  -d "chain=2" \
  -d "totem=9876543210123456789" \
  -d "currency=5544332211" \
  -d "firstIndex=0" \
  -d "lastIndex=10"

---

Successful Response

{
  "bidOrderIds": [
    "47382019481029384",
    "47382019481029387",
    "47382019481029390"
  ]
}

---

Error Codes

Error Code	Cause / Description
UNKNOWN_TOTEM	Totem ID does not exist on the network.
UNKNOWN_CURRENCY	Currency ID does not exist on the specified BetaChain.
INCORRECT_CHAIN	Invalid or inactive BetaChain ID specified.