This endpoint is used to get all trait offers for a specified 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 Doodle NFT where the type is 'hair' and the value is 'wizard'.

Below is a response when querying trait offers for Doodles where trait type is 'hair' and the value is 'wizard'.

Note: this example query might not return any data if there are no open offers for that trait.

Sample URL
https://api.opensea.io/v2/offers/collection/doodles-official/traits?type=hair&value=wizard

Sample Response

{
  "offers": [
    {
      "order_hash": "0x3c311f70687288c0d7fded13e2ca3c1c0612eee76540d596d9efddf3f63dfdd5",
      "chain": "ethereum",
      "criteria": {
        "collection": {
          "slug": "doodles-official"
        },
        "contract": {
          "address": "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e"
        },
        "trait": {
          "type": "hair",
          "value": "wizard"
        },
        "encoded_token_ids": "67,192,235,526,583,639:640,698,789,823,837,1236,1295,1348,1476,1684,1794,2052,2067,2283,2369,2399,2662,2680,2720,2823,2840,2989,3675,3964,4089,4118,4133,4184,4238,4506,4792,4931,4997,5399,5517,5537,5826,6352,6604,6638,6736,6832,7020,7084,7141,7383,7403,7486,7633,7738,7881,8257,8311,8383,8451,8496,8690,8717,8768,8791,8869,9080,9529,9542,9837,9916,9953"
      },
      "protocol_data": {
        "parameters": {
          "offerer": "0x81b3f3a8dace9e13fcea4d931a7db4547b97a010",
          "offer": [
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "1662500000000000000",
              "endAmount": "1662500000000000000"
            }
          ],
          "consideration": [
            {
              "itemType": 4,
              "token": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
              "identifierOrCriteria": "71558999501793611500611652936054656912085209937680706304972004588114932517583",
              "startAmount": "1",
              "endAmount": "1",
              "recipient": "0x81b3f3a8dAcE9e13fcea4d931a7DB4547b97a010"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "8312500000000000",
              "endAmount": "8312500000000000",
              "recipient": "0xd1F124cc900624e1ff2d923180b3924147364380"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "41562500000000000",
              "endAmount": "41562500000000000",
              "recipient": "0x0000a26b00c1F0DF003000390027140000fAa719"
            }
          ],
          "startTime": "1690474465",
          "endTime": "1690475064",
          "orderType": 2,
          "zone": "0x000000e7Ec00e7B300774b00001314B8610022b8",
          "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "salt": "0x34fa3c0aedbe9308",
          "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "totalOriginalConsiderationItems": 3,
          "counter": 0
        },
        "signature": null
      },
      "protocol_address": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc"
    },
  ]
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!