This endpoint is used to create a new listing on the Seaport contract.

📘

Requests to this endpoint require an API key. If you don't have an API key, please request one.

Please refer to the Orders Parameter Model for more type definitions on the order parameters for this endpoint. For more background on what each field is, please see the Seaport Overview

Important notes on constructing programmatic listings:

  • the offer array must have exactly one item, and it must be an ERC721 or ERC1155 token. We do not support listings for multiple assets

  • the consideration array must have exactly two or three items. The items are (in order): the offerer fee, the OpenSea fee, and an optional collection fee

  • the values provided and conduitKey are OpenSea's conduitKey

  • the provided signature must be valid and signed

  • startTime and endTime are in Epoch format

  • for zone, zoneHash the values will differ based on the chain.
    For ethereum
    "zone": "0x004c00500000ad104d7dbd00e3ae0a5c00560c00"
    "zoneHash": "0x3000000000000000000000000000000000000000000000000000000000000000"

For all other chains
"zone": "0x0000000000000000000000000000000000000000"
"zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"

{
    "parameters": {
        "offerer": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
        "zone": "0x004c00500000ad104d7dbd00e3ae0a5c00560c00",
        "zoneHash": "0x3000000000000000000000000000000000000000000000000000000000000000",
        "startTime": "0",
        "endTime": "1656044994000",
        "orderType": 0,
        "offer": [
            {
                "itemType": 2,
                "token": "0x0165878A594ca255338adfa4d48449f69242Eb8F",
                "identifierOrCriteria": "1",
                "startAmount": "1",
                "endAmount": "1",
            },
        ],
        "consideration": [
            {
                "itemType": 0,
                "token": "0x0000000000000000000000000000000000000000",
                "identifierOrCriteria": "0",
                "startAmount": "9750000000000000000",
                "endAmount": "9750000000000000000",
                "recipient": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
            },
            {
                "itemType": 0, 
                "token": "0x0000000000000000000000000000000000000000",
                "identifierOrCriteria": "0",
                "startAmount": "250000000000000000",
                "endAmount": "250000000000000000",
                "recipient": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
            },
            {
                "itemType": 0, 
                "token": "0x0000000000000000000000000000000000000000",
                "identifierOrCriteria": "0",
                "startAmount": "500000000000000000",
                "endAmount": "500000000000000000",
                "recipient": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e",
            },
        ],
        "totalOriginalConsiderationItems": 2,
        "salt": 12686911856931635052326433555881236148,
        "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
        "nonce": 0,
    },
    "signature": "0x",
}
Language
Authentication
Header
Click Try It! to start a request and see the response here!