Skip to main content
POST
Cancel an unfilled 0fns order placement

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Allocations:Update: Always required
Wallets:Transactions:Create: Always required. The cancellation (cancelOrder) is broadcast from your wallet.
FeeSponsors:Use: Required if feeSponsorId is specified and the sponsoree wallet belongs to an EndUser user kind.

Authorizations

Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION
string
header
required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Body

application/json

Cancel an unfilled 0fns OrderBook order placement and reclaim its escrow to the funding wallet.

allocationActionId
string
required

The 0fns allocation action whose unfilled OrderBook order placement should be cancelled.

Required string length: 1 - 64
Pattern: ^allctn-a-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"allctn-a-04p5n-gkkgd-5qk71nuev5n2ug1t"

externalId
string

An optional external identifier provided by the client to ensure idempotency and prevent duplicate operations.

feeSponsorId
string

Id of the fee sponsor that will pay the network fees for this allocation. When set, allocation transactions are broadcast as sponsored user operations.

Required string length: 1 - 64
Pattern: ^fs-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"fs-5vqdl-gliqk-b4rfukqauov1sp7j"

Response

200 - application/json

Success

The broadcast 0fns order-placement cancellation transaction.

transactionId
string
required

Id of the broadcast on-chain cancelOrder transaction.

Last modified on October 1, 2026