Crypto market research
Use CoinGecko endpoints to turn crypto market research into repeatable API requests with documented inputs and JSON responses.
Use a CoinGecko API to build crypto market research workflows from public CoinGecko pages — coins, markets, categories, chains, exchanges, and NFTs — without treating Crawlora as an exchange feed, broker, investment adviser, or real-time trading source.
Use a CoinGecko API to extract public crypto market, coin, category, chain, exchange, NFT, unlock, treasury, news, and Learn article data as structured JSON.
Endpoint families
6
Documented params
75
Examples
21
Live catalog snapshot
Active endpoints
21
Methods
GET
Required params
28
Schema refs
21
{
"platform": "CoinGecko",
"endpoint": "coingecko-markets",
"method": "GET",
"path": "/coingecko/markets",
"auth": "apiKey"
}Related use cases
Use cases
Use a CoinGecko API to extract public crypto market, coin, category, chain, exchange, NFT, unlock, treasury, news, and Learn article data as structured JSON.
Use CoinGecko endpoints to turn crypto market research into repeatable API requests with documented inputs and JSON responses.
Use CoinGecko endpoints to turn coin and category monitoring into repeatable API requests with documented inputs and JSON responses.
Use CoinGecko endpoints to turn nft, chain, exchange, and token unlock analysis into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live CoinGecko endpoint catalog — 21 endpoints, 75 documented request parameters, and 21 published response schemas — the same catalog Docs and Playground run against.
21 documented CoinGecko endpoints, grouped into 18 request families — Chains, Coin and Global, plus 15 more.
75 request parameters are documented across those CoinGecko endpoints, 28 of them required — the full input contract is public before you write any integration code.
21 of the 21 CoinGecko endpoints ship a recorded example response, and 21 carry a documented response schema — you can code against the real JSON before the first request.
CoinGecko endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
21 hosted MCP tools back the CoinGecko endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/coingecko/chains
/coingecko/coin/{id}
/coingecko/global
/coingecko/categories
/coingecko/category/{slug}/coins
/coingecko/exchange/{id}
Featured endpoints
/coingecko/marketsReturns normalized cryptocurrency market rows from CoinGecko public pages. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.
Response notes
- `data.coins` contains rank, CoinGecko id, symbol, name, URL, image URL, price, 1h/24h/7d percent changes, 24h volume, and market cap when present upstream. - Challenge pages, malformed HTML, and pages with zero parsed market rows return an upstream error. Example response: ```json { "code": 200, "msg": "ok", "data": { "page": 1, "limit": 3, "vs_currency": "usd", "source_url": "https://www.coingecko.com/?page=1", "fetched_at": "2026-05-24T00:00:00Z", "coins": [ { "rank": 1, "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "url": "https://www.coingecko.com/en/coins/bitcoin", "price": 76535.94, "change_24h_percent": 1.5, "volume_24h": 26813530873, "market_cap": 1533816836729 } ] } } ```
MCP tool coingecko_markets
/coingecko/coin/{id}Returns normalized CoinGecko profile, market stats, links, and categories for one coin id. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.
Response notes
- The response includes identity fields, rank, price, change metrics, market statistics, supply statistics, links, categories, `source_url`, and `fetched_at` when present upstream. - Challenge pages, malformed HTML, and pages missing expected coin-profile markers return an upstream error. Example response: ```json { "code": 200, "msg": "ok", "data": { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "rank": 1, "price": 76535.94, "change_24h_percent": 1.5, "market_cap": 1533816836729, "volume_24h": 26813530873, "links": { "website": "https://bitcoin.org", "github": "https://github.com/bitcoin/bitcoin" }, "categories": ["Smart Contract Platform"], "source_url": "https://www.coingecko.com/en/coins/bitcoin", "fetched_at": "2026-05-24T00:00:00Z" } } ```
MCP tool coingecko_coin
/coingecko/coin/{id}/analysisReturns derived price-chart metrics from CoinGecko public chart JSON. This endpoint supports the documented `vs_currency` enum and is not investment advice or real-time trading data.
Response notes
- The response includes first/last/min/max price, absolute change, percent change, high-low range percent, point count, and sampled points. - When `include_annotations=true`, available chart annotation objects are returned with `annotations_source_url`. - Malformed chart JSON, empty chart point arrays, and challenge pages return an upstream error. Example response: ```json { "code": 200, "msg": "ok", "data": { "id": "bitcoin", "vs_currency": "usd", "range": "24h", "source_url": "https://www.coingecko.com/price_charts/bitcoin/usd/24_hours.json", "fetched_at": "2026-05-24T00:00:00Z", "first_price": 75386.89, "last_price": 76535.94, "min_price": 75344.2, "max_price": 77216.4, "absolute_change": 1149.05, "percent_change": 1.52, "high_low_range_percent": 2.48, "points_count": 288, "points": [ { "timestamp": 1779556795943, "datetime": "2026-05-24T00:00:00Z", "price": 75386.89 } ] } } ```
MCP tool coingecko_coin_analysis
/coingecko/trendingReturns deduped trending coins and categories from the public CoinGecko highlights page. This endpoint supports the documented `vs_currency` enum.
Response notes
- Coin and category links are deduped by CoinGecko slug. - Price and change fields are included when the highlights page exposes them. - No parsed trending items from a non-empty page returns an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "limit": 20, "vs_currency": "usd", "source_url": "https://www.coingecko.com/en/highlights", "fetched_at": "2026-05-24T00:00:00Z", "coins": [ { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "url": "https://www.coingecko.com/en/coins/bitcoin", "price": 76535.94, "change_24h_percent": 1.4 } ], "categories": [ { "id": "layer-1", "slug": "layer-1", "name": "Layer 1", "url": "https://www.coingecko.com/en/categories/layer-1", "change_24h_percent": 2.5 } ] } } ```
MCP tool coingecko_trending
/coingecko/searchReturns normalized CoinGecko search sections from the public website search JSON. Empty valid searches return empty arrays.
Response notes
- `coins`, `categories`, `markets`, `nft_contracts`, `asset_platforms`, and `posts` are always present as arrays. - Source metadata is returned as `source_url` and `fetched_at`. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "bitcoin", "limit": 10, "source_url": "https://www.coingecko.com/en/search_v2?query=bitcoin", "fetched_at": "2026-05-24T00:00:00Z", "coins": [ { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "url": "https://www.coingecko.com/en/coins/bitcoin", "market_cap_rank": 1 } ], "categories": [], "markets": [], "nft_contracts": [], "asset_platforms": [], "posts": [] } } ```
MCP tool coingecko_search
/coingecko/categoriesReturns normalized CoinGecko category rows from the public categories page. This endpoint supports the documented `vs_currency` enum.
Response notes
- Category rows include rank, `id`, `slug`, name, URL, 1h/24h/7d percentage changes, market cap, 24h volume, and coin count when present. - Zero parsed rows without an explicit empty-state marker returns an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "limit": 100, "vs_currency": "usd", "source_url": "https://www.coingecko.com/en/categories", "fetched_at": "2026-05-24T00:00:00Z", "categories": [ { "rank": 1, "id": "layer-1", "slug": "layer-1", "name": "Layer 1", "url": "https://www.coingecko.com/en/categories/layer-1", "change_1h_percent": 0.2, "change_24h_percent": 1.4, "change_7d_percent": -2.1, "market_cap": 2533816836729, "volume_24h": 813530873, "coin_count": 128 } ] } } ```
MCP tool coingecko_categories
How to scrape CoinGecko
CoinGecko publishes an official API with a rate-limited free tier and a paid tier beyond it. Crawlora's 21 CoinGecko endpoints read the public CoinGecko pages instead — coins, markets, categories, chains, exchanges, NFTs, treasuries, and token unlocks — as normalized JSON for research. This is not an exchange feed or a real-time trading source.
The search endpoint resolves a free-text query to coins, and the markets endpoint returns ranked market rows you can page through.
Most endpoints take vs_currency from a documented enum covering major fiat, the large crypto quotes, and metal and unit quotes.
Coin profile and chart analysis for a single asset; trending, gainers-and-losers, new coins, and the global snapshot for market-wide reads; categories, chains, exchanges, and NFT collections for segment views.
Incoming token unlocks, crypto treasuries filtered by asset and holder type, news cards, and Learn articles round out the research picture.
FAQ
Yes, and CoinGecko's own API is the right choice for licensed or high-frequency use — it has a rate-limited free tier and paid plans above it. Crawlora's endpoints read CoinGecko's public pages and suit research pipelines that already run other Crawlora endpoints and want one key, one response shape, and one bill.
No. These endpoints are documented as research data and are not intended as a real-time trading source, an exchange feed, or a broker connection. Crawlora is not an investment adviser and nothing here is investment advice.
A documented vs_currency enum covering major fiat currencies, the large crypto quotes such as btc, eth, and sol, and metal and unit quotes including xau, xag, bits, and sats.
Categories and their constituent coins, chains, spot and DEX and derivatives and perp-DEX exchanges, NFT collections and categories, a global market snapshot with chart series, incoming token unlocks, and crypto treasuries filtered by asset and holder type.