Sign in

v1

latestOpenAPI 3.1.02026-07-24130315342.2 KB
Offer Endpoints

Get trait offers for a collection

Get trait offers for a collection. Use the mode parameter to select the bid category.

Single string trait: ?mode=STRING&type=Background&value=Red Multiple string traits: ?mode=MULTI&traits=[{"traitType":"Background","value":"Red"},{"traitType":"Eyes","value":"Blue"}] Numeric trait range: ?mode=NUMERIC&type=Level&min_value=1&max_value=10

Omit filter params to discover all bids of that mode (e.g. ?mode=NUMERIC returns all numeric bids).

If mode is omitted, the mode is inferred from the params for backward compatibility.

get/api/v2/offers/collection/{slug}/traits

Path parameters

slugstring required

Unique string to identify a collection on OpenSea

Query parameters

mode'STRING' | 'NUMERIC' | 'MULTI'

Bid category: STRING (single string trait), MULTI (multiple string traits), or NUMERIC (numeric trait range). If omitted, inferred from params.

typestring

Trait type name

valuestring

Trait value as string

float_valuenumber double

Trait value as float

int_valueinteger

Trait value as integer

min_valuenumber float

Minimum value for numeric trait range queries

max_valuenumber float

Maximum value for numeric trait range queries

traitsstring

JSON array of trait filters for multi-trait queries. Each element has 'traitType' and 'value' fields. Example: [{"traitType":"Background","value":"Red"}]

limitinteger

Number of items to return per page

Example:20

Number of items to return per page

nextstring

Response

OK