# NFT Collections API
> Live NFT collection market data — no key, nothing cached. For any collection it returns the numbers that matter: the floor price in both the chain's native currency and US dollars, the 24-hour floor change, the collection market cap, the 24-hour trading volume and its change, the number of unique owners and the total supply, plus the contract address, the chain and the project's links — Pudgy Penguins floors around 4.3 ETH with thousands of unique owners and a market cap in the tens of millions. The list endpoint pages through the collections that are tracked, and the search endpoint finds a collection by name. It spans every chain NFTs are indexed on — Ethereum, Solana, Polygon and more. This is the collection-floor-and-volume layer for any NFT marketplace, wallet, portfolio or analytics app. Live, served from the public CoinGecko feed, nothing stored. Distinct from token-price and single-chain APIs — this is NFT collection floor prices, market caps and volumes. 4 endpoints.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nft-api/..."
```

## Pricing
- **Free** (Free) — 10,800 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 128,000 calls/Mo, 8 req/s
- **Pro** ($25/Mo) — 615,000 calls/Mo, 15 req/s
- **Scale** ($59/Mo) — 3,080,000 calls/Mo, 30 req/s

## Endpoints

### NFT

#### `GET /v1/collection` — A collection's market data

**Parameters:**
- `id` (query, required, string) — Collection id Example: `pudgy-penguins`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nft-api/v1/collection?id=pudgy-penguins"
```

#### `GET /v1/list` — Paged list of collections

**Parameters:**
- `page` (query, optional, string) — Page number (default 1) Example: `1`
- `per_page` (query, optional, string) — Per page (default 50, max 100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nft-api/v1/list?page=1&per_page=50"
```

#### `GET /v1/search` — Search collections by name

**Parameters:**
- `q` (query, required, string) — Search query Example: `penguin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nft-api/v1/search?q=penguin"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "penguin",
        "collections": [
            {
                "id": "pudgy-penguins",
                "name": "Pudgy Penguins",
                "thumb": "https://coin-images.coingecko.com/nft_contracts/images/38/thumb/pudgy.jpg",
                "symbol": "PPG"
            },
            {
                "id": "cozy-penguins-nft",
                "name": "Cozy Penguin",
                "thumb": "https://coin-images.coingecko.com/nft_contracts/images/3786/thumb/cozy-penguins-nft.",
                "symbol": "CZPG"
            },
            {
                "id": "pesky-penguins",
                "name": "Pesky Penguins",
                "thumb": "https://coin-images.coingecko.com/nft_contracts/images/15264/thumb/pesky-penguins.png",
                "symbol": "PESKY-PENGUINS"
            },
            {
                "id": "penguin-on-abstract",
                "name": "Penguin On Abstract",
                "thumb": "missing_thumb.png",
                "symbol": "PENG"
            },
            {
                "id": "the-penguin-squad",
                "name": "The Penguin Squad",
                "thumb": "https://coin-images.coingecko.com/nft_contracts/images/1522/thumb/the-penguin-squad.png",
                "symbol": "TPS"
            },
            {
                "id": "gay-penguins",
                "name": "Gay Penguins",
                "thumb": "https://coin-images.coingecko.com/nft_contracts/images/1
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nft-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "CoinGecko public NFT API (live)",
        "service": "nft-api",
        "endpoints": {
            "GET /v1/list": "Paged list of tracked collections (page=1, per_page up to 100).",
            "GET /v1/meta": "This document.",
            "GET /v1/search": "Search collections by name (q=penguin).",
            "GET /v1/collection": "A collection's market data (id=pudgy-penguins): floor, market cap, volume, owners, supply."
        },
        "description": "Live NFT collection market data from CoinGecko: for any collection, the floor price in native currency and USD, the 24h floor change, market cap, 24h volume and its change, unique owners, total supply, contract address, chain and project links; a paged list of tracked collections; and search by name. Across every chain CoinGecko indexes NFTs on. Live, no key, nothing stored. Distinct from token-price and single-chain APIs — this is NFT collection floor prices, market caps and volumes.",
        "upstream_status": null
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:25.941Z",
        "request_id": "d5d90398-95ad-4cff-b2dd-60fffb829afa"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/nft-api
OpenAPI spec: https://www.oanor.com/api/nft-api/openapi.json