Skip to main content

getExpectedAskOrders

Retrieves unconfirmed, pending sell-side (ask) 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

ParameterTypeRequiredDescription
requestTypeStringYesMust be set to getExpectedAskOrders.
chainintNoSovereign BetaChain ID filter. If omitted, returns expected ask orders across all chains.
totemlong / StringNoUnique 6464-bit identifier of the Totem to filter by. Default: 0 (returns all).
sortByPricebooleanNoIf true, sorts expected orders by price in ascending order (cheapest ask price first). Default: false.

Example Request

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

Successful Response

{
"askOrders": [
{
"transaction": "88492019481029384",
"totem": "9876543210123456789",
"currency": "5544332211",
"sender": "1234567890123456789",
"senderRS": "SHAMWARI-ABCD-EFGH-JKLM-NOPQR",
"quantityQNT": "1000000",
"priceNQT": "50000",
"feeNQT": "10000000",
"height": 500121,
"type": 2,
"subtype": 2
}
]
}

Error Codes

Error CodeCause / Description
INCORRECT_CHAINInvalid or non-existent BetaChain ID provided in the request.
UNKNOWN_TOTEMProvided totem parameter is non-numeric or invalid 6464-bit integer representation.