Build mint transaction data for a drop

Returns ready-to-sign transaction data for minting tokens from a drop. The caller is responsible for signing and submitting the transaction. No wallet authentication is required, only an API key. The minter address in the request body determines who will receive the tokens. The transaction is built for the stage whose window contains the current time, and the response names it in stage_uuid, stage_type, stage_start_time and stage_end_time.

Supports ERC-721 SeaDrop V1 and ERC-1155 SeaDrop V2 drops. An ERC-1155 drop mints one token per request, named by token_id; an ERC-721 drop assigns token IDs onchain, so token_id must be omitted. Minting an ERC-1155 token while an allowlist (signed presale) stage is live on the drop, or from a paid stage priced in an ERC-20 token, is not yet supported and returns 400 with code UNSUPPORTED_DROP_TYPE.

Error bodies for the drop, stage and minter conditions below carry a stable code alongside errors. Branch on code, not on the message text.

A 422 means the drop is mintable but this mint is not: the minter is not on the active presale's allowlist (the message names the stage and, when the drop has a public stage, when it opens), the quantity is over the wallet's limit or the remaining supply (the message says how many remain), the minter cannot pay the price and gas, or the active stage has a price and the drop has no creator payout address, so every paid mint would revert until the creator sets one, or the active stage is paid and its OpenSea fee is below the drop's minimum, so OpenSea will not build the mint until the creator corrects the fee (STAGE_FEE_BELOW_FLOOR). GET /api/v2/drops/{slug} still shows such a stage as live.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The collection slug identifying the drop

Body Params

Mint request parameters

string
required
length ≥ 1

Wallet address that will receive the minted tokens

int32
required
1 to 100

Number of tokens to mint

boolean
Defaults to false

Skip checking that the minter holds enough of the chain's native token for the price and gas. The transaction is the same either way; set this to build a mint for a wallet you will fund before submitting it. An underfunded transaction then fails when submitted instead of returning 422 here.

string

Token ID to mint. Required for an ERC-1155 drop, where each token is minted separately, and refused for an ERC-721 drop, whose token IDs are assigned onchain at mint.

Responses

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*