Collections

Browse

GET /v1/collections

Cursor-paginated, with summary stats. EXC-launched collections rank first.

Parameter	Type	Default
`chain`	enum	—	`solana`, `ethereum`, `polygon`, `base`, `ink`, `apechain`, `abstract`
`sort`	enum	`volume`	`volume`, `floor`, `recent`
`limit`	integer	`25`
`cursor`	string	—	From `pagination.nextCursor`

curl "https://exclusivo.one/v1/collections?chain=base&sort=floor&limit=10"

Errors: 400, 429, 502.

One collection

GET /v1/collections/{id}

Identity comes from the stored record; stats are merged from two sources, each timed out independently. You get floor in the chain’s native currency, volume, supply, owners and listed count. This one never returns 502. A failing source degrades the response — null fields, and stale: true only when both sources fail. Errors: 404, 429.

This is where you get a case-preserved contractAddress. Never derive an address by slicing a collectionId — that value is lowercased for every chain, which breaks Solana base58.

Floor

GET /v1/collections/{id}/floor

Returns two floors, because they answer different questions:


`askFloor`	The cheapest seller ask
`buyerFloor`	What a buyer actually pays for the cheapest fill, across EXC and outside marketplaces

They aren’t interchangeable. If you’re showing a buyer “the floor”, buyerFloor is the honest number. If you’re comparing against another aggregator’s floor, askFloor is usually the like-for-like one. stale: true marks a last-known-good buyerFloor, and only happens on Solana and Ethereum. Never returns 502 — a total failure comes back as null floors with a 200. Returns 404 when the id doesn’t resolve, or resolves to something with no usable chain.

Don’t trust stored supply and floor

Indexed collection records carry totalSupply and floorPrice fields that go stale quickly. We don’t render them and neither should you — use the floor endpoint, and treat supply from a collection record as indicative.

Putting it together

const base = 'https://exclusivo.one/v1';

// 1. Browse
const list = await fetch(`${base}/collections?chain=solana&limit=5`).then(r => r.json());
const id = list.data[0].collectionId;

// 2. Detail — where the real, case-preserved address lives
const detail = await fetch(`${base}/collections/${id}`).then(r => r.json());
const address = detail.data.contractAddress;   // not id.split('_')[1]

// 3. Floor
const floor = await fetch(`${base}/collections/${id}/floor`).then(r => r.json());
console.log(floor.data.askFloor?.decimal, floor.data.buyerFloor?.decimal);

Overview

Store API

Marketplace API

Collections

Browse

One collection

Floor

Don’t trust stored supply and floor

Putting it together

​Browse

​One collection

​Floor

​Don’t trust stored supply and floor

​Putting it together

​Related

Browse

One collection

Floor

Don’t trust stored supply and floor

Putting it together

Related