API Endpoints
OpenSea

Get trait offers for a collection

get
https://api.opensea.io/api/v2/offers/collection//traits

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique string to identify a collection on OpenSea

Query Params
string
enum

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

Allowed:
string

Trait type name

string

Trait value as string

double

Trait value as float

int32

Trait value as integer

float

Minimum value for numeric trait range queries

float

Maximum value for numeric trait range queries

string

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

int32
1 to 200

Number of items to return per page

string
Responses

400

For error reasons, review the response data.

404

Resource not found

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Updated 3 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*

Updated 3 months ago