getExpectedBidOrders

Retrieves unconfirmed, pending buy-side (bid) order placement transactions currently resting in the node's unconfirmed transaction memory pool before inclusion in an upcoming block.

---

Endpoint Details

• HTTP Method: POST
• Gateway Path: /nxt
• Content-Type: application/x-www-form-urlencoded
• API Tags: AE
• Chain Specific: Optional / Conditional

---

Request Parameters

Parameter	Type	Required	Description
requestType	String	Yes	Must be set to getExpectedBidOrders.
chain	int	No	Sovereign BetaChain ID filter. If omitted, returns expected bid orders across all chains.
totem	long / String	No	Unique $64$-bit identifier of the Totem to filter by. Default: 0 (returns all).
sortByPrice	boolean	No	If true, sorts expected orders by price in descending order (highest bid price first). Default: false.

---

Example Request

curl -X POST http://localhost:22024/nxt \
  -d "requestType=getExpectedBidOrders" \
  -d "chain=2" \
  -d "totem=9876543210123456789" \
  -d "sortByPrice=true"

---

Successful Response

{
  "bidOrders": [
    {
      "transaction": "47382019481029384",
      "totem": "9876543210123456789",
      "currency": "5544332211",
      "sender": "9876543210987654321",
      "senderRS": "SHAMWARI-WXYZ-EFGH-JKLM-NOPQR",
      "quantityQNT": "500000",
      "priceNQT": "50000",
      "feeNQT": "10000000",
      "height": 500121,
      "type": 2,
      "subtype": 1
    }
  ]
}

---

Error Codes

Error Code	Cause / Description
INCORRECT_CHAIN	Invalid or non-existent BetaChain ID provided in the request.
UNKNOWN_TOTEM	Provided totem parameter is non-numeric or invalid $64$-bit integer representation.