Introduction
Power your projects with the high quality cryptocurrency data coinranking.com provides. We provide data about coins, exchanges, markets & more.
Base url:
https://api.coinranking.com/v2To get you started, read about why you should use our API and check out our pricing options. We've included a powerful free tier too!
Good luck with building your awesome project! And don't hesitate to reach out to us.
When using our API in your project, please let your visitors know by adding the following reference:
Data provided by Coinranking
Older API versions
API v1 is still online, and will remain so for the foreseeable future. The use of API v1 is deprecated, so we strongly advise you to use API v2. You can still read the documentation for API v1.
Authentication
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: 53a0b0a7e4f2fa59519e4. Use our key generator to get a free API key.
All API requests must be made over HTTPS. Calls made over plain HTTP will redirect to HTTPS.
Example:
curl https://api.coinranking.com/v2/coins \
-H x-access-token: 53a0b0a7e4f2fa59519e4Why would I authenticate?
You can only do a very limited amount of requests without authenticating. Read on to learn more about our rate-limits, or check out our pricing page.
Rate limits
The amount of requests you can do before you run into our rate limit depends on your API key. With our free API key you can make about 200K requests per month. If you need more you can get an all-you-can-eat or enterprise key, which you can read more about at our pricing page. 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 advice you to get a key to not unexpectedly run into the rate limiter.
Types of rate limiting
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 200K 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.
Rate limit response headers
Every request you do returns information about the rate-limit, so your application can adapt before reaching the limit.
| Header | Description | |
|---|---|---|
| X-RateLimit-Limit-Second | The maximum amount of requests in a second |
|
| X-RateLimit-Limit-Minute | The maximum amount of requests in a minute |
|
| X-RateLimit-Limit-Hour | The maximum amount of requests in an hour |
|
| X-RateLimit-Limit-Month | The maximum amount of requests in a month |
|
| X-RateLimit-Remaining-Second | The amount of requests you can still do in a second |
|
| X-RateLimit-Remaining-Minute | The amount of requests you can still do in a minute |
|
| X-RateLimit-Remaining-Hour | The amount of requests you can still do in a hour |
|
| X-RateLimit-Remaining-Month | The amount of requests you can still do in an hour |
|
| RateLimit-Limit | 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 |
|
| RateLimit-Reset | This will tell you the amount of seconds remain untill the quota of your lowest rate-limit will be restored to its maximum |
|
| RateLimit-Remaining | The amount of requests remaining for the lowest remaining limit |
Pricing
You can generate a key for free. The 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 provide, have a look into our packages on our pricing page.
CORS
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. To prevent this, run a proxy where you can safely use your API key, or contact us to set up a proxy for you (enterprise tier only).
Images
Image URLs are provided as .svg, for example the logo for Bitcoin is:
https://cdn.coinranking.com/Sy33Krudb/btc.svgWe also support .png on all our coin and exchange logos. If you prefer this, just replace the svg extension with png:
https://cdn.coinranking.com/Sy33Krudb/btc.png