Links

Rate Limit

The API is rate limited by an allowance measured in Cryptowatch Credits, rather than a fixed number of calls per time window. Each type of API request has a Credits value assigned to it.
Free/Anonymous accounts are limited to the equivalent of 10 Cryptowatch Credits worth of API calls per 24-hour period. The table below describes the cost of each type of API request.
Some API requests cost more than than others, so these cost more allowance. Your allowance is reset 24 hours after your first request.
Each response includes information about your allowance:
{
"allowance": {
"cost": 0.003,
"remaining": 9.572,
"account": "8b095566-51e7-475b-bdf3-4bdb11d56fc1"
}
}
The cost is the amount of Credits required to complete the request, and remaining is how many Credits remain in your 24-hour allowance.
You can use this information, along with the current time, to have your application self-regulate its request rate. If you spend all of your allowance, the API server will return a 429 Too Many Requests response and you will have to wait until the top of the hour for your allowance to reset.
You can always request the root path https://api.cryptowat.ch to query your allowance without any extra result - this request costs very little.

API Request pricing structure

The table below details the pricing structure for single API requests. Requests can cost between 2-15 Credits per 1000 requests.
Category
API Endpoint
Credits per API call
Assets
0.002
Assets
0.002
Exchanges
0.002
Exchanges
0.002
Exchanges
0.002
Pairs
0.003
Pairs
0.002
Markets
0.003
Markets
0.002
Markets
0.005
Markets
0.01
Markets
0.005
Markets
0.015
Markets
0.01
Markets
0.005
Markets
0.015
Markets
0.015

Pay for higher limits

Once you've created an account, you can generate an API key and use it to link your API usage with your account.
Credits will then be deducted every hour on the hour based on your API usage, which can be monitored under the Transaction History section of the Credits & Billing menu.

Using a URL query parameter

https://api.cryptowat.ch/markets/kraken/btcusd/price?apikey=CXRJ2EJTOLGUF4RNY4CF
https://api.cryptowat.ch/markets/kraken/btcusd/ohlc?periods=86400&apikey=CXRJ2EJTOLGUF4RNY4CF
Using an HTTP header
X-CW-API-Key: CXRJ2EJTOLGUF4RNY4CF
How to get an API key