API Reference: cancelBidOrder

Cancels an active buy-side (bid) order on a sovereign BetaChain order book and releases locked currency funds back to the buyer's account unconfirmed balance.

---

Endpoint Details

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

---

Request Parameters

Parameter	Type	Required	Description
requestType	String	Yes	Must be set to cancelBidOrder.
order	long	Yes	Unique 64-bit identifier of the bid order to cancel.
chain	int	Yes	Sovereign BetaChain ID where the order resides.
secretPhrase	String	Yes	Post-Quantum Cryptography (PQC) passphrase of the account that placed the order.
feeNQT	long	Conditional	Transaction execution fee in base units (NQT).
deadline	short	Conditional	Transaction expiration window in minutes (1-1440).

---

Example Request

curl -X POST http://localhost:22024/nxt \
  -d "requestType=cancelBidOrder" \
  -d "chain=2" \
  -d "order=47382019481029384" \
  -d "secretPhrase=your_pqc_passphrase" \
  -d "feeNQT=10000000" \
  -d "deadline=60"

---

Successful Response

{
  "signatureHash": "b8e7c6a5...",
  "unsignedTransactionBytes": "0100...",
  "transactionJSON": {
    "sender": "1234567890123456789",
    "feeNQT": "10000000",
    "type": 2,
    "subtype": 4,
    "attachment": {
      "version.OrderCancellation": 1,
      "order": "47382019481029384"
    },
    "timestamp": 89234150
  },
  "broadcasted": true,
  "transaction": "87123049120394811"
}

---

Error Codes

Error Code	Cause / Description
UNKNOWN_ORDER	Order ID does not exist or does not belong to the requesting sender account.
INSUFFICIENT_FEE	The specified feeNQT is below the network minimum threshold for order cancellation.