Docs menu

CoinGecko API endpoint

CoinGecko Chain API

Returns sections from a CoinGecko chain detail page. Sections are omitted when not present. This endpoint supports the documented `vs_currency` enum.

GETapiKey2 credits/requestCoinGeckocoingecko.chainDetailResponseDoc/coingecko/chains/{id}

Endpoint facts

Method: GET
API path: /coingecko/chains/{id}
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.chainDetailResponseDoc

CoinGecko scraping API Try CoinGecko Chain API in Playground CoinGecko API documentation

How this endpoint behaves

Returns sections from a CoinGecko chain detail page such as /en/chains/ethereum.

Path parameters:

id: CoinGecko chain id, for example ethereum.

Query parameters:

limit: rows per section to return. Default 20, 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:

The response may include coins, collections, and exchanges sections depending on what the upstream page exposes.
Bot blocks, malformed HTML, and non-empty pages with no recognizable sections return a typed upstream error.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/chains/ethereum?limit=20&vs_currency=usd
Items in coins: 10
Fields filled in every checked item: 11
Fields empty in some or all items: 4

Field	Filled in, of 10 checked	Values in the sample
rank	8	3 to 103, median 27
id	10
symbol	10	“USDT” and 9 other values
name	10	“Tether” and 9 other values
url	10	coingecko.com
image_url	10	assets.coingecko.com
price	10	0.05 to 83,046.48, median 1
change_1h_percent	10	0 to 3.2, median 0.1
change_24h_percent	8	0.1 to 7.1, median 0.9
change_7d_percent	8	0 to 61, median 7.1
volume_24h	10	301,304,445 to 62,505,796,680, median 401,136,546
market_cap	10	630,345,367 to 184,071,024,453, median 4,722,759,537
fully_diluted_valuation	10	849,298,916 to 189,534,154,115, median 5,485,110,623
market_cap_fdv_ratio	10	0.7 to 1, median 0.97
change_30d_percent	7	0.9 to 194.1, median 21.5

Request parameters

Parameter	Type	Required	Description	Example
id (path)	string	Yes	CoinGecko chain id such as ethereum	ethereum
limit	integer	No	Rows per section to return, default 20, 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/chains/ethereum?limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "ethereum",
    "name": "Ethereum",
    "limit": 20,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/en/chains/ethereum",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "ethereum",
        "symbol": "ETH",
        "name": "Ethereum",
        "price": 3800
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.chainDetailResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.ChainDetailResponse	No
data.coins	array	No		Coins on the chain.
data.coins[].change_1h_percent	number	No	0.01	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	0.03	Price change over the last 24 hours, in percent.
data.coins[].change_30d_percent	number	No	0.1	Price change over the last 30 days, in percent.
data.coins[].change_7d_percent	number	No	-0.02	Price change over the last 7 days, in percent.
data.coins[].fully_diluted_valuation	number	No	151000000000	Fully diluted valuation.
data.coins[].id	string	No	tether	CoinGecko coin id.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/325/standard/Tether.png	URL of the coin logo.
data.coins[].market_cap	number	No	150000000000	Market capitalisation of the coin.
data.coins[].market_cap_fdv_ratio	number	No	0.99	Market capitalisation divided by fully diluted valuation.
data.coins[].name	string	No	Tether	Name of the coin.
data.coins[].price	number	No	1	Current price of the coin.
data.coins[].rank	integer	No	1	Market cap rank of the coin.
data.coins[].symbol	string	No	USDT	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/tether	Link to the coin page on CoinGecko.
data.coins[].volume_24h	number	No	100000000000	Trading volume over the last 24 hours.
data.collections	array	No		NFT collections on the chain.
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.exchanges	array	No		Decentralised exchanges on the chain.
data.exchanges[].id	string	No	uniswap-v3-ethereum	CoinGecko exchange id.
data.exchanges[].image_url	string	No	https://assets.coingecko.com/markets/images/665/small/uniswap-v3.png	URL of the exchange logo.
data.exchanges[].market_share_percent	number	No	8.5	Share of the chain's exchange volume held by this exchange, in percent.
data.exchanges[].name	string	No	Uniswap V3 (Ethereum)	Name of the exchange.
data.exchanges[].rank	integer	No	1	Position of the exchange in the chain's exchange table.
data.exchanges[].url	string	No	https://www.coingecko.com/en/exchanges/uniswap-v3-ethereum	Link to the exchange page on CoinGecko.
data.exchanges[].volume_24h	number	No	1200000000	Trading volume on the chain over the last 24 hours.
data.exchanges[].volume_24h_text	string	No	$1,200,000,000	24-hour trading volume as CoinGecko displays it, for example `$1,200,000,000`.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.id	string	No	ethereum	CoinGecko chain id.
data.limit	integer	No	20	Maximum number of rows returned per list.
data.name	string	No	Ethereum	Name of the chain.
data.source_url	string	No	https://www.coingecko.com/en/chains/ethereum	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
404	Not Found	#/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/chains/ethereum?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 Coin API documentation CoinGecko Coin Analysis API documentation CoinGecko Exchange API documentation

Open in Playground Back to group

Docs menu

CoinGecko API endpoint

CoinGecko Chain API

Returns sections from a CoinGecko chain detail page. Sections are omitted when not present. This endpoint supports the documented `vs_currency` enum.

GETapiKey2 credits/requestCoinGeckocoingecko.chainDetailResponseDoc/coingecko/chains/{id}

Endpoint facts

Method: GET
API path: /coingecko/chains/{id}
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.chainDetailResponseDoc

CoinGecko scraping API Try CoinGecko Chain API in Playground CoinGecko API documentation

How this endpoint behaves

Returns sections from a CoinGecko chain detail page such as /en/chains/ethereum.

Path parameters:

id: CoinGecko chain id, for example ethereum.

Query parameters:

limit: rows per section to return. Default 20, 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:

The response may include coins, collections, and exchanges sections depending on what the upstream page exposes.
Bot blocks, malformed HTML, and non-empty pages with no recognizable sections return a typed upstream error.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/chains/ethereum?limit=20&vs_currency=usd
Items in coins: 10
Fields filled in every checked item: 11
Fields empty in some or all items: 4

Field	Filled in, of 10 checked	Values in the sample
rank	8	3 to 103, median 27
id	10
symbol	10	“USDT” and 9 other values
name	10	“Tether” and 9 other values
url	10	coingecko.com
image_url	10	assets.coingecko.com
price	10	0.05 to 83,046.48, median 1
change_1h_percent	10	0 to 3.2, median 0.1
change_24h_percent	8	0.1 to 7.1, median 0.9
change_7d_percent	8	0 to 61, median 7.1
volume_24h	10	301,304,445 to 62,505,796,680, median 401,136,546
market_cap	10	630,345,367 to 184,071,024,453, median 4,722,759,537
fully_diluted_valuation	10	849,298,916 to 189,534,154,115, median 5,485,110,623
market_cap_fdv_ratio	10	0.7 to 1, median 0.97
change_30d_percent	7	0.9 to 194.1, median 21.5

Request parameters

Parameter	Type	Required	Description	Example
id (path)	string	Yes	CoinGecko chain id such as ethereum	ethereum
limit	integer	No	Rows per section to return, default 20, 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/chains/ethereum?limit=10&vs_currency=btc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "ethereum",
    "name": "Ethereum",
    "limit": 20,
    "vs_currency": "usd",
    "source_url": "https://www.coingecko.com/en/chains/ethereum",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "ethereum",
        "symbol": "ETH",
        "name": "Ethereum",
        "price": 3800
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.chainDetailResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.ChainDetailResponse	No
data.coins	array	No		Coins on the chain.
data.coins[].change_1h_percent	number	No	0.01	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	0.03	Price change over the last 24 hours, in percent.
data.coins[].change_30d_percent	number	No	0.1	Price change over the last 30 days, in percent.
data.coins[].change_7d_percent	number	No	-0.02	Price change over the last 7 days, in percent.
data.coins[].fully_diluted_valuation	number	No	151000000000	Fully diluted valuation.
data.coins[].id	string	No	tether	CoinGecko coin id.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/325/standard/Tether.png	URL of the coin logo.
data.coins[].market_cap	number	No	150000000000	Market capitalisation of the coin.
data.coins[].market_cap_fdv_ratio	number	No	0.99	Market capitalisation divided by fully diluted valuation.
data.coins[].name	string	No	Tether	Name of the coin.
data.coins[].price	number	No	1	Current price of the coin.
data.coins[].rank	integer	No	1	Market cap rank of the coin.
data.coins[].symbol	string	No	USDT	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/tether	Link to the coin page on CoinGecko.
data.coins[].volume_24h	number	No	100000000000	Trading volume over the last 24 hours.
data.collections	array	No		NFT collections on the chain.
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.exchanges	array	No		Decentralised exchanges on the chain.
data.exchanges[].id	string	No	uniswap-v3-ethereum	CoinGecko exchange id.
data.exchanges[].image_url	string	No	https://assets.coingecko.com/markets/images/665/small/uniswap-v3.png	URL of the exchange logo.
data.exchanges[].market_share_percent	number	No	8.5	Share of the chain's exchange volume held by this exchange, in percent.
data.exchanges[].name	string	No	Uniswap V3 (Ethereum)	Name of the exchange.
data.exchanges[].rank	integer	No	1	Position of the exchange in the chain's exchange table.
data.exchanges[].url	string	No	https://www.coingecko.com/en/exchanges/uniswap-v3-ethereum	Link to the exchange page on CoinGecko.
data.exchanges[].volume_24h	number	No	1200000000	Trading volume on the chain over the last 24 hours.
data.exchanges[].volume_24h_text	string	No	$1,200,000,000	24-hour trading volume as CoinGecko displays it, for example `$1,200,000,000`.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.id	string	No	ethereum	CoinGecko chain id.
data.limit	integer	No	20	Maximum number of rows returned per list.
data.name	string	No	Ethereum	Name of the chain.
data.source_url	string	No	https://www.coingecko.com/en/chains/ethereum	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
404	Not Found	#/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/chains/ethereum?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 Chain 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 Chain 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