---
title: "CoinGecko global market snapshot"
method: GET
path: "/coingecko/global"
tags: ["CoinGecko"]
---

# CoinGecko global market snapshot

`GET /coingecko/global`

## Request

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

Returns CoinGecko's global crypto market snapshot: total market cap in USD with its 24-hour and 1-year change, Bitcoin market cap, Bitcoin and Ethereum dominance, stablecoin market cap and share, and the number of coins, exchanges and categories tracked. Takes no parameters.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoGlobalResponseDoc
  - `code` integer
  - `data` CoingeckoGlobalResponse
    - `bitcoin_dominance_percent` number: Bitcoin share of the total crypto market capitalisation, in percent.
    - `bitcoin_market_cap_usd` number: Bitcoin market capitalisation, in US dollars.
    - `categories_tracked` integer: Number of categories CoinGecko tracks.
    - `coins_tracked` integer: Number of coins CoinGecko tracks.
    - `ethereum_dominance_percent` number: Ethereum share of the total crypto market capitalisation, in percent.
    - `exchanges_tracked` integer: Number of exchanges CoinGecko tracks.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `market_cap_change_1y_percent` number: Change in total market capitalisation over the last year, in percent.
    - `market_cap_change_24h_percent` number: Change in total market capitalisation over the last 24 hours, in percent.
    - `market_cap_usd` number: Total crypto market capitalisation, in US dollars.
    - `source_url` string: URL the data was read from.
    - `stablecoin_market_cap_usd` number: Combined stablecoin market capitalisation, in US dollars.
    - `stablecoin_share_percent` number: Stablecoin share of the total crypto market capitalisation, in percent.
  - `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/afac9b012a27?raw)