On-chain Metrics

Realised Profits & Losses Metrics

SOPR

GET https://api.cherry-pick.xyz/v1/metrics/sopr

The Spent Output Profit Ratio (SOPR) is calculated for all coins moved at the time period considered. The SOPR is calculated as the amount of money (in USD) spent to buy the now-moving coins to the amount of money (in USD) made on the sale.

This metric was originally invented for Bitcoin, and has become known as a useful indicator in making trading decisions.

We were able to implement this metric for ERC-20 coins.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

f

String

Data format: json, csv.

Default: json

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

SOPR in Profit

GET https://api.cherry-pick.xyz/v1/metrics/sopr_profit

This metric is the SOPR calculated only for coins traded at profit.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

SOPR in Loss

GET https://api.cherry-pick.xyz/v1/metrics/sopr_loss

This metric is the SOPR calculated only for coins traded at loss.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Profit

GET https://api.cherry-pick.xyz/v1/metrics/realised_profit

Realised Profit is the total value of profits in dollar equivalent for all coins traded at a given time. A coin is said to be traded at a profit if its purchase price is lower than the market price at the time of sale.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Loss

GET https://api.cherry-pick.xyz/v1/metrics/realised_loss

Realised Loss is the total value of losses in dollar equivalent for all coins traded at a given time. A coin is traded at a loss if its purchase price is higher than the market price at the time of sale.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Profit Denominated in Asset Quantity

GET https://api.cherry-pick.xyz/v1/metrics/realised_profit_asset

This metric represents the total amount of coins traded in profit during the time period considered.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Loss Denominated in Asset Quantity

GET https://api.cherry-pick.xyz/v1/metrics/realised_loss_asset

This metric represents the total amount of coins traded in loss during the time period considered.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Transactions

On-chain Volume

GET https://api.cherry-pick.xyz/v1/metrics/volume

On-chain Volume represents the total volume of coins traded within the blockchain over the time-frame considered.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

On-chain Volume in Dollars

GET https://api.cherry-pick.xyz/v1/metrics/volume_dollar

On-chain Volume in dollars represents the total volume of coins traded within the blockchain over the time-frame considered in dollar terms.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Number of transfers

GET https://api.cherry-pick.xyz/v1/metrics/num_transfers

Number of transfers represents the number of token transfers made with a value in a given range ("$0-100", "$100-1k", and so on) over the time-frame considered.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

t

string

Transfers sample: all, $0-100, $100-1k, $1k-10k, $10k-50k, $50k-100k, $100k-250k, $250k-500k, $500k-1m, $1m-2.5m, $2.5m-5m, $5m-7.5m, $7.5m-10m, $10m-15m, $15m-20m, $20m+

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 23
      },
  ]

Inflow to Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/inflow_cohort

Inflow to Address Cohort represents how many tokens were received by all address in the cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: $10M+. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Inflow to Address Cohort (USD)

GET https://api.cherry-pick.xyz/v1/metrics/inflow_cohort_dollar

Inflow to Address Cohort (USD) represents how many tokens in dollar terms were received by all address in the cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: $10M+. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow to Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/outflow_cohort

Outflow to Address Cohort represents how many tokens were sent by all address in the cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: $10M+. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow to Address Cohort (USD)

GET https://api.cherry-pick.xyz/v1/metrics/outflow_cohort_dollar

Outflow to Address Cohort (USD) represents how many tokens in dollar terms were sent by all address in the cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: $10M+. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Moved Coins Realised Price

GET https://api.cherry-pick.xyz/v1/metrics/moved_coins_realised_price

Moved Coins Realised Price is the average purchase price of tokens that have been transferred during the time period considered. If the MCRP is lower than the market price, it means that on average market participants are trading at a profit. If the MCRP is higher than the market price, it is the other way round, at a loss.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Moved Coins Cost Basis

GET https://api.cherry-pick.xyz/v1/metrics/moved_coins_cost_basis

The Moved Coins Cost Basis represents the total amount of money that has been spent to buy coins that are sent at the time considered.

Moved Coins Cost Basis = Moved Coins Realised Price * On-chain Volume

If the MCCB is lower than the on-chain volume in dollars, it means that coins which were bought at a lower price than the current one are being spent now. Hence, it means that on average market participants are trading at a profit. If the MCCB is higher than the on-chain volume in dollars, it is the other way round, at a loss.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, users, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Unrealised Profits & Losses

Unrealised Profit

GET https://api.cherry-pick.xyz/v1/metrics/unrealised_profit

The unrealised profit is the total amount of profit that all addresses would make if they sold all their coins now.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Unrealised Loss

GET https://api.cherry-pick.xyz/v1/metrics/unrealised_loss

The unrealised loss is the total amount of loss that all addresses would incur if they sold all their coins now.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Supply in Profit

GET https://api.cherry-pick.xyz/v1/metrics/supply_profit

The supply in profit is the total number of coins now held in profit by all addresses or addresses of the selected cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Supply in Loss

GET https://api.cherry-pick.xyz/v1/metrics/supply_loss

The supply in loss is the total number of coins now held in loss by all addresses or addresses of the selected cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Number of Addresses in Profit

GET https://api.cherry-pick.xyz/v1/metrics/num_addresses_profit

The number of addresses in profit is the total number of addresses now held their coins in profit.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 23
      },
  ]

Number of Addresses in Loss

GET https://api.cherry-pick.xyz/v1/metrics/num_addresses_loss

The number of addresses in loss is the total number of addresses now held their coins in loss.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 23
      },
  ]

Macro

Supply

GET https://api.cherry-pick.xyz/v1/metrics/supply

The supply is the total number of coins that now exist.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Market Capitalisation

GET https://api.cherry-pick.xyz/v1/metrics/market_cap

Market Capitalisation represents the total dollar market value.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Price

GET https://api.cherry-pick.xyz/v1/metrics/realised_price

Realised Price is the average price at which all existing tokens were purchased (moved last time). If the realised price is higher than the current market price, this indicates that most of the coins are now held at a loss. If the realised price is lower than the market price, it means that most of the supply is holding at a profit.

Read more about this indicator here.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Realised Capitalisation

GET https://api.cherry-pick.xyz/v1/metrics/realised_cap

Realised Cap shows the real amount of money (in USD terms) 'accumulated' or 'stored' in the market of the considered cryptocurrency.

It is calculated as the sum of all existing coins weighted by the price of their last movement. Coins received at a high price will have a large contribution to Realised Cap. Coins received at a low price - small contribution.

Read more about this indicator here.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Number of Addresses

GET https://api.cherry-pick.xyz/v1/metrics/num_addresses

Number of Addresses represents the total number of addresses (or addresses of a selected cohort) holding that coin.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

Address Cohort: total, users, sc, cex, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 23
      },
  ]

Exchanges

This block gathers all endpoint related to Centralised Exchanges reserves, inflows & outflows.

CEX Reserve by Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_reserve

Represents the number of coins stored at the addresses of the selected exchange or all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

CEX Reserve (USD) by Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_reserve_dollar

Represents the number of coins in dollar terms stored at the addresses of the selected exchange or all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Inflow to Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_inflow

Inflow to Exchange represents how many tokens have been sent to all addresses belonging to the selected exchange or to all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Inflow (USD) to Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_inflow_dollar

Inflow to Exchange represents how many tokens in dollar terms have been sent to all addresses belonging to the selected exchange or to all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow from Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_outflow

Outflow from Exchange represents how many tokens have been sent from all addresses belonging to the selected exchange or from all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow (USD) from Exchange

GET https://api.cherry-pick.xyz/v1/metrics/cex_outflow_dollar

Outflow from Exchange represents how many tokens in dollar terms have been sent from all addresses belonging to the selected exchange or from all exchanges.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

CEX: all, ascendex, bibox, bilaxy, binance, bitmart, bitfinex, bithumb, bitrue, bitstamp, bittrex, bitzlato, bw.com, crex24, changelly, coinexchange.io, coinbase, coinbene, coinex, coinone, crypto.com, cryptopia, exmo, fcoin, ftx, ftx_us, gate.io, gemini, hitbtc, hoo.com, hotbit, huobi, indodax, kraken, kucoin, kuna.io, liqui.io, luno, mexc, maicoin, mercatox, okex, paribu, poloniex, remitano, shapeshift, upbit, whitebit, yobit.net, yunbi, zb.com, other.

Default: all.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
]

Inflow to Exchanges by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/cex_inflow_cohort

Inflow to Exchanges by Address Cohort represents how many tokens have been sent to all exchanges' addresses from all non-exchange addresses or addresses belonging to the selected address cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
]

Inflow (USD) to Exchanges by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/cex_inflow_dollar_cohort

Inflow (USD) to Exchanges by Address Cohort represents how many tokens in dollar terms have been sent to all exchanges' addresses from all non-exchange addresses or addresses belonging to the selected address cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow from Exchanges by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/cex_outflow_cohort

Outflow from Exchanges by Address Cohort represents how many tokens have been sent from all exchanges' addresses to all non-exchange addresses or addresses belonging to the selected address cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow (USD) from Exchanges by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/cex_outflow_dollar_cohort

Outflow (USD) from Exchanges by Address Cohort represents how many tokens in dollar terms have been sent from all exchanges' addresses to all non-exchange addresses or addresses belonging to the selected address cohort. To find out what address cohorts are, see Address Cohorts.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Smart Contracts

Volume Locked in Smart Contracts

GET https://api.cherry-pick.xyz/v1/metrics/sc_volume_locked

Represents the number of coins stored at smart contracts addresses.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Volume (USD) Locked in Smart Contracts

GET https://api.cherry-pick.xyz/v1/metrics/sc_volume_locked_dollar

Represents the number of coins in dollar terms stored at smart contracts addresses.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Inflow to Smart Contracts by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/sc_inflow

Inflow to Smart Contracts represents how many tokens have been sent to all smart contract addresses from all non-smart contract addresses or addresses belonging to the selected address cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Inflow (USD) to Smart Contracts by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/sc_inflow_dollat

Inflow (USD) to Smart Contracts represents how many tokens in dollar terms have been sent to all smart contract addresses from all non-smart contract addresses or addresses belonging to the selected address cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow from Smart Contracts by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/sc_outflow

Outflow from Smart Contracts represents how many tokens have been sent from all smart contract addresses to all non-smart contract addresses or addresses belonging to the selected address cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Outflow (USD) from Smart Contracts by Address Cohort

GET https://api.cherry-pick.xyz/v1/metrics/sc_outflow_dollar

Outflow (USD) from Smart Contracts represents how many tokens in dollar terms have been sent from all smart contract addresses to all non-smart contract addresses or addresses belonging to the selected address cohort.

Query Parameters

Name
Type
Description

api_key*

UUID

Your API Key

a*

string

Asset Symbol. See List of Assets.

s

integer

Since: unix timestamp

u

integer

Until: unix timestamp

r

string

Resolution: day, hour, block

c

string

Address Cohort: total, $0-100, $100-1k, $1k-10k, $10k-100k, $100k-1M, $1M-10M, $10M+, balance_cohort_0, balance_cohort_1, balance_cohort_2, balance_cohort_3, balance_cohort_4, balance_cohort_5, balance_cohort_6, balance_cohort_7, <1d, 1d-1w, 1w-1m, 1m-3m, 3m-6m, 6m-1y, 1y-2y, 2y-3y, 3y-5y, 5y-7y, 7y-10y.

Default: total. See Address Cohorts.

[
    {
        "t": "2023-08-29T00:00:00",
        "v": 0.9231922062573908
      },
  ]

Last updated

Was this helpful?