# CoinGecko Coin API Documentation

<p><strong>CoinGecko Coin API Documentation</strong> Read full detail for one coin. Pass the lowercase id from listings or search. The answer has price with currency, platforms and token contract addresses, categories, links, ATH and ATL with dates, and supply. Use the id in history and markets without changing it. An unknown id answers 404 and costs 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_coin](https://scrappa.co/docs/coingecko-api/coingecko_coin)
- **API group:** CoinGecko API
- **Endpoint:** `GET https://scrappa.co/api/coingecko/coin`

## 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. |
| `currency` | string | No | Quote currency: USD (default), EUR, GBP or BTC. Other values return 422. |

## Example response

```json
{
    "data": {
        "coin": {
            "id": "bitcoin",
            "ath": 109114,
            "name": "Bitcoin",
            "rank": 1,
            "price": 67000.5,
            "symbol": "btc",
            "ath_date": "2024-03-14T00:00:00+00:00",
            "currency": "USD",
            "categories": [
                "Cryptocurrency"
            ],
            "contract_addresses": []
        }
    },
    "meta": {
        "source": "coingecko",
        "credits": 1,
        "billable": true,
        "endpoint_family": "coin"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The id is not known. 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)
