Use this documentation to add real-time prices of cryptocurrencies, like Bitcoin, Ethereum, and Dogecoin to your app or website. Get metadata on every coin we have listed, such as circulating supply, block explorers, trading pairs, logos, and much more.
Start by generating a free key to get a taste of our API. When you’re convinced (you will be!), you can access more endpoints and API calls by upgrading to the PRO plan, which also includes CORS (Cross Resource Origin Sharing) and OHLC (Open High Low Close) data. Take a look at our pricing page to see which one of the subscription plans suits you best.
Need help? Don’t hesitate to reach out to us.
Enjoy and good luck building your awesome product!
The Coinranking API uses API keys to authenticate requests.
Authentication to the API is performed via a custom HTTP header. Provide your API key as the value of the X-Access-Token, like
x-access-token: coinranking53a...9e4. Create a free account to get an API key.
All API requests must be made over HTTPS. Calls made over plain HTTP will redirect to HTTPS.
curl https://api.coinranking.com/v2/coins \ -H x-access-token: 53a0b0a7e4f2fa59519e4
The amount of requests you can do before you run into our rate limit depends on your subscription. With our free API key, you can make 10K requests per month. If you need more you can upgrade very easily.
Without a key, you can still make a very limited amount of requests so you can quickly test if our endpoints fit your needs, or debug a little bit during development. The unauthenticated requests are not guaranteed to work, so we advise you to get a key to not unexpectedly run into the rate limiter.
We have rate limits for several time intervals. We protect against burst requests by limiting the free keys to about five requests per second. Our free key is limited to 10K requests per month. Unauthenticated requests are limited much more per month, and have limits per minute and hour as well. The current unauthenticated rate limits might change in the future to whatever we see fit; for guaranteed rate limits get one of our free keys.
Every request you do returns information about the rate-limit, so your application can adapt before reaching the limit.
The maximum amount of requests in a second
The maximum amount of requests in a minute
The maximum amount of requests in an hour
The maximum amount of requests in a month
The amount of requests you can still do in a second
The amount of requests you can still do in a minute
The amount of requests you can still do in a hour
The amount of requests you can still do in an hour
This is the rate-limit that is the first to run out. E.g. when you can still do 10000 requests this month, but only 5 this minute, it will show 5
This will tell you the amount of seconds remain until the quota of your lowest rate-limit will be restored to its maximum
The amount of requests remaining for the lowest remaining limit
Try and test our API first by generating a key for free. This key is also suitable for small applications. This free tier will remain free, but it has some limitations such as a more restrained rate limit and it lacks some endpoints. So if you need more than the free tier provides, you can upgrade to our hobbyist or PRO plan.
If you are developing an application that directly makes requests from the browser to our API, you will run into issues with Cross Origin Resource Sharing (CORS). To prevent this, our API will respond with your custom domain in a CORS header. You can set your custom domain on the settings page. CORS is supported in our Hobbyist plan and above.
After you've set your custom domain on the settings page, your requests should pass an X-Access-Token header, like
x-access-token: coinranking53a...9e4 and an Origin header with your custom domain. For the X-Access-Token header, see Authentication.
Icon URLs are provided as
.svg, for example the logo for Bitcoin is:
We also support
.png on all our coin and exchange logos. If you prefer this, just replace the svg extension with png:
We’re constantly trying to improve our API, to provide you with the best possible experience. That’s why we love to hear if you find it as simple and good as we hope you do; let us know by answering two short questions.
We’ve disabled API v1 since January 2022. Haven’t you migrated to v2 yet? Use our short guide to migrate: