OPopensea
Listing Endpoints

Create a listing

Changed on

List a single NFT (ERC721 or ERC1155) for sale on the OpenSea marketplace.

post/api/v2/orders/{chain}/{protocol}/listings

Request

Path parameters

chain'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain' required

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The blockchain on which to filter the results

protocolstring required

Request body

protocol_addressstring required
signaturestring required

Response

Listing created successfully

chainstring required
order_created_atinteger nullable
order_hashstring

Seaport order hash, a 0x-prefixed 32-byte value. Absent on an order that settles through a Solana marketplace program, which has no Seaport identity and carries svm_order instead. Every EVM order has one.

protocolstring

Marketplace protocol a Solana order settles through, which is what tells you which identity shape the order uses. Absent on a Seaport order, whose payload is unchanged. Only orders we can build fulfillment for carry a value here.

protocol_addressstring
remaining_quantityinteger required
status'ACTIVE' | 'INACTIVE' | 'FULFILLED' | 'EXPIRED' | 'CANCELLED' required
typestring required

Example response

{
  "svm_order": {
    "id": "5j7s1QzqC8sT4Kz1oB9dYnUZ4qHnKX6h9YmZ6Zt7Zb3Q:CvhyBLWDcNwMatkNvMYuHALvbG1NzYrGw32dGzREaQKc"
  }
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      removed the enum value b3 from the path request parameter chain

    • breaking

      removed the enum value blast from the path request parameter chain

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the new enum value stablechain to the path request parameter chain

    • info

      added the media type */* for 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 subschema #2 to the / response property anyOf list for the response status