---
title: "CoinGecko global chart series"
method: GET
path: "/coingecko/global/charts"
tags: ["CoinGecko"]
---

# CoinGecko global chart series

`GET /coingecko/global/charts`

## Request

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

Returns a time series for one global crypto metric from CoinGecko: total market cap (default), Bitcoin dominance, altcoin market cap or DeFi market cap. Choose a `range` from `24h` to `max` (default `90d`) and cap points per series with `limit` (default 120, max 500). Each point has a timestamp, datetime and value.

## Query parameters

- `kind` 'total_market_cap' | 'bitcoin_dominance' | 'altcoin_market_cap' | 'defi_market_cap'
- `range` '24h' | '7d' | '14d' | '30d' | '90d' | '1y' | 'max'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoGlobalChartsResponseDoc
  - `code` integer
  - `data` CoingeckoGlobalChartsResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `kind` string: Chart returned: `total_market_cap`, `bitcoin_dominance`, `altcoin_market_cap` or `defi_market_cap`.
    - `limit` integer: Maximum number of points returned per series.
    - `range` string: Time range covered: `24h`, `7d`, `14d`, `30d`, `90d`, `1y` or `max`.
    - `series` CoingeckoGlobalChartSeries[]: Data series of the chart.
      - `name` string: Name of the data series.
      - `points` CoingeckoGlobalChartPoint[]: Time-ordered points of the series.
        - `datetime` string: Time of the point, in UTC (RFC 3339).
        - `timestamp` integer: Time of the point, in Unix milliseconds.
        - `value` number: Value of the series at that time.
    - `source_url` string: URL the data was read from.
  - `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/028417aa35bb?raw)