This endpoint is used to create a new offer 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 offers:

  • the offer array must have exactly one item, and it must be a currency. We do not support offering multiple currencies.
  • the consideration array must have exactly two or three items. The items are (in order): the asset (nft), 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": 0,
	            "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
	            "identifierOrCriteria": "0",
	            "startAmount": "10000000000000000000",
	            "endAmount": "10000000000000000000",
	        },
	    ],
	    "consideration": [
			{
	            "itemType": 2,
	            "token": "0x0165878A594ca255338adfa4d48449f69242Eb8F",
	            "identifierOrCriteria": "1",
	            "startAmount": "1",
	            "endAmount": "1",
				"recipient": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
	        },
	        {
	            "itemType": 0,
	            "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
	            "identifierOrCriteria": "0",
	            "startAmount": "250000000000000000",
	            "endAmount": "250000000000000000",
	            "recipient": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
	        },
	        {
	            "itemType": 0, 
	            "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
	            "identifierOrCriteria": "0",
	            "startAmount": "500000000000000000", # Collection Fee
	            "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!