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

# CoinGecko markets

`GET /coingecko/markets`

## Request

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

Returns cryptocurrency market rows from CoinGecko. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.

## Query parameters

- `page` integer
- `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

- CoingeckoMarketsResponseDoc
  - `code` integer
  - `data` CoingeckoMarketsResponse
    - `coins` CoingeckoMarketCoin[]: Coins on this page of the market table, ordered by market cap rank.
      - `change_1h_percent` number: Price change over the last hour, in percent.
      - `change_24h_percent` number: Price change over the last 24 hours, in percent.
      - `change_7d_percent` number: Price change over the last 7 days, in percent.
      - `id` string: CoinGecko coin id. Use it with the coin endpoint.
      - `image_url` string: URL of the coin logo.
      - `market_cap` number: Market capitalisation of the coin.
      - `name` string: Name of the coin.
      - `price` number: Current price of the coin.
      - `rank` integer: Market cap rank of the coin.
      - `symbol` string: Ticker symbol of the coin.
      - `url` string: Link to the coin page on CoinGecko.
      - `volume_24h` number: Trading volume over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of coins returned.
    - `page` integer: Page number 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
- `404`: Not Found
- `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)