CoinGecko API endpoint
Lists the coins in one CoinGecko category, identified by the required `slug` such as `stablecoins`. Paged with `page` (default 1) and `limit` (default and max 100), priced in `vs_currency`. Each coin has rank, symbol, price, 1h to 30d changes, 24h volume, market cap and fully diluted valuation.
/coingecko/category/{slug}/coinsReturns coin rows from a CoinGecko category page such as /en/categories/stablecoins.
Path parameters:
slug: CoinGecko category slug, for example stablecoins.Query parameters:
page: page number. Default 1.limit: rows to return. Default 100, max 100.vs_currency: quote currency. Allowed values: 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.Notable response behavior:
coins includes rank, id, symbol, name, URL, image URL, price, 1h/24h/7d/30d changes, 24h volume, market cap, FDV, and market-cap/FDV ratio when present.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| rank | 20 | 3 to 121, median 56 |
| id | 20 | |
| symbol | 20 | “USDT” and 19 other values |
| name | 20 | “Tether” and 19 other values |
| url | 20 | coingecko.com |
| image_url | 20 | assets.coingecko.com |
| price | 20 | 0.99 to 1.12, median 1 |
| change_1h_percent | 20 | 0 to 0.1, median 0 |
| change_24h_percent | 9 | 0.1 to 0.3, median 0.1 |
| change_7d_percent | 7 | 0 to 0.7, median 0 |
| volume_24h | 20 | 293,743 to 62,520,972,325, median 31,170,367 |
| market_cap | 20 | 487,568,755 to 184,065,131,559, median 1,769,574,688 |
| fully_diluted_valuation | 20 | 487,568,755 to 189,528,086,323, median 1,769,574,688 |
| market_cap_fdv_ratio | 20 | 0.97 to 1.01, median 1 |
| change_30d_percent | 3 | 0 to 3.5, median 0.1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | CoinGecko category slug such as stablecoins | stablecoins | |
| page | integer | No | Page number, default 1 | ||
| limit | integer | No | Rows to return, default 100, max 100 | ||
| vs_currency | string | No | Quote currency Allowed values: 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. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/coingecko/category/stablecoins/coins?page=1&limit=10&vs_currency=btc" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "stablecoins",
"name": "Stablecoins",
"page": 1,
"limit": 100,
"vs_currency": "usd",
"source_url": "https://www.coingecko.com/en/categories/stablecoins?page=1",
"fetched_at": "2026-05-24T00:00:00Z",
"coins": [
{
"rank": 1,
"id": "tether",
"symbol": "USDT",
"name": "Tether",
"price": 1,
"market_cap": 150000000000
}
]
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.categoryCoinsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.CategoryCoinsResponse | No | ||||
| data.coins | array | No | Coins in the category on this page. | |||
| data.coins[].change_1h_percent | number | No | 0.01 | Price change over the last hour, in percent. | ||
| data.coins[].change_24h_percent | number | No | 0.03 | Price change over the last 24 hours, in percent. | ||
| data.coins[].change_30d_percent | number | No | 0.1 | Price change over the last 30 days, in percent. | ||
| data.coins[].change_7d_percent | number | No | -0.02 | Price change over the last 7 days, in percent. | ||
| data.coins[].fully_diluted_valuation | number | No | 151000000000 | Fully diluted valuation. | ||
| data.coins[].id | string | No | tether | CoinGecko coin id. | ||
| data.coins[].image_url | string | No | https://assets.coingecko.com/coins/images/325/standard/Tether.png | URL of the coin logo. | ||
| data.coins[].market_cap | number | No | 150000000000 | Market capitalisation of the coin. | ||
| data.coins[].market_cap_fdv_ratio | number | No | 0.99 | Market capitalisation divided by fully diluted valuation. | ||
| data.coins[].name | string | No | Tether | Name of the coin. | ||
| data.coins[].price | number | No | 1 | Current price of the coin. | ||
| data.coins[].rank | integer | No | 1 | Market cap rank of the coin. | ||
| data.coins[].symbol | string | No | USDT | Ticker symbol of the coin. | ||
| data.coins[].url | string | No | https://www.coingecko.com/en/coins/tether | Link to the coin page on CoinGecko. | ||
| data.coins[].volume_24h | number | No | 100000000000 | Trading volume over the last 24 hours. | ||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.limit | integer | No | 100 | Maximum number of coins returned. | ||
| data.name | string | No | Stablecoins | Name of the category. | ||
| data.page | integer | No | 1 | Page number returned. | ||
| data.slug | string | No | stablecoins | URL slug of the category. | ||
| data.source_url | string | No | https://www.coingecko.com/en/categories/stablecoins?page=1 | URL the data was read from. | ||
| data.vs_currency | string | No | usd | Currency code from the request's vs_currency parameter. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/coingecko/category/stablecoins/coins?page=1&limit=10&vs_currency=btc" \
-H "x-api-key: $CRAWLORA_API_KEY"