# Collections and items

## GET /collections/{slug}

Returns the collection with its contracts per chain, creator earnings configuration, DIVIT configuration (if any) and stats.

## GET /collections/{slug}/items

Query: `chain`, `cursor`, `limit`, `traits` (URL-encoded JSON), `listed` (boolean), `sort` (`price_asc`, `price_desc`, `recent`).

Each item includes `vault`: `{ "homeChain": "ethereum", "activeChain": "base", "state": "mirrored" }` so integrators can tell where the usable copy lives.

## GET /items/{chain}/{contract}/{tokenId}

Full item record: metadata, owner, best listing, best offer, last sale, vault state, labels (`reported`, `disputed_ownership`, `explicit`).

```json
{
  "chain": "base",
  "contract": "0x…",
  "tokenId": "2040",
  "owner": "0x…",
  "vault": { "homeChain": "ethereum", "activeChain": "base", "state": "mirrored" },
  "labels": [],
  "bestListing": { "price": "50000000000000000", "currency": "ETH", "expiresAt": 1790000000 }
}
```