Drops Endpoints

Build transaction data for creating a SelfMint drop item

Changed on

Creates one item on an ERC-1155 self-mint drop and returns the ready-to-sign transaction that puts it onchain. Any other drop type returns 400.

An ERC-1155 self-mint drop has no stages, publish step, or public mint. Each item is its own token id: saving one returns a transaction that creates it and mints its whole supply to the contract owner. The transaction's to is the drop's configurer contract (the one its getConfigurer() returns), not the drop contract, and it must be sent from from, the contract owner.

Get media_token from POST /api/v2/drops/{slug}/items/media and upload the file to the returned storage context first. The item is stored and its token id assigned (token_id in the response) before this returns, so calling again creates another item rather than retrying this one; the token is minted only when the transaction confirms.

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

Request

Path parameters

slugstring required

Collection slug

Request body

animation_urlstring nullable

Animated media for the item, alongside its image. Blank is treated as no animation, the same as omitting the field.

descriptionstring nullable

Item description

external_urlstring nullable

External URL

media_tokenstring required

Media token reference

namestring required

Item name

supplystring required

Item supply as a decimal string

Response

Ready-to-sign transaction data

chainstring required

Chain identifier

datastring required

Encoded transaction data (hex)

fromstring required

Address the transaction must be sent from: the contract's onchain owner. Sent from any other address it reverts.

tostring required

Transaction target contract address

token_idstring required

Token id of the item. On a create it is the id OpenSea assigned; the item mints under it once the transaction is mined.

valuestring required

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

Example response

{
  "token_id": "1",
  "value": "0"
}

Changes

    • info

      added the new optional request property

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      added the media type */* for the response with the status

    • 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 required property to the response with the status

    • info

      added the required property to the response with the status