Build collection and trait offers

This endpoint is used to build collection and trait offers for a specified collection.

What are collection offers?
If you'd like to purchase into a collection but don't have a particular NFT in mind, collection offers allow you to make an offer that applies to all NFTs in a collection.

What are trait offers?
A trait offer is an offer that applies to every item in a collection with the specified trait. For example, this is a filter that shows every Cool Cat NFT where the trait face has value ditto. There is an example payload for building a trait offer below.

Why do I need to use an OpenSea endpoint to build collection / trait offers?
To make an offer apply to all the NFTs in a collection, we encode the list of NFT token IDs into a Merkle Tree. When a seller accepts the offer, we produce a Merkle Proof based on the tree we generated so Seaport can process the sale.

This endpoint returns a partial set of Seaport Order parameters that includes the root of the Merkle Tree as a consideration item's identifierOrCriteria. This needs to be combined with the remaining offer and consideration items (as well as a signature) to be posted.

The endpoint also returns two additional fields zone and zoneHash these must be correctly set so that the order can be posted to the correct chain based on the collection passed to the API.

How do I post the offer after I build it?
You'll take the response, extract the first consideration object, and use it to construct your post offer request.

Here's an example request / response for building collection offers for cool cats. Note that the response field identifierOrCrtieria represents the tradable tokens in the collection.

What is Offer Protection?

Offer protection creators your offer on our Seaport Signed Zone, which is located at 0x000000e7ec00e7b300774b00001314b8610022b8. Offers placed with this enabled will have the protections described here , as well as the ability to cancel the offer without paying gas (when implemented).

📘

Note

identifierOrCrtieria returned as 0 is a valid use case. It means all of the tokens for that collection are tradable.

Sample Request - Collection Offer

{
    "offerer": "0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33",
    "quantity": 1,
    "criteria": {
       "collection": {
         "slug": "cool-cats-nft"
       }
    },
    "protocol_address": "0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC"
}

Sample Response - Collection Offer

{
   "partialParameters":{
      "consideration":[
         {
            "itemType":5,
            "token":"0xcf30aeebf2ef45fbc27e4761e2b842313dfbf99b",
            "identifierOrCriteria":"79069830734946488585064119224435015157296818388916406141082486597836895114187",
            "startAmount":"1",
            "endAmount":"1",
            "recipient":"0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33"
         }
      ],
      "zone":"0x0000000000000000000000000000000000000000",
      "zoneHash":"0x0000000000000000000000000000000000000000000000000000000000000000"
   }
}

Note: do NOT use the sample response data here in a real request - identifierOrCriteria changes frequently

Sample Request - Trait Offer

{
    "offerer": "0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33",
    "quantity": 1,
    "criteria": {
       "collection": {
          "slug": "cool-cats-nft"
       },
      "trait": {
         "type": "face",
         "value": "ditto"
      }
    },
    "protocol_address": "0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC"
}

Sample Response - Trait Offer

{
  "partialParameters": {
    "consideration": [
      {
        "itemType": 4,
        "token": "0x1a92f7381b9f03921564a437210bb9396471050c",
        "identifierOrCriteria": "83542390139989114919637857107326598904522481317194068634099712128926759092936",
        "startAmount": "1",
        "endAmount": "1",
        "recipient": "0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33"
      }
    ],
    "zone":"0x0000000000000000000000000000000000000000",
    "zoneHash":"0x0000000000000000000000000000000000000000000000000000000000000000"
  }
}

Note: do NOT use the sample response data here in a real request - identifierOrCriteria changes frequently

Sample Response - Trait Int Offer

{
    "offerer": "0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33",
    "quantity": 1,
    "criteria": {
        "collection": {
            "slug": "wolf-game-land"
        },
        "trait": {
            "type": "stone",
            "int_value": 340
        }
    }
}

Sample Response - Trait Float Offer

{
    "offerer": "0x3e66Cde97E9Cf2d047f08EE9e2Acc13b1a1Dbc33",
    "quantity": 1,
    "criteria": {
        "collection": {
            "slug": "hedgie"
        },
        "trait": {
            "type": "charm",
            "float_value": 49.547
        }
    }
}