CoinGecko API endpoint
Lists NFT collections in one CoinGecko NFT category, identified by the required `slug` such as `metaverse`. Paged with `page` and `limit` (default and max 100). Each collection has chain, floor price and market cap in native and USD terms, 24h volume, 24h sales, and 24h, 7d and 30d changes.
/coingecko/nft/category/{slug}Returns NFT collection rows from a CoinGecko NFT category page such as /en/nft/categories/metaverse.
Path parameters:
slug: CoinGecko NFT category slug, for example metaverse.Query parameters:
page: page number. Default 1.limit: rows to return. Default 100, max 100.vs_currency: quote currency. Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.Notable response behavior:
collections uses the same normalized collection fields as coingecko-nfts.| Field | Filled in, of 4 checked | Values in the sample |
|---|---|---|
| rank | 4 | 1 to 4, median 2 |
| id | 4 | |
| name | 4 | “Otherside Koda Ethereum” and 3 other values |
| url | 4 | coingecko.com |
| image_url | 4 | assets.coingecko.com |
| floor_price_native | 4 | 0.01 to 0.51, median 0.04 |
| floor_price_usd | 4 | 12.55 to 1,289.76, median 102.81 |
| change_24h_percent | 4 | 0 to 12.6, median 2.5 |
| change_7d_percent | 4 | 3.4 to 9, median 7.9 |
| change_30d_percent | 3 | 17.1 to 23.7, median 22.9 |
| market_cap_usd | 4 | 354,368 to 10,737,231, median 9,357,772 |
| market_cap_native | 4 | 141.1 to 4,287, median 3,730 |
| volume_24h_native | 4 | 0.07 to 4.42, median 0.19 |
| volume_24h_usd | 4 | 175.78 to 11,079.82, median 466.26 |
| sales_24h | 4 | 2 to 20, median 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | CoinGecko NFT category slug such as metaverse | metaverse | |
| page | integer | No | Page number, default 1 | ||
| limit | integer | No | Rows to return, default 100, max 100 | ||
| vs_currency | string | No | Quote currency Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/coingecko/nft/category/metaverse?page=1&limit=10&vs_currency=btc" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "metaverse",
"name": "Metaverse",
"page": 1,
"limit": 100,
"vs_currency": "usd",
"source_url": "https://www.coingecko.com/en/nft/categories/metaverse?page=1",
"fetched_at": "2026-05-24T00:00:00Z",
"collections": [
{
"rank": 1,
"id": "pudgy-penguins",
"name": "Pudgy Penguins",
"chain": "Ethereum",
"floor_price_usd": 38850
}
]
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.nftCategoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.NFTCategoryResponse | No | ||||
| data.collections | array | No | NFT collections in the category on this page. | |||
| data.collections[].chain | string | No | Ethereum | Blockchain the collection lives on, for example `Ethereum`. | ||
| data.collections[].change_24h_percent | number | No | 1.2 | Floor price change over the last 24 hours, in percent. | ||
| data.collections[].change_30d_percent | number | No | 8.9 | Floor price change over the last 30 days, in percent. | ||
| data.collections[].change_7d_percent | number | No | -3.4 | Floor price change over the last 7 days, in percent. | ||
| data.collections[].floor_price_native | number | No | 10.5 | Floor price in the chain's native currency. | ||
| data.collections[].floor_price_usd | number | No | 38850 | Floor price in US dollars. | ||
| data.collections[].id | string | No | pudgy-penguins | CoinGecko NFT collection id. | ||
| data.collections[].image_url | string | No | https://assets.coingecko.com/nft_contracts/images/38/small/pudgy-penguins.png | URL of the collection image. | ||
| data.collections[].market_cap_native | number | No | 105000 | Market capitalisation in the chain's native currency. | ||
| data.collections[].market_cap_usd | number | No | 388500000 | Market capitalisation in US dollars. | ||
| data.collections[].name | string | No | Pudgy Penguins | Name of the NFT collection. | ||
| data.collections[].rank | integer | No | 1 | Position of the collection in the table. | ||
| data.collections[].sales_24h | integer | No | 42 | Number of sales in the last 24 hours. | ||
| data.collections[].url | string | No | https://www.coingecko.com/en/nft/pudgy-penguins | Link to the collection page on CoinGecko. | ||
| data.collections[].volume_24h_native | number | No | 320.4 | Trading volume over the last 24 hours, in the chain's native currency. | ||
| data.collections[].volume_24h_usd | number | No | 1185480 | Trading volume over the last 24 hours, in US dollars. | ||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.limit | integer | No | 100 | Maximum number of collections returned. | ||
| data.name | string | No | Metaverse | NFT category name. | ||
| data.page | integer | No | 1 | Page number returned. | ||
| data.slug | string | No | metaverse | URL slug of the NFT category. | ||
| data.source_url | string | No | https://www.coingecko.com/en/nft/categories/metaverse?page=1 | URL the data was read from. | ||
| data.vs_currency | string | No | usd | Currency code from the request's vs_currency parameter. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/coingecko/nft/category/metaverse?page=1&limit=10&vs_currency=btc" \
-H "x-api-key: $CRAWLORA_API_KEY"