OPopensea
Offer Endpoints

Get trait offers for a collection

Changed on

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

Request

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
nextstring

Response

OK

nextstring nullable

Example response

{
  "offers": [
    {
      "svm_order": {
        "id": "5j7s1QzqC8sT4Kz1oB9dYnUZ4qHnKX6h9YmZ6Zt7Zb3Q:CvhyBLWDcNwMatkNvMYuHALvbG1NzYrGw32dGzREaQKc"
      }
    }
  ]
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the /// response's property type changed from object to no type for status

    • breaking

      the /// response's property type changed from object to no type for status

    • breaking

      removed the required property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status