Docs menu

CoinGecko API endpoint

CoinGecko NFTs API

Lists NFT collections from CoinGecko's main NFT table, paged with `page` (default 1) and `limit` (default and max 100). Each collection has rank, name, chain, floor price, market cap and 24h volume in native and USD terms, 24h sales, and 24h, 7d and 30d percentage changes.

GETapiKey2 credits/requestCoinGeckocoingecko.nftsResponseDoc/coingecko/nfts

Endpoint facts

Method: GET
API path: /coingecko/nfts
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.nftsResponseDoc

CoinGecko scraping API Try CoinGecko NFTs API in Playground CoinGecko API documentation

How this endpoint behaves

Returns NFT collection rows from CoinGecko's NFT table at /en/nft?page={page}. This endpoint supports the documented vs_currency enum.

Path parameters: none.

Query parameters:

page optional page number. Defaults to 1.
limit optional rows to return. Defaults to 100; maximum 100.
vs_currency optional 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:

Collection rows include rank, CoinGecko id, name, URL, image URL, chain, floor price native/USD, 24h/7d/30d percentage changes, market cap native/USD, 24h volume native/USD, and 24h sales when present.
Challenge pages, malformed HTML, and pages with zero parsed NFT collection rows return an upstream error.

Live monitoring

Monitored request: GET /coingecko/nfts?limit=3&vs_currency=usd
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/nfts?limit=20&vs_currency=usd
Items in collections: 20
Fields filled in every checked item: 10
Fields empty in some or all items: 5

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
name	20	“CryptoPunks Ethereum” and 19 other values
url	20	coingecko.com
image_url	20	assets.coingecko.com
floor_price_native	19	0.02 to 87, median 1.4
floor_price_usd	20	171.85 to 218,876, median 2,993.57
change_24h_percent	20	0 to 22.6, median 0.8
change_7d_percent	17	1 to 28.2, median 9.2
change_30d_percent	17	1.8 to 65, median 20.1
market_cap_usd	20	11,150,014 to 786,725,598, median 28,508,188
market_cap_native	19	231.8 to 312,712, median 14,246
volume_24h_native	19	0 to 209.32, median 7.06
volume_24h_usd	20	0 to 526,616, median 8,100.92
sales_24h	20	1 to 146, median 5

Request parameters

Parameter	Type	Required	Description
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 example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/nfts?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "limit": 100,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/en/nft?page=1",
    "fetched_at": "2026-05-24T00:00:00Z",
    "collections": [
      {
        "rank": 1,
        "id": "pudgy-penguins",
        "name": "Pudgy Penguins",
        "url": "https://www.coingecko.com/en/nft/pudgy-penguins",
        "image_url": "https://assets.coingecko.com/nft_contracts/images/38/small/pudgy-penguins.png",
        "chain": "Ethereum",
        "floor_price_native": 10.5,
        "floor_price_usd": 38850,
        "change_24h_percent": 1.2,
        "change_7d_percent": -3.4,
        "change_30d_percent": 8.9,
        "market_cap_usd": 388500000,
        "market_cap_native": 105000,
        "volume_24h_native": 320.4,
        "volume_24h_usd": 1185480,
        "sales_24h": 42
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.nftsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.NFTsResponse	No
data.collections	array	No		NFT collections on this page, one row per collection.
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.page	integer	No	1	Page number returned.
data.source_url	string	No	https://www.coingecko.com/en/nft?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

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/nfts?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More CoinGecko endpoint docs CoinGecko scraping API CoinGecko categories API documentation CoinGecko Category Coins API documentation CoinGecko chains API documentation CoinGecko Chain API documentation CoinGecko Coin API documentation CoinGecko Coin Analysis API documentation

Open in Playground Back to group

Docs menu

CoinGecko API endpoint

CoinGecko NFTs API

GETapiKey2 credits/requestCoinGeckocoingecko.nftsResponseDoc/coingecko/nfts

Endpoint facts

Method: GET
API path: /coingecko/nfts
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.nftsResponseDoc

CoinGecko scraping API Try CoinGecko NFTs API in Playground CoinGecko API documentation

How this endpoint behaves

Returns NFT collection rows from CoinGecko's NFT table at /en/nft?page={page}. This endpoint supports the documented vs_currency enum.

Path parameters: none.

Query parameters:

page optional page number. Defaults to 1.
limit optional rows to return. Defaults to 100; maximum 100.
vs_currency optional 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:

Collection rows include rank, CoinGecko id, name, URL, image URL, chain, floor price native/USD, 24h/7d/30d percentage changes, market cap native/USD, 24h volume native/USD, and 24h sales when present.
Challenge pages, malformed HTML, and pages with zero parsed NFT collection rows return an upstream error.

Live monitoring

Monitored request: GET /coingecko/nfts?limit=3&vs_currency=usd
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/nfts?limit=20&vs_currency=usd
Items in collections: 20
Fields filled in every checked item: 10
Fields empty in some or all items: 5

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
name	20	“CryptoPunks Ethereum” and 19 other values
url	20	coingecko.com
image_url	20	assets.coingecko.com
floor_price_native	19	0.02 to 87, median 1.4
floor_price_usd	20	171.85 to 218,876, median 2,993.57
change_24h_percent	20	0 to 22.6, median 0.8
change_7d_percent	17	1 to 28.2, median 9.2
change_30d_percent	17	1.8 to 65, median 20.1
market_cap_usd	20	11,150,014 to 786,725,598, median 28,508,188
market_cap_native	19	231.8 to 312,712, median 14,246
volume_24h_native	19	0 to 209.32, median 7.06
volume_24h_usd	20	0 to 526,616, median 8,100.92
sales_24h	20	1 to 146, median 5

Request parameters

Parameter	Type	Required	Description
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 example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/nfts?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "limit": 100,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/en/nft?page=1",
    "fetched_at": "2026-05-24T00:00:00Z",
    "collections": [
      {
        "rank": 1,
        "id": "pudgy-penguins",
        "name": "Pudgy Penguins",
        "url": "https://www.coingecko.com/en/nft/pudgy-penguins",
        "image_url": "https://assets.coingecko.com/nft_contracts/images/38/small/pudgy-penguins.png",
        "chain": "Ethereum",
        "floor_price_native": 10.5,
        "floor_price_usd": 38850,
        "change_24h_percent": 1.2,
        "change_7d_percent": -3.4,
        "change_30d_percent": 8.9,
        "market_cap_usd": 388500000,
        "market_cap_native": 105000,
        "volume_24h_native": 320.4,
        "volume_24h_usd": 1185480,
        "sales_24h": 42
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.nftsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.NFTsResponse	No
data.collections	array	No		NFT collections on this page, one row per collection.
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.page	integer	No	1	Page number returned.
data.source_url	string	No	https://www.coingecko.com/en/nft?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

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/nfts?page=1&limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

CoinGecko NFTs API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

CoinGecko NFTs API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related