Retrieve trait offers

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 Cool Cat NFT where the type is 'tier' and the value is 'classy_1'.

Below is a response when querying trait offers for Cool Cats where trait type is 'tier' and the value is 'classy_1'.

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

Sample URL
https://testnets-api.opensea.io/v2/offers/collection/cool-cats-nft/traits?type=tier&value=classy_1

Sample Response

{
  "offers": [
    {
      "order_hash": "0xccfca3a3fdca514409c1ec5d2944d63ad7a065d716c1a7edfc6973d3213b2809",
      "chain": "ethereum",
      "criteria": {
        "collection": {
          "slug": "cool-cats-nft"
        },
        "contract": {
          "address": "0x1a92f7381b9f03921564a437210bb9396471050c"
        },
        "trait": {
          "type": "tier",
          "value": "classy_1"
        }
      },
      "protocol_data": {
        "parameters": {
          "offerer": "0xf81e01761184dcbf5e7475ea51e1dc497fdbc6ac",
          "offer": [
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "2160000000000000000",
              "endAmount": "2160000000000000000"
            }
          ],
          "consideration": [
            {
              "itemType": 4,
              "token": "0x1A92f7381B9F03921564a437210bB9396471050C",
              "identifierOrCriteria": "78489588915103748914887863735064371626626351799830551600642111257018368142302",
              "startAmount": "1",
              "endAmount": "1",
              "recipient": "0xF81E01761184dcbF5e7475EA51E1dc497fDBc6ac"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "54000000000000000",
              "endAmount": "54000000000000000",
              "recipient": "0x0000a26b00c1F0DF003000390027140000fAa719"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "108000000000000000",
              "endAmount": "108000000000000000",
              "recipient": "0xD98D29Beb788fF04e7a648775FcB083282aE9C4B"
            }
          ],
          "startTime": "1667318143",
          "endTime": "1667319936",
          "orderType": 2,
          "zone": "0x004C00500000aD104D7DBd00e3ae0A5C00560C00",
          "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "salt": "0x360c6ebe00000000000000000000000000000000000000000476755455c1209a",
          "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "totalOriginalConsiderationItems": 3,
          "counter": 5
        },
        "signature": "0x7edeb157fa4655f8c75aa083cc9d84c1602ba218ce70116f91d7e25757a1a2b703afbd1fdd6a8a9cdd92e3e5c2d0b674011f0c1a7637c8fad67f295785d8b3171b"
      }
    }
  ]
}