cURL

curl "https://api.cryptoquant.com/v1/btc/market-data/capitalization?window=day&from=20191001&limit=2"

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "market_cap": null,
        "realized_cap": null,
        "average_cap": null,
        "delta_cap": null,
        "thermo_cap": null
      },
      {
        "date": "2019-10-01",
        "market_cap": null,
        "realized_cap": null,
        "average_cap": null,
        "delta_cap": null,
        "thermo_cap": null
      }
    ]
  }
}

BTC Market Data

Capitalization

This endpoint returns metrics related to market capitalization. First, we provide market_cap, which is total market capitalization of BTC, calculated by multiplying the total supply with its USD price. Moreover, we provide several adjusted capitalization metrics which are used for further fundamental analysis. realized_cap is the sum of each UTXO * last movement price. Since cryptocurrencies can be lost, unclaimed, or unreachable through various bugs, realized_cap is introduced to discount those coins which have remained unmoved for a long period. It is one way to attempt to measure the value of Bitcoin. This can be described as an on-chain version of volume weighted average price(VWAP). average_cap is forever moving average, calculated by dividing the cumulated sum of daily market cap with the age of market. Instead of using fixed time for calculating the moving average (e.g. 50 days, 100days …), this serves as the true mean. Both realized_cap and average_cap are used to calculate delta_cap (realized_cap-average_cap). delta_cap is often used to spot market bottoms. Moreover, by analyzing the movement of delta_cap which oscillates between realized_cap and average_cap, we could notice that market tops are reached when delta_cap is near realized_cap(in a log scaled chart). Another metric that can be used to spot market bottoms is thermo_cap which is the weighted cumulative sum of the mined cryptocurrency price. This metric provides the total amount of funds in the blockchain network and also helps to evaluate whether market_cap is overvalued or not.
Go to Data Guide‣

GET

btc

market-data

capitalization

cURL

curl "https://api.cryptoquant.com/v1/btc/market-data/capitalization?window=day&from=20191001&limit=2"

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-10-02",
        "market_cap": null,
        "realized_cap": null,
        "average_cap": null,
        "delta_cap": null,
        "thermo_cap": null
      },
      {
        "date": "2019-10-01",
        "market_cap": null,
        "realized_cap": null,
        "average_cap": null,
        "delta_cap": null,
        "thermo_cap": null
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

For each API request, include this HTTP header: Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required. You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.

Query Parameters

window

string

default:day

Currently we support day and block.

from

string

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

string

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

limit

integer

default:100

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Required range: 1 <= x <= 100000

format

string

default:json

A format type about return message type. Supported formats are json, csv.

Response

200 - application/json

market_cap, realized_cap, average_cap, delta_cap, thermo_cap

status

object

required

The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.

Show child attributes

result

object

required

Show child attributes

Liquidations Coinbase Premium Index

⌘I