# CoinGecko Markets API Documentation

<p><strong>CoinGecko Markets API Documentation</strong> List trading pairs for one lowercase coin id. Each pair has the exchange, pair, price with currency, 24h volume with its unit and last update. EUR, GBP and BTC values use a shared daily conversion rate from the USD quote. Pass the id from listings or search. Filter by page (1 to 100) and per_page (1 to 250). An empty answer and every failed request cost no credit. Cost: 1 credit per successful request. Scrappa is an independent service and is not affiliated with or endorsed by CoinGecko.</p>

- **Documentation:** [https://scrappa.co/docs/coingecko-api/coingecko_markets](https://scrappa.co/docs/coingecko-api/coingecko_markets)
- **API group:** CoinGecko API
- **Endpoint:** `GET https://scrappa.co/api/coingecko/markets`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Lowercase CoinGecko id, e.g. bitcoin. |
| `page` | integer | No | Page number, 1 to 100. An upstream page holds up to 100 pairs |
| `currency` | string | No | Quote currency: USD (default), EUR, GBP or BTC. Other values return 422. |

## Example response

```json
{
    "data": {
        "id": "bitcoin",
        "markets": [
            {
                "pair": "BTC/USDT",
                "price": 67000.5,
                "currency": "USD",
                "exchange": "Binance",
                "volume_24h": 1200000000,
                "last_updated": "2026-11-16T20:00:00+00:00",
                "volume_currency": "USD"
            }
        ],
        "pagination": {
            "page": 1,
            "total": 300,
            "has_more": true,
            "per_page": 100,
            "total_pages": 3
        }
    },
    "meta": {
        "source": "coingecko",
        "credits": 1,
        "billable": true,
        "endpoint_family": "markets"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The upstream data is temporarily unavailable. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
