post https://api.opensea.io/v2/orders//seaport/listings
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
- conduitKey is OpenSea's conduitKey:
0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000 - the provided signature must be valid and signed
- startTime and endTime are in Epoch format
- orderType must be open
- zone is
0x0000000000000000000000000000000000000000 - zoneHash is
0x0000000000000000000000000000000000000000000000000000000000000000
{
"parameters": {
"offerer": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"zone": "0x0000000000000000000000000000000000000000",
"zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"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",
"counter": 0,
},
"signature": "0x",
"protocol_address": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc",
}