The CoinGecko API Alternative
That Keeps Your IDs
Keep the CoinGecko slugs you already store: one call resolves each to a Coinranking coin, and coinGeckoId comes back on every response after that. 2.4M+ coins, price history to 2010 on Startup and higher, with shared monthly credit allowances. Weighing up the field? compare all alternatives.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.
$99/month · 30-day free trial · https://api.coinranking.com/v2/mappings/coingecko/coin/:id
# The CoinGecko id you already store, e.g. 'bitcoin', 'ethereum', 'tether'
curl 'https://api.coinranking.com/v2/mappings/coingecko/coin/bitcoin' \
-H 'x-access-token: YOUR_KEY'
# Returns the same response as /coin/:uuid, with the UUID to store
# and coinGeckoId echoed back on every later responseKeep Your CoinGecko IDs. Change One Base URL.
Migrations fail on identifiers, not on data. This removes that step.
Endpoints marked Growth have production access on Growth and higher. Free, Basic and Startup can make five successful preview requests per eligible endpoint, per account, each UTC day. Normal usage and plan limits apply. How previews work.
Takes CoinGecko's slug (bitcoin, ethereum, tether) and returns the same response as /coin/:uuid. Accepts referenceCurrencyUuid and timePeriod.
- GET/coins
The list and details endpoints carry coinGeckoId on every coin, on every plan, so lookups back to your old keys never cost a call.
- Start a 30-day Growth trial for production mapping access; one key per environment.
- For each row keyed by CoinGecko slug, call the mapping endpoint once and store the
uuid. - Swap each CoinGecko call for its Coinranking counterpart from the table below, starting with
/coins/markets. - Replace polling with the SSE or WebSocket stream where a minute-old price was the pain.
From /coins/markets to /coins, Endpoint by Endpoint
The eight CoinGecko calls most integrations are built on, and the Coinranking call that replaces each.
| CoinGecko | Coinranking | What changes |
|---|---|---|
/coins/markets | /coins | Ranked list with price, market cap, 24h volume, change, sparkline. Up to 5,000 results on paid plans; 1 credit per 500 returned items, rounded up with a minimum of 1 credit. |
/simple/price | /coins?uuids[]=… | Prices for a set of coins in one request. Pass the UUIDs; any of 180+ reference currencies. |
/coins/{id} | /coin/:uuid | Details, supply, links, and the same market figures as the list. |
/coins/{id}/market_chart | /coin/:uuid/price-history?timePeriod= | Price history. One year on Free, five years on Basic, all available history on Startup and higher. timePeriod from 1h to 5y. |
/coins/{id}/ohlc | /coin/:uuid/ohlc | Candles for charting. Growth production access; lower plans have daily previews. |
/coins/list | /mappings/coingecko/coin/:id | Your id map, the other way round: one slug in, one coin out. coinGeckoId is also on every /coins row. |
/exchanges | /exchanges | Exchange list with volume and markets. Growth production access; lower plans have daily previews. |
/global | /stats | Total market cap, 24h volume, Bitcoin dominance. |
CoinGecko paths from docs.coingecko.com/reference, Coinranking paths from coinranking.com/api/documentation, both verified 16 September 2026.
Coinranking and CoinGecko, Side by Side
The terms that differ, so the port is predictable.
| Coinranking | CoinGecko | |
|---|---|---|
| Coin identifier | UUID, e.g. Qwsogvtv82FCd; CoinGecko slug accepted by the mapping endpoint | Slug, e.g. bitcoin |
| What one request costs | 1 credit per single object; 1 per 500 returned items, rounded up with a minimum of 1 credit | Call credits, deducted from the monthly plan |
| Paid plans | Basic $24 / 500K; Startup $49 / 1M; Growth $99 / 2M; Professional $199 / 5M credits | Basic $35 for 100k credits; Analyst $129 for 500k; Lite $499 for 2m |
| Price history | Since 2010 on Startup and higher; 5 years on Basic; 1 year on Free | Capped on Basic; daily from 2013 from Analyst ($129) |
| Rows per list request | Up to 5,000 on paid plans | Up to 250 (per_page) |
| WebSocket billing | 0.0025–0.05 credits per delivered message | 0.1 credit per message received (self-serve) |
| WebSocket status | Live; SLA available as an add-on on Professional and Enterprise | Beta; excluded from the SLA |
| Price streaming over SSE | All plans; recommended for front ends | None documented; its /sse endpoint is the MCP transport for AI clients, not a price feed |
CoinGecko plans and history from coingecko.com/en/api/pricing and docs.coingecko.com/reference/coins-id-market-chart; per_page from docs.coingecko.com/reference/coins-markets; WebSocket figures from docs.coingecko.com/websocket; SSE row from docs.coingecko.com/docs/mcp-server. All verified 16 September 2026.
Why Teams Switch from CoinGecko
Three differences, each with the figure behind it.
Shared REST and streaming credits
REST and streaming share your account credit balance. Delivered WebSocket messages and SSE data events cost 0.05 credits on Free, 0.025 on Basic, 0.01 on Startup, 0.005 on Growth and 0.0025 on Professional. Connection setup, heartbeats, acknowledgements and errors cost no credits. Plan update intervals and connection limits still apply. See plans and pricing.
History to 2010 on Startup and Higher
Startup and higher plans return price history since 2010. Basic includes five years. On CoinGecko, history is capped on Basic and daily data from 2013 starts at Analyst, $129 a month.
Slugs In, UUIDs Out
The mapping endpoint takes the slug you store; every response carries coinGeckoId. No spreadsheet of id pairs, and both providers run side by side during the trial.
Mapping by Plan
Production mapping access starts on Growth, with five successful daily previews per endpoint for Free, Basic and Startup. The coinGeckoId field on every coin is on every plan, including Free.
| Free | Basic | Startup | Growth | Professional | |
|---|---|---|---|---|---|
| Monthly price | $0 | $24 | $49 | $99 | $199 |
| Monthly credits | 10,000 | 500,000 | 1,000,000 | 2,000,000 | 5,000,000 |
| REST rate limit | 5 / second | 1,000 / minute | 2,000 / minute | 4,000 / minute | 6,000 / minute |
| API keys | 1 | 1 | 2 | 5 | Unlimited |
| Historical window, where supported | 1 year | 5 years | All time (from 2010) | All time (from 2010) | All time (from 2010) |
| Maximum results per response | 100 | 5,000 | 5,000 | 5,000 | 5,000 |
| Standard endpoints on this page | 5 successful previews / endpoint / UTC day | 5 successful previews / endpoint / UTC day | 5 successful previews / endpoint / UTC day | Production access | Production access |
Endpoint-specific limits may be lower. Preview allowances are shared across every API key on your account. Every paid plan offers a 30-day free trial. Compare all features.
CoinGecko Switching Questions
GET /coins on Coinranking API. It returns the ranked market with price, market cap, 24h volume, change and a sparkline per coin, the same fields a /coins/markets call gives you, plus coinGeckoId on every row. One request returns up to 5,000 coins on paid plans and costs 1 credit per 500 returned coins, rounded up with a minimum of 1 credit. See the coins endpoint docs.
Yes. GET /mappings/coingecko/coin/:id takes the CoinGecko slug exactly as CoinGecko publishes it, bitcoin, ethereum, tether, and returns the Coinranking coin with its UUID, which every other endpoint takes. Store the UUID next to the slug once; later responses carry coinGeckoId, so the two systems stay linked without another lookup. See the coin mapping docs.
Coinranking uses shared credits: 1 per successful single-object REST response, 1 per 500 returned collection items rounded up with a minimum of 1 credit, a fixed 5 credits for bulk coin downloads, and plan-specific streaming message rates. Connection setup and control messages cost no credits. CoinGecko bills call credits: Basic is $35 a month for 100k credits, Analyst $129 for 500k, Lite $499 for 2m, and its WebSocket charges 0.1 credit per message. Coinranking Startup is $49 for 1,000,000 credits and Professional $199 for 5,000,000, per coingecko.com/en/api/pricing and the Coinranking pricing page, September 2026.
Coinranking API returns up to one year on Free, five years on Basic, and all available price history on Startup and higher, through GET /coin/:uuid/price-history. CoinGecko caps history on its Basic plan and offers daily data from 2013 from the Analyst plan at $129 a month, per its pricing page and the market_chart reference, September 2026. Basic includes five years; Startup and higher include all available history where supported.
Coinranking coin mapping endpoint has production access on Growth, at $99 a month with a 30-day free trial, long enough to migrate a database and run CoinGecko and Coinranking side by side before the first invoice. The coinGeckoId field on ordinary coin responses is on every plan, including Free.
Coinranking identifies coins by UUID rather than slug, authenticates with an x-access-token header or Authorization: Bearer, prices in US dollars by default with referenceCurrencyUuid for 180+ other currencies, and selects a history range with timePeriod rather than days. A few response fields start with a digit, such as 24hVolume, and need bracket notation in JavaScript. Everything else is documented per endpoint.
More of Coinranking API
Same key, same base URL.
Switch from CoinGecko
Map your CoinGecko slugs and run both providers side by side. Try the Growth plan free for 30 days.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.