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 every 24 hours.

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

List - Get All Assets

0.002

Assets

Details - Get Asset Details

0.002

Exchanges

List - Get All Exchanges

0.002

Exchanges

Details - Get Exchange Details

0.002

Exchanges

Markets - Exchange Markets

0.002

Pairs

List - Get All Pairs

0.003

Pairs

Details - Get Pair Details

0.002

Markets

List - Get All Markets

0.003

Markets

Details - Get Market Details

0.002

Markets

Price - Get Current Market Price

0.005

Markets

Trades - Get Market Trades

0.01

Markets

24-Hour Summary - Get Market Summary

0.005

Markets

24-Hour Summary - Get All Markets Summary

0.015

Markets

Order Book - Get Order Book

0.01

Markets

Order Book - Get Order Book Liquidity

0.005

Markets

Order Book - Calculator

0.015

Markets

OHLC Candlesticks - Get Market OHLC

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