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.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 |
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.
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
- 1.
Last modified 1yr ago