get https://api.opensea.io/v2/offers/collection//traits
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"
},
]
}