OPopensea
Drops Endpoints

Build mint transaction data for a drop

Changed on

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 drops only; an ERC-1155 drop returns 400.

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 public stage 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.

post/api/v2/drops/{slug}/mint

Request

Path parameters

slugstring required

The collection slug identifying the drop

Request body

minterstring required

Wallet address that will receive the minted tokens

quantityinteger required

Number of tokens to mint

Example request

{
  "minter": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "quantity": 1
}

Response

Ready-to-sign transaction data including target contract, calldata, and value

chainstring required

Chain identifier

datastring required

Encoded transaction data (hex)

stage_end_timestring

End time of that stage (ISO 8601)

stage_start_timestring

Start time of that stage (ISO 8601)

stage_typestring

Type of that stage, as in the drop's stages

stage_uuidstring

The stage this transaction was built for. It matches a uuid in the drop's stages from GET /api/v2/drops/{slug}, unless the stage is hidden: hidden stages can be minted but are not listed there. A presale transaction carries this stage's start and end times in its signed parameters and reverts if mined outside them. Absent only if the stage could not be determined.

tostring required

Transaction target contract address

valuestring required

Native currency to send with the transaction, in wei, as a decimal string (not hex)

Example response

{
  "stage_type": "public_sale",
  "stage_uuid": "5f0c6f7e2b8a4c1d9e3f6a7b8c9d0e1f",
  "value": "10000000000000000"
}

Changes

  • 2c7935d84f90Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status