---
title: "CoinGecko chains"
method: GET
path: "/coingecko/chains"
tags: ["CoinGecko"]
---

# CoinGecko chains

`GET /coingecko/chains`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/coingecko/chains`
- Auth: API key in header `x-api-key`

Lists blockchains from CoinGecko's chains table, up to `limit` rows (default and max 100), in the `vs_currency` you pick. Each chain has its rank, id, name, URL, logo, top gainers, 24h, 7d and 30d changes, 24h volume, TVL, dominance percent and coin count, where shown.

## Query parameters

- `limit` integer
- `vs_currency` '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'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoChainsResponseDoc
  - `code` integer
  - `data` CoingeckoChainsResponse
    - `chains` CoingeckoChainRow[]: Blockchains, one row per chain.
      - `change_24h_percent` number: Change over the last 24 hours, in percent.
      - `change_30d_percent` number: Change over the last 30 days, in percent.
      - `change_7d_percent` number: Change over the last 7 days, in percent.
      - `coin_count` integer: Number of coins on the chain.
      - `dominance_percent` number: Dominance of the chain in percent, as shown in the chains table.
      - `id` string: CoinGecko chain id. Use it with the chain endpoint.
      - `image_url` string: URL of the chain logo.
      - `name` string: Name of the chain.
      - `rank` integer: Position of the chain in the chains table.
      - `top_gainers` string[]: Names of the best-performing coins on the chain.
      - `tvl` number: Total value locked on the chain.
      - `url` string: Link to the chain page on CoinGecko.
      - `volume_24h` number: Trading volume on the chain over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of chains returned.
    - `source_url` string: URL the data was read from.
    - `vs_currency` string: Currency code from the request's vs_currency parameter.
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
