Skip to main content
POST
Cancel orders in batch

Authorizations

x-definitive-api-key
string
header
default:dpka_513a2bd7_57a2_46d2_927b_2a3857fe271b
required

Your Definitive API key.

Body

application/json
orderIds
string[]
required

1–25 order ids to cancel, as lowercase hyphenated UUIDs, in the same order as the lines of cancelMessage. Duplicates are rejected.

Required array length: 1 - 25 elements
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
cancelMessage
string
required

UTF-8 plaintext the funder wallet signed. Format: "Definitive Flash v1 — Cancel Orders\nOrders:\n\n..." — one lowercase UUID per line in orderIds order, no trailing newline. Same bytes across EVM and SVM.

Minimum string length: 1
userSignature
string
required

Funder wallet signature over cancelMessage. Accepts 0x-prefixed hex (EVM convention) or base58 (Solana convention). EVM: 65 bytes from EIP-191 personal_sign. SVM: 64 bytes from Ed25519.

Minimum string length: 1

Response

Per-order results, in request order

results
object[]
required

One result per requested order id, in request order.