API Reference

You need to have enough API Call Credits to use our API.

Don't worry, every API key that is auto-generated with a TokenInsight account will be granted 5,000 call credits per month totally for free.

Most API plans include a monthly limit to the number of data calls that can be made. We use call credits to track your API key usage. You can log in to TokenInsight and click the API Key option in your personal center in the top-right corner of the website to check your API Key usage live stats.

Note: The calculation of monthly credit usage is based on the natural month (1st of every month). The usage of your API Key will be reset at the beginning of each natural month, which means that you will receive the Credits amount of the current API Key level again.

If you are a paid plan user, you will be able to use the remaining days that are less than a month for free until the 1st of next month. In other words, you only need to pay until the 1st of next month. Before that, you can use the paid plan for free.

'Credits Cost' of Endpoints

  • For paginated endpoints, we usually charge one additional call credit for every 300 data points returned.
  • For other endpoints, it is simply 1 call credit for every request.
  • Failed requests due to client error will be charged 1 credit and failed requests due to server error will not be charged

Please check the individual endpoints doc for their credit cost.

EndpointPaginated?Credit cost per call
pingn0
globalno1
simple/priceno1
simple/supported_vs_currenciesno1
coins/listyes1 credit per 300 data points
coins/{id}no1
coins/top-gainersno1
coins/top-losersno1
coins/newly-listedyes1 credit per 300 data points
coins/{id}/marketsyes1 credit per 300 data points
coins/list/newly-listedyes1 credit per 300 data points
exchanges/listyes1 credit per 300 data points
exchanges/{id}no1
exchanges/{id}/marketsyes1 credit per 300 data points
news/listyes1 credit per 300 data points
research/listyes1 credit per 300 data points
rating/coin/{id}no1
rating/coinsyes1 credit per 300 data points
history/coins/{id}yes1 credit per 300 data points
history/exchanges/{id}yes1 credit per 300 data points