POST
/v1/studio/drop/{slug}/mint
Mint from a drop
AuthNone — works without a key
Payload
POST
https://api.xrpl.to/v1/studio/drop/fuzzybears/mint| Path parameter | Value | Description |
|---|---|---|
| slug | A collection slug, or its identity as issuer:taxon |
Body
Body fieldsas documented
{ wallet, quantity, payment_hash?, use_balance?, async?, claim_code? }
curl -X POST 'https://api.xrpl.to/v1/studio/drop/fuzzybears/mint'
No public sample for this one — copy the code and fill in your own values.
Response
No public sample for this endpoint — run the code on the right with your own values to see the response.
Shapeas documented
{ results[{ nftoken_id, offer_id, uri }], delivered, credit_drops, balance_drops, remaining }
What it does
Mint from a drop
- Notes
- A drop waiting for review mints nothing (403, "Minting opens once this drop passes review"), nor one refused (403, with why), here or in a Batch. A drop priced in a token is not minted here, nor an edition (each copy pays its fee in the purchase): buy it in one transaction (POST /studio/drop/{slug}/batch). A payment made inside a Batch is refused here, as wherever a payment is checked: it paid for what that Batch settled. After the sale's end (mint_end) a payment made before it still mints, as it would have then; one made after it mints nothing (403) and stays on the wallet's balance for the creator to refund. Every payment to the creator counts toward this wallet's balance on the drop, in full and once, and a mint spends from that balance: pay short and the answer is 402 with balance_drops and due_drops (the NFTs stay held: pay the rest, then send that payment_hash); pay more and the rest stays for the next mint; use_balance: true mints from it with no new payment. A price check (no payment_hash, no use_balance) holds what it prices for 3 minutes and answers 402 with total_drops and due_drops (total less the balance), or 403 saying why the wallet cannot mint now (not open yet, the whitelist's turn, paused); it holds nothing for a wallet that is not on the ledger or cannot pay due_drops. Asking again for another quantity replaces the hold. A payment hash counts once whatever its letter case. Past the wallet's limit (429) or after the last NFT (410) a payment stays on the balance for the creator to refund. A payment sent to minter_address by mistake (no destination tag) is refused and sent back. Each NFT is offered to wallet for 0: accept the offers; the price of one not delivered goes back on the balance. async: true answers 202 with a jobId (GET /studio/upload/job/{id}).
No key. Payments on the ledger pay for what costs money; a hidden drop's art stays off IPFS until its reveal. Open the NFT studio →