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",
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!