---
title: "Get trait offers for a collection"
method: GET
path: "/api/v2/offers/collection/{slug}/traits"
tags: ["Offer Endpoints"]
---

# Get trait offers for a collection

`GET /api/v2/offers/collection/{slug}/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.

## Path parameters

- `slug` string, required

## Query parameters

- `mode` 'STRING' | 'NUMERIC' | 'MULTI'
- `type` string
- `value` string
- `float_value` number, double
- `int_value` integer
- `min_value` number, float
- `max_value` number, float
- `traits` string
- `limit` integer — Number of items to return per page
- `next` string

## Response `200`

OK

## Other responses

- `400` — For error reasons, review the response data.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found
- `409` — Conflict
- `500` — Internal server error. Please open a support ticket so OpenSea can investigate.

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) · [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opensea/opensea-api/revisions/acee8835f2ae/schema)