Skip to main content
POST
Scope: nft:orders · Rate limit: 30 a minute One order buys 1-10 packs of one kind for one wallet, paid with one payment. The response has the order and how to pay it (Payments). The pack opens and the NFT mints once the payment settles. Follow it with Get an order or the nft_order.updated webhook. A refused order creates nothing. There is no limit on how much a wallet buys.
Always send an Idempotency-Key, and reuse it when retrying the same order. See Idempotency.
string
required
Your own order id: 8-128 characters of A-Za-z0-9_-, one per order. It becomes the order’s order_id.
string
required
A pack_type from List packs.
string
default:"pokemon"
As for List packs.
string
standard, hot, chill or classic: one the pack sells. Default: the pack’s default_odds. See Odds.
integer
default:"1"
1-10 packs. 2 or more makes a multi-pack order.
string
required
The customer’s self-custody wallet on your mint chain. Never an exchange deposit address: the NFTs are minted to it.
string
An EVM wallet that can receive USDC on Base, for refunds. Defaults to recipient on an EVM program. Required when you mint on Solana.
string
Your opaque user id (A-Z a-z 0-9 _ . : -, up to 128). Never put personal data here.

Response

201 (200 with "idempotent_replay": true on a replay).
object
The order, as Get an order returns it. A multi-pack order has quantity, unit_price, price (the total) and units.
object
intent_id, client_secret, publishable_key, amount and deposit_addresses. See Payments. Once the order is past awaiting_payment, a replay’s payment has no client_secret and no deposit addresses: there is nothing left to pay.
boolean
Present and true on a replay.
If the chosen odds stop selling before the payment settles, the pack isn’t opened at other odds: the order goes to refund_due and the customer is refunded.

Errors