NAV Navbar
shell

Introduction

Welcome to the TokenAnalyst API. We provide simple and powerful endpoints, which you can use to get information on basic transaction data and aggregate on-chain statistics derived directly from the blockchain. This API reference provides information on available endpoints and how to interact with them.

Authentication

TokenAnalyst uses API keys to allow access to the API. To obtain your API key contact us here .

TokenAnalyst expects for the API key to be included in all API requests to the server. You can simply include the key in the URL parameters like:

key=API_KEY

Date & Time Conventions

Throughout this API a window parameter is used to indicate the time intervals for which the data is aggregated. We currently offer daily (denoted by window=1d) and hourly (denoted by window=1h) endpoints:

Window Description
1d Data returned per day for every day historically for which data exists for the endpoint in question. The latest day returned is the last full day of data. Each day runs from 0:00:00 UTC to 23:59:59 UTC.
1h Data returned per hour for every hour for which data exists for the endpoint in question. All times are in UTC. The displayed hour in the data is the start of the hour for which the data is aggregated. For example if "hour":"22:00:00", it represents data from 22:00:00 to 22:59:59 UTC.

Bitcoin Fundamentals

BTC On-chain Volume

This endpoint returns the full historical on-chain volume of Bitcoin since it's genesis in 2009. The volume is separated into 'real' volume and 'change' volume.

Our current heuristic for 'change' related volume is for whenever BTC in a transaction is sent back to the same address that sent the BTC. The 'real' volume is simply the remainder left over after subtracting the change.

# Make sure you substitute API_KEY for your unique API key.

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?format=json&key=API_KEY&token=btc&window=1h"

The above command returns JSON structured like this:

[
  {
    "date": "2014-03-12",
    "hour": "22:00:00", // not available when window 1d
    "datetime": "2014-03-12 22:00:00", // not available when window 1d
    "volume_gross": 18162.41657378,
    "volume_change": 1437.98486305,
    "volume_real": 16724.43171073,
    "volume_change_usd": 891507.43,
    "volume_real_usd": 10368645.44
  },
  {
    "date": "2014-03-12",
    "hour": "23:00:00", // not available when window 1d
    "datetime": "2014-03-12 23:00:00", // not available when window 1d
    "volume_gross": 51391.70115624,
    "volume_change": 904.51484837,
    "volume_real": 50487.18630787,
    "volume_change_usd": 560383.11,
    "volume_real_usd": 31278830.3
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for (in this case btc)
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
volume_change decimal The total sum of BTC sent to (locked by) addresses that were also on the sending side of the same transaction
volume_change_usd decimal volume_change * price_usd
volume_gross decimal The total sum of BTC sent by (unlocked by) addresses in transactions with a timestamp that occurs on this date. Does not include coinbase rewards.
volume_real decimal volume_gross - volume_change
volume_real_usd decimal volume_real * price_usd

BTC On-chain Transaction Count

This endpoint returns the daily number of transactions on the full historical Bitcoin blockchain for every day since it's genesis in 2009.

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?format=json&token=btc&window=1h&from_date=2009-03-12&to_date=2009-03-12&limit=3&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2009-03-12",
    "hour": "21:00:00", // not available when window 1d
    "datetime": "2009-03-12 21:00:00", // not available when window 1d
    "number_of_txns": 7
  },
  {
    "date": "2009-03-12",
    "hour": "22:00:00", // not available when window 1d
    "datetime": "2009-03-12 22:00:00", // not available when window 1d
    "number_of_txns": 6
  },
  {
    "date": "2009-03-12",
    "hour": "23:00:00", // not available when window 1d
    "datetime": "2009-03-12 23:00:00", // not available when window 1d
    "number_of_txns": 5
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for (in this case btc)
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
number_of_txns integer The number of transactions included in blocks with a timestamp that occurs during this date (includes coinbase transactions)
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h

BTC Active addresses

This endpoint returns the daily number of active addresses on the Bitcoin blockchain for each day of its existence. An address is defined as 'active' if it has sent or received bitcoin in a transaction with a timestamp on that day. Only the distinct number of addresses are counted, i.e. an address which sends thousands of transactions per day is only counted once as an active_sender with the same logic applied to distinct receiving addresses.

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last?format=json&token=btc&window=1d&from_date=2018-10-10&to_date=2018-10-18&limit=2&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2018-10-17",
    "active_senders": 477052,
    "active_recipients": 490874
  },
  {
    "date": "2018-10-18",
    "active_senders": 459061,
    "active_recipients": 479728
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent BTC in transactions with a timestamp on this date
active_recipients integer The total number of distinct addresses that received BTC in transactions with a timestamp on this date

BTC Supply

This endpoint returns the historical supply of BTC on the Bitcoin blockchain for each day of its existence. This is the sum of BTC paid out in coinbase rewards.

Since there is no requirement for a miner who successfully mines a block to pay themselves any or all of the block reward, we cannot simply multiply the number of blocks by the current reward level for those block(s). There have been instances where no coinbase reward was claimed at all, meaning those bitcoins are lost from the total supply forever.

The supply generated by each mined block is the sum of the outputs (which includes the value of any coinbase reward up to the maximum permissible claimed by the miner), minus the sum of the inputs sent in that block.

This metric includes bitcoins that have been locked by so-called 'burn' addresses (addresses for which there is likely no known private key hence those bitcoins are also lost forever). An example of this is the lowest possible bitcoin address of 1111111111111111111114oLvT2.

curl "https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last?format=json&token=btc&window=1d&from_date=2016-10-10&to_date=2016-10-12&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2016-10-10",
    "supply": 15922677.2953033
  },
  {
    "date": "2016-10-11",
    "supply": 15924414.7953033
  },
  {
    "date": "2016-10-12",
    "supply": 15926214.7953033
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
supply float The cumulative sum of bitcoins generated by mined blocks up to this date

BTC NVT

curl "https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last?format=json&token=btc&window=1d&from_date=2011-10-10&to_date=2012-09-01&limit=3&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2012-08-30",
    "marketcap_usd": 89396489.26,
    "nvt": 0.8546
  },
  {
    "date": "2012-08-31",
    "marketcap_usd": 89460189.25,
    "nvt": 1.1035
  },
  {
    "date": "2012-09-01",
    "marketcap_usd": 89533444.23,
    "nvt": 1.1367
  }
]

This endpoint returns the NVT Ratio (Network Value to Transactions Ratio) for BTC. This is the ratio of the Market Cap divided by the volume transmitted by the blockchain. Special thanks to Willy Woo and Chris Burniske for coming up with it!

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
marketcap_usd decimal The total USD market capitalization of BTC on this date. (price_usd * supply)
nvt decimal Ratio comprising the total BTC Market Cap divided by the on-chain volume. (marketcap_usd / volume_real_usd)

BTC Fees

curl "https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last?format=json&token=btc&window=1d&from_date=2014-03-12&to_date=2014-03-15&limit=2&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2014-03-14",
    "total_fee": 13.6553,
    "avg_size_bytes": 575,
    "total_fee_usd": 8480.11,
    "avg_satoshis_per_byte": 33.6015,
    "avg_fee": 0.0002,
    "avg_fee_usd": 0.12
  },
  {
    "date": "2014-03-15",
    "total_fee": 10.9136,
    "avg_size_bytes": 508,
    "total_fee_usd": 6774.36,
    "avg_satoshis_per_byte": 35.6095,
    "avg_fee": 0.0002,
    "avg_fee_usd": 0.11
  }
]

This endpoint returns the total and average fees spent on the Bitcoin network for every day of it's existence. The total_fee is denominated in Bitcoin, the price is the price of Bitcoin on that day, and the avg_fee is denominated in Bitcoin. Since fees are paid to miners as part of the coinbase transaction, these transactions are not included when calculating metrics such as the average fee per transaction (avg_fee). Before 2010 there was little activity on the blockchain besides mining, i.e. the chain was dominated by coinbase transactions.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
total_fee decimal The total amount of fees paid by all transactions that occurred on this date. Denominated in BTC.
avg_size_bytes integer The average transaction size to the nearest byte for transactions that occurred on this date.
total_fee_usd decimal total_fee * price
avg_satoshis_per_byte integer The average number of satoshis paid per byte for transactions that occurred on this date
avg_fee decimal The average amount of fees paid per transaction that occurred on this date. Denominated in BTC.
avg_fee_usd decimal avg_fee * price_usd

BTC UTXO Age

curl "https://api.tokenanalyst.io/analytics/private/v1/token_utxo_age_window_historical/last?window=1d&exchange=binance&direction=outflow&format=json&token=btc&from_date=2019-09-01&to_date=2019-09-02&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2019-09-01",
    "1-3m": 0.0812,
    "12-18m": 0.1705,
    "18-24m": 0.0795,
    "1d-1w": 0.0219,
    "1w-1m": 0.0646,
    "2-3y": 0.0491,
    "3-5y": 0.0657,
    "3-6m": 0.1322,
    "5-10y": 0.1438,
    "6-12m": 0.1105,
    "<1d": 0.0131,
    ">10y": 0.0679
  },
  {
    "date": "2019-09-02",
    "1-3m": 0.0815,
    "12-18m": 0.1705,
    "18-24m": 0.0798,
    "1d-1w": 0.0226,
    "1w-1m": 0.0634,
    "2-3y": 0.0491,
    "3-5y": 0.0658,
    "3-6m": 0.1317,
    "5-10y": 0.1436,
    "6-12m": 0.1109,
    "<1d": 0.0132,
    ">10y": 0.068,
    "date": "2019-03-15"
  }
]

This endpoint returns the proportion of the current bitcoin supply held in unspent transaction outputs stratified by their age. For instance outputs in the category 12-18m are unspent outputs (UTXOs) from transactions that occurred 12-18m ago. Time is measured relative to blocktime assuming 6 blocks are generated per hour. This means that the proportion of UTXOs in the <1d category were generated less than or equal to 144 blocks ago (6 blocks * 24 hours).

The age in block height is used over the block timestamp because the block timestamp serves as a source of variation when calculating the blockhash and is only accurate to within an hour or two. By using timestamps some UTXOs could be considered older than a previously generated UTXO. By using block-age from current the blockheight, the age of utxos is strictly ordinal as blockheight is strictly sequential.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_utxo_age_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
window string 1d (no support for 1h at this time)
token string btc
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
1-3m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 1 to 3 months prior to this date.
12-18m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 12 to 18 months prior to this date.
18-24m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 18 to 24 months prior to this date.
1d-1w decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 1 day to 1 week prior to this date.
1w-1m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 1 week to 1 month prior to this date.
2-3y decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 2 to 3 years prior to this date.
3-5y decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 3 to 5 years prior to this date.
3-6m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 3 to 6 months prior to this date.
5-10y decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 5 to 10 years prior to this date.
6-12m decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred 6 to 12 months prior to this date.
<1d decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred less than a day prior to this date.
>10y decimal Proportion of bitcoin supply on this date held in unspent outputs (UTXOs) from transactions that occurred greater than 10 years prior to this date.
date string The date in YYYY-MM-DD

BTC Miner Hashrate

curl "https://api.tokenanalyst.io/analytics/private/v1/token_miner_hashrate_window_historical/last?format=json&token=btc&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2019-07-22",
    "miner_name": "F2 Pool",
    "miner_daily_block_count": 19,
    "total_daily_block_count": 322,
    "miner_daily_hashrate": 8561054.749877952,
    "total_daily_hashrate": 71191928.97266929,
    "miner_daily_hashrate_pct": 12.025316455696203
  },
  {
    "date": "2019-07-22",
    "miner_name": "AntPool",
    "miner_daily_block_count": 18,
    "total_daily_block_count": 322,
    "miner_daily_hashrate": 8110472.920937006,
    "total_daily_hashrate": 71191928.97266929,
    "miner_daily_hashrate_pct": 11.392405063291138
  }
]

This endpoint returns the daily and miner specifc hashrates. The total_daily_hashrate and the miner_daily_hashrate are denominated in TH/s. The total_daily_block_count is the total number of blocks mined on a given day, and the miner_daily_block_count are the number of blocks mined by a specific miner. We do not know the identify of all miners and a lot of them are labelled as unkown and grouped together

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_miner_hashrate_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
miner_name string Human readable name of the miner in our database, if known.
miner_daily_block_count integer The total number of blocks mined by the miner on this date
total_daily_block_count integer The total number of blocks mined on the blockchain on this date.
miner_daily_hashrate decimal The hashrate contribution of the given miner for the day. Denominated in Th/s.
total_daily_hashrate decimal The hashrate of the blockchain for the day. Denominated in Th/s.
miner_daily_hashrate_pct decimal The percentage of the daily hashrate contributed by the miner. (miner_daily_hashrate/total_daily_hashrate)*100

BTC Miner Rewards

curl "https://api.tokenanalyst.io/analytics/private/v1/token_miner_hashrate_window_historical/last?format=json&token=btc&window=1d&limit=2&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2019-09-03",
    "miner_name": "BitFury",
    "miner_daily_block_count": 4,
    "miner_daily_hashrate": 2141915.4344,
    "total_daily_block_count": 103,
    "total_daily_hashrate": 55154322.4359,
    "miner_daily_hashrate_pct": 3.8835
  },
  {
    "date": "2019-09-03",
    "miner_name": "Huobi.pool",
    "miner_daily_block_count": 4,
    "miner_daily_hashrate": 2141915.4344,
    "total_daily_block_count": 103,
    "total_daily_hashrate": 55154322.4359,
    "miner_daily_hashrate_pct": 3.8835
  }
]

This endpoint returns the daily coinbase rewards by miner (incl. txn fees). The miner_daily_block_reward is denomiated BTC.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_miner_rewards_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1d only. 1h not supported currently.
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
miner_name string Human readable name of the miner in our database, if known.
miner_daily_block_reward decimal The total amount of block rewards earned by this miner on this date. Denominated in BTC.
miner_daily_block_reward_usd decimal miner_daily_block_reward * price_usd

Ethereum Fundamentals

ETH On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?format=json&token=eth&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-08-07",
    "volume_internal": 39.7,
    "volume_external": 2008602.511431967,
    "volume_gross": 2008642.2114319669,
    "volume_internal_usd": 49.63,
    "volume_external_usd": 2510753.14,
    "volume_gross_usd": 2510802.76
  },
  {
    "date": "2015-08-08",
    "volume_internal": 3568.4341612339426,
    "volume_external": 1681503.1468948552,
    "volume_gross": 1685071.5810560891,
    "volume_internal_usd": 6210.56,
    "volume_external_usd": 2926516.07,
    "volume_gross_usd": 2932726.63
  }
]

This endpoint returns the full historical on-chain volume of Ethereum since it went live in 2015. The volume is separated into 'internal' volume and 'external' volume.

'Internal' transactions are transfers of ETH that are initiated by smart contracts. While contracts can't initiate transactions on their own, when certain functions are called on from the outside, the smart contract can generate transfers of ETH towards multiple addresses (other contracts and non-contract addresses). At TokenAnalyst, we track every function call and event that happens on Ethereum and thus we are able to derive an accurate 'internal' ETH on-chain volume. The 'external' transaction volume is that which can be seen on the surface by looking at the blockchain using standard web3 calls - 'normal' ETH transactions included on each block.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for (in this case eth)
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
volume_internal decimal The total sum of ETH transferred on this date via value transfers initiated by smart contracts (see here for more)
volume_external decimal The total sum of eth transferred in transactions with a timestamp that occurs during this date.
volume_gross decimal volume_internal + volume_external
volume_internal_usd decimal volume_internal * price_usd
volume_external_usd decimal volume_external * price_usd
volume_gross_usd decimal volume_gross * price_usd

ETH On-chain Transaction Count

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?format=json&token=eth&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-08-07",
    "number_of_txns": 1975
  },
  {
    "date": "2015-08-08",
    "number_of_txns": 2036
  },
  {
    "date": "2015-08-09",
    "number_of_txns": 1249
  }
]

This endpoint returns the number of transactions, where ETH value transferred was > 0, on the full historical Ethereum blockchain for every day since its genesis in 2015. This endpoint would exclude smart contract calls or token transfers where 0 ETH was transferred between accounts.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for (in this case eth)
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
number_of_txns integer The number of transactions included in blocks with a timestamp that occurs during this date

ETH Active addresses

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last?&token=eth&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-08-11",
    "active_senders": 2235,
    "active_recipients": 2155
  },
  {
    "date": "2015-08-12",
    "active_senders": 739,
    "active_recipients": 665
  }
]

This endpoint returns the active addresses on the Ethereum blockchain for every day of its existence. An address is defined as 'active' if it has transacted during the given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent ETH in transactions with a timestamp on this date
active_recipients integer The total number of distinct addresses that received ETH in transactions with a timestamp on this date

ETH Supply

curl "https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last?&token=eth&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-07-30",
    "supply": 39311.09375
  },
  {
    "date": "2015-07-31",
    "supply": 75502.8125
  }
]

This endpoint returns the historical supply of ETH on the Ethereum blockchain for every day of its existence.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
supply decimal The cumulative sum of ether (ETH) generated by mining and uncle rewards up to this date

ETH NVT

curl "https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last?&token=eth&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-09-02",
    "marketcap_usd": 98056055.37,
    "nvt": 262.7
  },
  {
    "date": "2015-09-03",
    "marketcap_usd": 91877253.74,
    "nvt": 130.9
  }
]

This endpoint returns the NVT Ratio (Network Value to Transactions Ratio) for ETH. This is the ratio of the Market Cap divided by the volume transmitted by the blockchain. Special thanks to Willy Woo and Chris Burniske for coming up with it!

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
marketcap_usd decimal The total USD market capitalization of ETH on this date. (price_usd * supply)
nvt decimal Ratio comprising the total ETH Market Cap divided by the on-chain volume. (marketcap_usd / volume_external_usd)

ETH Fees

curl "https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last?&token=eth&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2015-10-19",
    "avg_gas": 32831.1236,
    "avg_gas_price_wei": 52456819761.0774,
    "total_fee": 11.699219139604072,
    "total_fee_usd": 5.85,
    "avg_fee": 0.001771535302786807,
    "avg_fee_usd": 0
  },
  {
    "date": "2015-10-20",
    "avg_gas": 32483.8972,
    "avg_gas_price_wei": 53767556518.0802,
    "total_fee": 11.527019798770482,
    "total_fee_usd": 5.65,
    "avg_fee": 0.001954726097807441,
    "avg_fee_usd": 0
  }
]

This endpoint returns the total and average fees spent on the Ethereum network for every day of it's existence. The total_fee and the avg_fee are denominated in ETH.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
avg_gas string The average amount of gas used by transactions that occurred on this date. See here for a detailed definition of gas.
avg_gas_price_wei string The average price (in wei) paid per unit of gas for transactions that occurred on this date
total_fee string The sum of fees paid in transactions that occurred on this date. Denominated in ETH. Fees for a transaction are calculated as such: (gas used * gas price)*10^-18
total_fee_usd string total_fee * price
avg_fee string The average fee paid per transaction that occurred on this date. Denominated in ETH.
avg_fee_usd string avg_fee * price_usd

ETH Miner Hashrate

curl "https://api.tokenanalyst.io/analytics/private/v1/token_miner_hashrate_window_historical/last?format=json&token=eth&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2016-04-07",
    "miner": "0x5bD7a5f263fD5B00Fc8047D581fDBa92E34783b8",
    "miner_name": "Unknown",
    "total_daily_hashrate": 1.6977,
    "miner_daily_hashrate": 0.0006,
    "miner_daily_hashrate_pct": 0.0333,
    "miner_daily_block_count": 2,
    "miner_daily_uncle_count": 0,
    "miner_daily_uncle_pct": 0,
    "total_daily_block_count": 5953,
    "total_daily_uncle_count": 403,
    "total_daily_uncle_pct": 6
  },
  {
    "date": "2016-04-07",
    "miner": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "miner_name": "F2Pool 1",
    "total_daily_hashrate": 1.6977,
    "miner_daily_hashrate": 0.1032,
    "miner_daily_hashrate_pct": 6.0811,
    "miner_daily_block_count": 362,
    "miner_daily_uncle_count": 22,
    "miner_daily_uncle_pct": 5,
    "total_daily_block_count": 5953,
    "total_daily_uncle_count": 403,
    "total_daily_uncle_pct": 6
  }
]

This endpoint returns the total and miner specifc hashrate and uncle rates. The total_daily_hashrate and the miner_daily_hashrate are denominated in TH/s. The total_daily_block_count is the total number of blocks mined on a given day, and the miner_daily_block_count are the number of blocks mined by a specific miner. We do not know the identify of all miners and a lot of them are labelled as unkown

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_miner_hashrate_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
miner string Public key hash (address) of the miner
miner_name string Human readable name of the miner in our database, if known.
total_daily_hashrate decimal The hashrate of the blockchain for the day. Denominated in Th/s.
miner_daily_hashrate decimal The hashrate contribution of the given miner for the day. Denominated in Th/s.
miner_daily_hashrate_pct decimal The percentage of the daily hashrate contributed by the miner. (miner_daily_hashrate/total_daily_hashrate)*100
miner_daily_block_count integer The total number of blocks mined by the miner on this date
miner_daily_uncle_count integer The total number of uncles mined by the miner on this date
miner_daily_uncle_pct decimal (miner_daily_uncle_count/miner_daily_block_count)*100
total_daily_block_count integer The total number of blocks mined on the blockchain on this date.
total_daily_uncle_count integer The total number of uncles mined on the blockchain on this date.
total_daily_uncle_pct decimal (total_daily_uncle_count/total_daily_block_count)*100

ETH Miner Rewards

curl "https://api.tokenanalyst.io/analytics/private/v1/token_miner_rewards_window_historical/last?format=json&token=eth&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2019-07-23",
    "miner_name": "Nanopool",
    "miner_daily_block_reward": 1604.3125,
    "miner_daily_block_reward_usd": 359940.49,
    "miner_daily_uncle_reward": 76,
    "miner_daily_uncle_reward_usd": 17051.22
  },
  {
    "date": "2019-07-23",
    "miner_name": "Spark Pool",
    "miner_daily_block_reward": 3048,
    "miner_daily_block_reward_usd": 683843.47,
    "miner_daily_uncle_reward": 141,
    "miner_daily_uncle_reward_usd": 31634.49
  }
]

This endpoint returns the daily block rewards and uncle rewards by miner. The miner_daily_block_reward and miner_daily_uncle_reward are denomiated ETH.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_miner_rewards_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
miner_name string Human readable name of the miner in our database, if known.
miner_daily_block_reward decimal The total amount of block rewards earned by this miner on this date. Denominated in ETH.
miner_daily_block_reward_usd decimal miner_daily_block_reward * price_usd
miner_daily_uncle_reward decimal The total amount of uncle rewards earned by this miner on this date. Denominated in ETH.
miner_daily_uncle_reward_usd decimal miner_daily_uncle_reward * price_usd

ERC20 Fundamentals

ERC20 tokens we currently support are:

Name Symbol
Maker mkr
Basic Attention Token bat
OmiseGo omg
Augur rep
Golem gnt
ZRX zrx
Zilliqa zil
Decentraland mana
Numerai nmr
Tokencard tkn
Bancor bnt
Loom Network loom
Status snt
Civic cvc
Kyber Network knc
iExec RLC rlc
ChainLink link
Ocean Protocol ocean
Fetch.ai. fet

ERC20 On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?format=json&token=zrx&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2017-08-11",
    "volume": 100001170833,
    "volume_usd": 1305799085
  },
  {
    "date": "2017-08-13",
    "volume": 82753422,
    "volume_usd": 1490913652
  }
]

This endpoint returns the full historical on-chain volume of any of the major ERC20 tokens that we support.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
volume decimal The total sum of ERC20 token sent by addresses in transactions with a timestamp that occurs on this date.
volume_usd decimal volume * price_usd

ERC20 On-chain Transaction Count

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?format=json&token=mana&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2017-09-06",
    "number_of_txns": 4
  },
  {
    "date": "2017-09-15",
    "number_of_txns": 5512
  },
  {
    "date": "2017-09-16",
    "number_of_txns": 4822
  }
]

This endpoint returns the number of token transfers on the blockchain for the given token for every day since its existence.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the transaction count for
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
number_of_txns integer The number of ERC20 transactions included in blocks with a timestamp that occurs on this date

ERC20 Active addresses

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last?&token=gnt&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2016-11-11",
    "active_senders": 23,
    "active_recipients": 31
  },
  {
    "date": "2016-11-12",
    "active_senders": 332,
    "active_recipients": 23
  }
]

This endpoint returns the active addresses of ERC20 tokens for every day of their existence. An address is defined as 'active' if it has transacted during the given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the transaction count for
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent ERC20 tokens in transactions with a timestamp on this date (includes smart contracts)
active_recipients integer The total number of distinct addresses that received ERC20 tokens in transactions with a timestamp on this date (includes smart contracts)

Stablecoin Stats

The stablecoins we currently support are:

Name Symbol
Tether (Omni) usdt_omni
Tether usdt_erc20
USDC usdc
Paxos Standard Token pax
TrueUSD tusd
Gemini Dollar gusd
Dai dai

We have slightly different endpoints for Tether (usdt_omni) due to the nature of OMNI blockchian

Tether (Omni) On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?key=API_KEY&format=json&token=usdt_omni&window=1h"

The above command returns JSON structured like this:

[
  {
    "date": "2018-09-10",
    "hour": "01:00:00", // not available when window 1d
    "datetime": "2018-09-10 01:00:00", // not available when window 1d
    "volume": 759397926.2,
    "volume_usd": 759397926.2
  },
  {
    "date": "2018-09-12",
    "hour": "02:00:00", // not available when window 1d
    "datetime": "2018-09-12 02:00:00", // not available when window 1d
    "volume": 397509639.4,
    "volume_usd": 397509639.4
  }
]

This endpoint returns the full historical on-chain volume of Tether on the OMNI blockchain since it went live on 2014-10-06. Values are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
window string 1h or 1d

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
volume decimal The total sum of Tether (usdt_omni) sent by addresses in transactions with a timestamp that occurs within the window.
volume_usd decimal volume * price_usd

Tether (Omni) On-chain Transaction Count

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?format=json&token=usdt_omni&key=API_KEY&window=1h"

The above command returns JSON structured like this:

[
  {
    "date": "2017-12-18",
    "hour": "01:00:00", // not available when window 1d
    "datetime": "2017-12-18 01:00:00", // not available when window 1d
    "number_of_txns": 311
  },
  {
    "date": "2017-12-18",
    "hour": "02:00:00", // not available when window 1d
    "datetime": "2017-12-18 02:00:00", // not available when window 1d
    "number_of_txns": 411
  },
]

This endpoint returns the daily number of Tether (usdt_omni) transactions on the full Omni blockchain for every day of it's existence 2014-10-06

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
window string 1h or 1d

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
number_of_txns integer The number of stablecoin transactions included in blocks with a timestamp that occurs on this date

Tether (Omni) Active Addresses

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last?&token=usdt_omni&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2019-02-17",
    "active_senders": 5860,
    "active_recipients": 6320
  },
  {
    "date": "2019-02-18",
    "active_senders": 6787,
    "active_recipients": 8347
  }
]

This endpoint returns the active addresses of Tether (usdt_omni) tokens for every day of it's existence since 2014-10-06. An address is defined as 'active' if it has transacted during the given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The stablecoin you want the transaction count for
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent Tether (usdt_omni) in transactions with a timestamp on this date (includes smart contracts)
active_recipients integer The total number of distinct addresses that received Tether (usdt_omni) in transactions with a timestamp on this date (includes smart contracts)

Tether (Omni) Supply

curl "https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last?&token=usdt_omni&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2019-08-14",
    "supply": 2544048400
  },
  {
    "date": "2019-08-15",
    "supply": 2544048400
  }
]

This endpoint returns the historical supply of Tether (usdt_omni) on the OMNI blockchain for every day of it's existence 2014-10-06

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_supply_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
supply decimal The cumulative sum of Tether generated by minting and burning up to this date

Tether (Omni) NVT

curl "https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last?&token=usdt_omni&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date":"2019-08-19",
    "marketcap_usd":2545000000,
    "nvt":9.4907
  },
  {
    "date":"2019-08-20",
    "marketcap_usd":2545000000,
    "nvt":8.6839
  }
]

This endpoint returns the NVT Ratio (Network Value to Transactions Ratio) for Tether (usdt_omni). This is the ratio of the Market Cap divided by the volume transmitted by the blockchain. Special thanks to Willy Woo and Chris Burniske for coming up with it!

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_nvt_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
marketcap_usd decimal The total USD market capitalization of Tether (usdt_omni) on this date. (price_usd * supply)
nvt decimal Ratio comprising the total Tether (usdt_omni) Market Cap divided by the on-chain volume. (marketcap_usd / volume_usd)

Tether (Omni) Fees

curl "https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last?&token=usdt_omni&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2019-08-13",
    "total_fee": 19.5264,
    "total_fee_usd": 19.5264,
    "avg_fee": 0.0003,
    "avg_fee_usd": 0.0003
  },
  {
    "date": "2019-08-14",
    "total_fee": 8.1131,
    "total_fee_usd": 8.1131,
    "avg_fee": 0.0002,
    "avg_fee_usd": 0.0002
  }
]

This endpoint returns the historical supply of Tether (usdt_omni) on the OMNI blockchain for every day of it's existence 2014-10-06

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_fees_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
total_fee decimal The sum of fees paid in transactions that occurred on this date. Denominated in Tether (usdt_omni)
total_fee_usd decimal total_fee * price_usd
avg_fee decimal The average amount of fees paid per transaction that occurred on this date. Denominated in Tether (usdt_omni).
avg_fee_usd decimal avg_fee * price_usd

Stablecoin On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?format=json&token=usdc&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2018-09-10",
    "volume": 22.2,
    "volume_usd": 0.0
  },
  {
    "date": "2018-09-12",
    "volume": 2.5,
    "volume_usd": 0.0
  }
]

This endpoint returns the full historical on-chain volume of any of the stablecoins that we support.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
volume decimal The total sum of Stablecoins sent by addresses in transactions with a timestamp that occurs on this date.
volume_usd decimal volume * price_usd

Stablecoin On-chain Transaction Count

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?format=json&token=dai&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2017-12-18",
    "number_of_txns": 161
  },
  {
    "date": "2017-12-19",
    "number_of_txns": 599
  },
  {
    "date": "2017-12-20",
    "number_of_txns": 515
  }
]

This endpoint returns the number of token transfers on the Ethereum blockchain for the given stablecoin you select for every day of its existence.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The stablecoin you want the transaction count for
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
number_of_txns integer The number of stablecoin transactions included in blocks with a timestamp that occurs on this date

Stablecoin Active addresses

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last?&token=usdc&format=json&key=API_KEY&window=1d"

The above command returns JSON structured like this:

[
  {
    "date": "2016-11-11",
    "active_senders": 23,
    "active_recipients": 31
  },
  {
    "date": "2016-11-12",
    "active_senders": 332,
    "active_recipients": 23
  }
]

This endpoint returns the active addresses of stabelecoin tokens for every day of their existence. An address is defined as 'active' if it has transacted during the given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_window_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The stablecoin you want the transaction count for
window string 1d (no support for 1h at this time)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent Stablecoins in transactions with a timestamp on this date (includes smart contracts)
active_recipients integer The total number of distinct addresses that received Stablecoins in transactions with a timestamp on this date (includes smart contracts)

Binance Token Stats [BETA]

We support all tokens issued on Binance chain, but only have price data for the following:

Name Symbol
Binance Coin bnb
Stable USD usdsb
Harmony.One one
Bitcoin BEP2 btcb
Bezant bznt
Ankr ankr
Mithril mith
Fantom ftm

BEP2 On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_historical/last?format=json&token=mith&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2017-08-11",
    "volume": 100001170833,
    "price_usd": 0.11,
    "volume_usd": 1305799085
  },
  {
    "date": "2017-08-13",
    "volume": 82753422,
    "price_usd": 0.18,
    "volume_usd": 1490913652
  }
]

This endpoint returns the full historical on-chain volume of all BEP2 tokens. Note, wo don't have price data for all the tokens

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_volume_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the volume for

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
volume decimal The total sum of the BEP2 token sent by addresses in transactions with a timestamp that occurs on this date.
price_usd decimal The daily average price of specified BEP2 token in USD (the daily mean of minute-level price data)
volume_usd decimal volume * price_usd

BEP2 On-chain Transaction Count

curl "https://api.tokenanalyst.io/analytics/private/v1/token_count_historical/last?format=json&token=bnb&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2017-09-06",
    "number_of_txns": 4
  },
  {
    "date": "2017-09-15",
    "number_of_txns": 5512
  },
  {
    "date": "2017-09-16",
    "number_of_txns": 4822
  }
]

This endpoint returns the full historical on-chain transaction count of all BEP2 tokens

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_count_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the transaction count for

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
number_of_txns integer The number of BEP2 token transactions for the specified token included in blocks with a timestamp that occurs on this date

BEP2 Active addresses

curl "https://api.tokenanalyst.io/analytics/private/v1/token_active_address_historical/last?&token=ankr&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2016-11-11",
    "active_senders": 23,
    "active_receipients": 31
  },
  {
    "date": "2016-11-12",
    "active_senders": 332,
    "active_receipients": 23
  }
]

This endpoint returns the active addresses of BEP2 tokens for every day of their existence. An address is defined as 'active' if it has transacted during the given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_active_address_historical/last

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string The token you want the transaction count for
Field Type Description
date string The date in YYYY-MM-DD
active_senders integer The total number of distinct addresses that sent the specified BEP2 token in transactions with a timestamp on this date
active_recipients integer The total number of distinct addresses that received the specified BEP2 token in transactions with a timestamp on this date

Bitcoin Exchange Flows

For Bitcoin currently supported exchanges are: binance, bittrex, bitstamp, poloniex, bitmex, bitfinex

BTC Full Historical Inflow to Exchanges

This endpoint returns the inflow of BTC into exchange wallets for as far back as we track. The average inflow is the average transaction value for transactions flowing into exchange wallets on a given day.

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?format=json&token=btc&exchange=binance&direction=inflow&window=1h&limit=2&key=API_KEY"

The response looks like:

[
  {
    "date": "2019-09-03",
    "hour": "14:00:00", // not available when window 1d
    "datetime": "2019-09-03 14:00:00", // not available when window 1d
    "avg_txn_value": 1.81428269,
    "avg_txn_value_usd": 19438.16,
    "inflow": 344.71371202,
    "inflow_usd": 3693250.26,
    "number_of_entity_receiving_addresses": 185,
    "number_of_nonentity_sending_addresses": 547,
    "number_of_txns": 190
  },
  {
    "date": "2019-09-03",
    "hour": "15:00:00", // not available when window 1d
    "datetime": "2019-09-03 15:00:00", // not available when window 1d
    "avg_txn_value": 0.48022623,
    "avg_txn_value_usd": 5109.47,
    "inflow": 46.58194403,
    "inflow_usd": 495618.65,
    "number_of_entity_receiving_addresses": 109,
    "number_of_nonentity_sending_addresses": 224,
    "number_of_txns": 97
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
direction string Either inflow or outflow (in this case inflow)
exchange string An exchange from the list of ones we support
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
avg_txn_value decimal The average amount BTC transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of BTC transferred per transaction into the given exchange on this date.
date string The date in YYYY-MM-DD
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
inflow decimal The total amount of BTC that flowed into the entity on this date. Denominated in BTC.
inflow_usd decimal The USD value of the total amount of BTC that flowed into the exchange on this date
number_of_entity_receiving_addresses integer The distinct number of wallets identified as belonging to the exchange in question that were on the receiving side of a transaction (where no wallets identified as belonging to the exchange were senders) on this date.
number_of_nonentity_sending_addresses integer The distinct number of wallets (that don't belong to the exchange in question) that sent Bitcoin to wallets identified as belonging to this exchange on this date.
number_of_txns integer The number of transactions sending BTC into this exchange on this date.

BTC Full Historical Outflows from Exchanges

This endpoint returns the outflow of BTC from exchange wallets for as far back as we track. The average outflow is the average transaction value for transactions flowing out of exchange wallets on a given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?

This is an example:

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?token=btc&exchange=binance&direction=outflow&window=1h&format=json&limit=2&key=API_KEY"

The response looks like:

[
  {
    "avg_txn_value": 26.73,
    "avg_txn_value_usd": 69375.93,
    "date": "2019-09-03",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2019-09-03 11:00:00", // not available when window 1d
    "number_of_entity_sending_addresses": 23,
    "number_of_nonentity_receiving_addresses": 1,
    "number_of_txns": 3,
    "outflow": 26.73,
    "outflow_usd": 69375.93
  },
  {
    "avg_txn_value": 102.48,
    "avg_txn_value_usd": 241881.49,
    "date": "2019-09-04",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2019-09-04 11:00:00", // not available when window 1d
    "number_of_entity_sending_addresses": 77,
    "number_of_nonentity_receiving_addresses": 1,
    "number_of_txns": 2,
    "outflow": 102.48,
    "outflow_usd": 241881.49
  }
]

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
direction string Either inflow or outflow (in this case outflow)
exchange string An exchange from the list of ones we support
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
avg_txn_value decimal The average amount BTC transferred per transaction out of the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of BTC transferred per transaction out of the given exchange on this date.
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
number_of_entity_sending_addresses integer The distinct number of wallets identified as belonging to the exchange in question that were on the sending side of a transaction (where no wallets identified as belonging to the exchange were receivers) on this date.
number_of_nonentity_receiving_addresses integer The distinct number of wallets (that don't to the exchange in question) that received Bitcoin from wallets identified as belonging to this exchange on this date.
number_of_txns decimal The number of transactions sending BTC out of this exchange on this date.
outflow decimal The total amount of BTC that flowed out of the entity on this date. Denominated in BTC.
outflow_usd decimal The USD value of the total amount of BTC that flowed out of the exchange on this date

BTC Full Historical Top 10 Inflow Large Value Transactions

This endpoint returns the top 10 transactions (in terms of total BTC sent) flowing into exchange wallets for every day that the exchange wallets we track have been live on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?format=json&token=btc&exchange=bitmex&direction=inflow&window=1d&limit=2&from_date=2019-02-02&to_date=2019-02-08&key=API_KEY"

This is what the response looks like

[
  {
    "date": "2019-02-08",
    "transactionid": "ea6a036eb69f0b3c47ce27cc77a59270d2c0dc99342cdd5f4dcc41cfa1c98298",
    "transaction_datetime": "2019-02-08 16:50:54",
    "rank": 9,
    "value": 50,
    "value_usd": 174539.71
  },
  {
    "date": "2019-02-08",
    "transactionid": "310ff316a1f8d887be851dfaaa14cb829f4d4d225a416ce7cd74a0c032d03c98",
    "transaction_datetime": "2019-02-08 17:21:24",
    "rank": 10,
    "value": 50,
    "value_usd": 174539.71
  }
]

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
direction string inflow
exchange string An exchange from the list of ones we support
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
entity string The name of the exchange in question
rank integer Ranking out of 10 for the 10 largest transactions of BTC flowing into the exchange in question on this date.
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
transactionhash string The transaction hash of the transaction in question.
transactionid string The transaction id of the transaction in question.
value decimal The amount of BTC transferred in this transaction.
value_usd decimal The value in USD of the amount of BTC tranferred in this transaction.

BTC Full Historical Top 10 Outflow Large Value Transactions

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?format=json&token=btc&exchange=bitmex&direction=outflow&window=1d&limit=2&from_date=2019-02-02&to_date=2019-02-08&key=API_KEY"

This is what the response looks like

[
  {
    "date": "2019-02-08",
    "transactionid": "bdf372897349b7103ed48c56e6bf0cfd44df854b4e3fc6cb6ce6b106360d0c2f",
    "transaction_datetime": "2019-02-08 18:50:53",
    "rank": 9,
    "value": 8,
    "value_usd": 27926.35
  },
  {
    "date": "2019-02-08",
    "transactionid": "fcca2b0d59d640c5ba6bade0c32936d4ad512865b5e9e602ddce1da745d589e2",
    "transaction_datetime": "2019-02-08 18:50:53",
    "rank": 10,
    "value": 7.71,
    "value_usd": 26897.2
  }
]

This endpoint returns the top 10 transactions (in terms of total BTC sent) flowing out of exchange wallets for every day that the exchange wallets we track have been live on the blockchain. Note: Currently Bitstamp and Binance are not supported for this endpoint

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
direction string outflow
exchange string An exchange from the list of ones we support
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Note: All params with a * are optional and limit is only available in the JSON return format

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
entity string The name of the exchange in question
rank integer Ranking out of 10 for the 10 largest transactions of BTC flowing out of the exchange in question on this date.
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
transactionhash string The transaction hash of the transaction in question.
transactionid string The transaction id of the transaction in question.
value decimal The amount of BTC transferred in this transaction.
value_usd decimal The value in USD of the amount of BTC tranferred in this transaction.

Ethereum Exchange Flows

For Ethereum currently supported exchanges are: binance, kraken, bitfinex, poloniex, bittrex, kucoin

ETH Full Historical Flows Into Exchanges

This is an example:

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?token=eth&exchange=binance&direction=inflow&window=1h&format=json&key=API_KEY"

The response looks like:

[
  {
    "date": "2016-03-17",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2016-03-17 11:00:00", // not available when window 1d
    "inflow": 1.8164,
    "inflow_usd": 21.14,
    "number_of_txns": 8,
    "avg_txn_value": 0.22705,
    "avg_txn_value_usd": 2.64
  },
  {
    "date": "2016-03-18",
    "hour": "12:00:00", // not available when window 1d
    "datetime": "2016-03-18 12:00:00", // not available when window 1d
    "inflow": 3.7594499999999997,
    "inflow_usd": 38.38,
    "number_of_txns": 5,
    "avg_txn_value": 0.75189,
    "avg_txn_value_usd": 7.68
  }
]

This endpoint returns the inflow of ETH into exchange wallets. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/last/exchange_flow_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
direction string inflow
exchange string An exchange from the list of ones we support
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
inflow decimal The total amount of ETH that flowed into the exchange on this date. Denominated in ETH.
inflow_usd decimal The USD value of the total amount of ETH that flowed into the exchange on this date
number_of_txns integer The number of transactions sending ETH into this exchange on this date.
avg_txn_value decimal The average amount ETH transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of ETH transferred per transaction into the given exchange on this date.

ETH Full Historical Flows Out Of Exchanges

This is an example:

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?token=eth&exchange=binance&direction=outflow&window=1h&format=json&key=API_KEY"

The response looks like:

[
  {
    "date": "2016-03-17",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2016-03-17 11:00:00", // not available when window 1d
    "outflow": 1.8164,
    "outflow_usd": 21.14,
    "number_of_txns": 8,
    "avg_txn_value": 0.22705,
    "avg_txn_value_usd": 2.64
  },
  {
    "date": "2016-03-18",
    "hour": "12:00:00", // not available when window 1d
    "datetime": "2016-03-18 12:00:00", // not available when window 1d
    "outflow": 3.7594499999999997,
    "outflow_usd": 38.38,
    "number_of_txns": 5,
    "avg_txn_value": 0.75189,
    "avg_txn_value_usd": 7.68
  }
]

This endpoint returns the outflow of ETH from exchange wallets. The avg_txn_value, outflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/last/exchange_flow_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
direction string outflow
exchange string An exchange from the list of ones we support
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
outflow decimal The total amount of ETH that flowed out of the exchange on this date. Denominated in ETH.
outflow_usd decimal The USD value of the total amount of ETH that flowed out of the exchange on this date
number_of_txns integer The number of transactions sending ETH out of this exchange on this date.
avg_txn_value decimal The average amount ETH transferred per transaction out of the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of ETH transferred per transaction out of the given exchange on this date.

ETH Full Historical Top 10 Inflow Large Value Transactions

This is an example:

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_historical/last?token=eth&exchange=binance&direction=inflow&format=json&key=API_KEY"

The response looks like:

[
  {
    "transactionhash": "0x8f4e1350eaa1c13360ea4a5269a1a350f3c5b3880147d0aa32ec34a12fc30923",
    "value": 3424.6575,
    "date": "2019-04-29",
    "transaction_datetime": "2019-04-29 09:13:57",
    "rank": 2,
    "value_usd": 537210.85
  },
  {
    "transactionhash": "0x5512d27b371bfbef2fc6dae353fb243866fe3dfb24ad546d6b6eebb4159fb7c2",
    "value": 3000.0,
    "date": "2019-04-29",
    "transaction_datetime": "2019-04-29 04:50:08",
    "rank": 3,
    "value_usd": 470596.71
  }
]

This endpoint returns the top 10 transactions (in terms of total ETH sent) flowing into exchange wallets for every day that the exchange wallets we track have been live on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
direction string inflow
exchange string An exchange from the list of ones we support
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
transactionhash string The transaction hash of the transaction in question.
value decimal The amount of ETH transferred in this transaction.
date string The date in YYYY-MM-DD
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
rank integer Ranking out of 10 for the 10 largest ETH transactions flowing into the exchange in question on this date.
value_usd decimal The value in USD of the amount of ETH tranferred in this transaction.

ETH Full Historical Top 10 Outflow Large Value Transactions

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_historical/last?token=eth&exchange=binance&direction=outflow&format=json&key=API_KEY"

The response looks like:

[
  {
    "transactionhash": "0x97b8063962d549b053cf7366e70877f09ede29f5e2d5bd9837e5a9ea8089bb46",
    "value": 7300.00024,
    "date": "2019-04-26",
    "transaction_datetime": "2019-04-26 09:03:53",
    "rank": 3,
    "value_usd": 1129368.16
  },
  {
    "transactionhash": "0x0e3d275eeae64b27ccbb12b65861039a7c3662c0c99212f88b9927c41b37bbae",
    "value": 5982.0288,
    "date": "2019-04-26",
    "transaction_datetime": "2019-04-26 04:02:49",
    "rank": 4,
    "value_usd": 925467.48
  }
]

This endpoint returns the top 10 transactions (in terms of total ETH sent) flowing out of exchange wallets for every day that the exchange wallets we track have been live on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string eth
direction string outflow
exchange string An exchange from the list of ones we support
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
transactionhash string The transaction hash of the transaction in question.
value decimal The amount of ETH transferred in this transaction.
date string The date in YYYY-MM-DD
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
rank integer Ranking out of 10 for the 10 largest ETH transactions flowing out of the exchange in question on this date.
value_usd decimal The value in USD of the amount of ETH tranferred in this transaction.

Stablecoin Exchange Flows

The stablecoins we currently support are:

Name Symbol
Tether (Omni) usdt_omni
Tether (ERC20) usdt_erc20
USDC usdc
Paxos Standard Token pax
TrueUSD tusd
Gemini Dollar gusd
Dai dai

For Tether (Omni), currently supported exchanges are: kraken, bitfinex, poloniex, bittrex, okex

For ERC20 Stablecoins, currently supported exchanges are: binance, kraken, bitfinex, poloniex, bittrex, kucoin

Tether (Omni) Full Historical Inflow from Exchanges

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?format=json&window=1d&token=usdt_omni&exchange=kraken&direction=inflow&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2019-08-16",
    "inflow": 2760452.458,
    "inflow_usd": 2760452.46,
    "number_of_txns": 26,
    "avg_txn_value": 106171.2484,
    "avg_txn_value_usd": 106171.25
  },
  {
    "date": "2019-08-17",
    "inflow": 97184.7667,
    "inflow_usd": 97184.76,
    "number_of_txns": 10,
    "avg_txn_value": 9718.4767,
    "avg_txn_value_usd": 9718.48
  }
]

This endpoint returns the inflow of USDT (Tether) on the Omni blockchain into exchange wallets. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
exchange string An exchange from the list of ones we support
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field that only appears if the window=1h is used.
inflow decimal The total amount of the token that flowed into the exchange on this date. Denominated in the token in question.
inflow_usd decimal The USD value of the total amount of the token that flowed into the exchange on this date
number_of_txns integer The number of transactions sending the token into this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction into the given exchange on this date.

Tether (Omni) Full Historical Outflow from Exchanges

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?format=json&window=1d&token=usdt_omni&exchange=huobi&direction=outflow&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2018-09-26",
    "outflow": 11148431.05,
    "outflow_usd": 11137036.46,
    "number_of_txns": 465,
    "avg_txn_value": 23975.1205,
    "avg_txn_value_usd": 23950.62
  },
  {
    "date": "2018-09-27",
    "outflow": 15456621.51,
    "outflow_usd": 15426543.13,
    "number_of_txns": 436,
    "avg_txn_value": 35450.9668,
    "avg_txn_value_usd": 35381.98
  }
]

This endpoint returns the inflow of USDT (Tether) on the Omni blockchain into exchange wallets. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
exchange string An exchange from the list of ones we support
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field that only appears if the window=1h is used.
inflow decimal The total amount of the token that flowed into the exchange on this date. Denominated in the token in question.
inflow_usd decimal The USD value of the total amount of the token that flowed into the exchange on this date
number_of_txns integer The number of transactions sending the token into this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction into the given exchange on this date.

Tether (Omni) Full Historical Top 10 Inflow Large Value Transactions

This is an example:

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?token=usdt_omni&exchange=binance&direction=inflow&format=json&key=API_KEY&window=1d"

The response looks like:

[
  {
    "date": "2019-08-18",
    "transactionid": "5e5c74b0aab078c929952f9de0155d32152c0dc7c65c8cfdc53c2c0ed1a4d720",
    "transaction_datetime": "2019-08-18 04:48:59",
    "value": 34000,
    "rank": 9,
    "value_usd": 34001.93
  },
  {
    "date": "2019-08-18",
    "transactionid": "84801e2b0fa58093fa74b997a3bfd936b598c91ff1d9f16cf55b8d294ff2c672",
    "transaction_datetime": "2019-08-18 18:50:19",
    "value": 33283,
    "rank": 10,
    "value_usd": 33284.88
  }
]

This endpoint returns the top 10 transactions (in terms of total USDT sent) flowing into exchange wallets for every day that the exchange wallets we track have been live on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
direction string inflow
exchange string An exchange from the list of ones we support
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
transactionid string The transaction id of the transaction in question.
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
value decimal The amount of USDT transferred in this transaction.
rank integer Ranking out of 10 for the 10 largest USDT (Omni) transactions flowing into the exchange in question on this date.
value_usd decimal The value in USD of the amount of USDT tranferred in this transaction.

Tether (Omni) Full Historical Top 10 Outflow Large Value Transactions

curl "https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?token=usdt_omni&exchange=binance&direction=outflow&format=json&key=API_KEY"

The response looks like:

[
  {
    "date": "2019-08-14",
    "transactionid": "5354b702a372027cc23bb9c47749bdfab77c9d7739f8afafcf49178bc6659a2b",
    "transaction_datetime": "2019-08-14 17:23:03",
    "value": 129985,
    "rank": 3,
    "value_usd": 129985
  },
  {
    "date": "2019-08-14",
    "transactionid": "7a91a7b4eabe7b0d0e77139ea1ed7eaecd6d45d82f7b789aae41617cfcdcf026",
    "transaction_datetime": "2019-08-14 16:37:27",
    "value": 100090,
    "rank": 4,
    "value_usd": 100090
  }
]

This endpoint returns the top 10 transactions (in terms of total USDT sent) flowing out of exchange wallets for every day that the exchange wallets we track have been live on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_top10_window_historical/last?

URL Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdt_omni
direction string outflow
exchange string An exchange from the list of ones we support
window string 1d (no support for 1h at this time)
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
transactionid string The transaction id of the transaction in question.
transaction_datetime string The timestamp in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone) when the transaction was mined
value decimal The amount of USDT transferred in this transaction.
rank integer Ranking out of 10 for the 10 largest USDT (Omni) transactions flowing into the exchange in question on this date.
value_usd decimal The value in USD of the amount of USDT tranferred in this transaction.

ERC20 Stablecoin Full Historical Inflow from Exchanges

curl "https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?token=usdc&direction=inflow&window=1h&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2018-11-06",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2018-11-06 11:00:00", // not available when window 1d
    "token_name": "USDC",
    "exchange": "Binance",
    "inflow": 509.689581,
    "inflow_usd": 511.09,
    "number_of_txns": 3,
    "avg_txn_value": 169.896527,
    "avg_txn_value_usd": 170.36
  },
  {
    "date": "2018-11-07",
    "hour": "12:00:00", // not available when window 1d
    "datetime": "2018-11-07 12:00:00", // not available when window 1d
    "token_name": "USDC",
    "exchange": "Kucoin",
    "inflow": 3585.887836,
    "inflow_usd": 3609.0,
    "number_of_txns": 3,
    "avg_txn_value": 1195.2959453333333,
    "avg_txn_value_usd": 1203.0
  }
]

This endpoint returns the inflow of stablecoins into exchange wallets. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC. As a reminder, the exchanges we support for this endpoint are: binance, kraken, bitfinex, poloniex, bittrex, kucoin.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdc
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
token_name string The name of the token in question
exchange string The name of the exchange in question
inflow decimal The total amount of the token that flowed into the exchange on this date. Denominated in the token in question.
inflow_usd decimal The USD value of the total amount of the token that flowed into the exchange on this date
number_of_txns integer The number of transactions sending the token into this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction into the given exchange on this date.

ERC20 Stablecoin Full Historical Outflow from Exchanges

curl "https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?token=usdc&direction=outflow&window=1h&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2018-11-06",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2018-11-06 11:00:00", // not available when window 1d
    "token_name": "USDC",
    "exchange": "Kucoin",
    "outflow": 509.689581,
    "outflow_usd": 511.09,
    "number_of_txns": 3,
    "avg_txn_value": 169.896527,
    "avg_txn_value_usd": 170.36
  },
  {
    "date": "2018-11-07",
    "hour": "12:00:00", // not available when window 1d
    "datetime": "2018-11-07 12:00:00", // not available when window 1d
    "token_name": "USDC",
    "exchange": "Kucoin",
    "outflow": 3585.887836,
    "outflow_usd": 3609.0,
    "number_of_txns": 3,
    "avg_txn_value": 1195.2959453333333,
    "avg_txn_value_usd": 1203.0
  }
]

This endpoint returns the outflow of stablecoins from exchange wallets. The avg_txn_value, outflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string usdc
direction string outflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
token_name string The name of the token in question
exchange string The name of the exchange in question
outflow decimal The total amount of the token that flowed out of the exchange on this date. Denominated in the token in question.
outflow_usd decimal The USD value of the total amount of the token that flowed out of the exchange on this date
number_of_txns integer The number of transactions sending the token out of this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction out of the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction out of the given exchange on this date.

ERC20 Exchange Flows

ERC20 tokens we currently support are:

Name Symbol
Maker mkr
Basic Attention Token bat
OmiseGo omg
Augur rep
Golem gnt
ZRX zrx
Zilliqa zil
Decentraland mana
Numerai nmr
Tokencard tkn
Bancor bnt
Loom Network loom
Status snt
Civic cvc
Kyber Network knc
iExec RLC rlc
ChainLink link
Fetch.ai. fet

ERC20 Full Historical Inflow to Exchanges (with 1 hour granularity)

curl "https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?token=omg&direction=inflow&window=1h&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2017-07-19",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2017-07-19 11:00:00", // not available when window 1d
    "token_name": "OMG",
    "exchange": "Bitfinex",
    "inflow": 1021328.4514801201,
    "inflow_usd": 695260.83,
    "number_of_txns": 46,
    "avg_txn_value": 22202.79242348087,
    "avg_txn_value_usd": 15114.37
  },
  {
    "date": "2017-07-19",
    "hour": "12:00:00", // not available when window 1d
    "datetime": "2017-07-19 12:00:00", // not available when window 1d
    "token_name": "OMG",
    "exchange": "Bittrex",
    "inflow": 2440563.297567261,
    "inflow_usd": 1661393.13,
    "number_of_txns": 198,
    "avg_txn_value": 12326.077260440712,
    "avg_txn_value_usd": 8390.87
  }
]

This endpoint returns the inflow of ERC20 into exchange wallets. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string omg
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
token_name string The name of the token in question
exchange string The name of the exchange in question
inflow decimal The total amount of the token that flowed into the exchange on this date. Denominated in the token in question.
inflow_usd decimal The USD value of the total amount of the token that flowed into the exchange on this date
number_of_txns integer The number of transactions sending the token into this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction into the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction into the given exchange on this date.

ERC20 Full Historical Outflow from Exchanges (with 1 hour granularity)

curl "https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?token=omg&direction=outflow&window=1h&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2017-07-19",
    "hour": "11:00:00", // not available when window 1d
    "datetime": "2017-07-19 11:00:00", // not available when window 1d
    "token_name": "OMG",
    "exchange": "Bitfinex",
    "outflow": 1021328.4514801201,
    "outflow_usd": 695260.83,
    "number_of_txns": 46,
    "avg_txn_value": 22202.79242348087,
    "avg_txn_value_usd": 15114.37
  },
  {
    "date": "2017-07-19",
    "hour": "12:00:00",
    "datetime": "2017-07-19 12:00:00", // not available when window 1d
    "token_name": "OMG",
    "exchange": "Bittrex",
    "outflow": 2440563.297567261,
    "outflow_usd": 1661393.13,
    "number_of_txns": 198,
    "avg_txn_value": 12326.077260440712,
    "avg_txn_value_usd": 8390.87
  }
]

This endpoint returns the outflow of ERC20 from exchange wallets. The avg_txn_value, outflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string omg
direction string outflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
token_name string The name of the token in question
exchange string The name of the exchange in question
outflow decimal The total amount of the token that flowed out of the exchange on this date. Denominated in the token in question.
outflow_usd decimal The USD value of the total amount of the token that flowed out of the exchange on this date
number_of_txns integer The number of transactions sending the token out of this exchange on this date.
avg_txn_value decimal The average amount of tokens transferred per transaction out of the given exchange on this date.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction out of the given exchange on this date.

Miner Flows

Miner Full Historical Inflow

curl "https://api.tokenanalyst.io/analytics/private/v1/miner_flow_window_historical/last?token=btc&direction=inflow&window=1h&from_date=2019-02-07&to_date=2019-02-08&format=json&limit=2&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "avg_txn_value": 12.64279457,
    "avg_txn_value_usd": 46273.01,
    "date": "2019-02-08",
    "datetime": "2019-02-08 23:00:00.000", // not available when window 1d
    "hour": "23:00:00", // not available when window 1d
    "inflow": 12.64279457,
    "inflow_usd": 46273.01,
    "miner_name": "BTC.TOP",
    "number_of_txns": 1
  },
  {
    "avg_txn_value": 12.6999408,
    "avg_txn_value_usd": 46482.16,
    "date": "2019-02-08",
    "datetime": "2019-02-08 23:00:00.000", // not available when window 1d
    "hour": "23:00:00", // not available when window 1d
    "inflow": 25.39988161,
    "inflow_usd": 92964.33,
    "miner_name": "F2 Pool",
    "number_of_txns": 2
  }
]

This endpoint returns the inflow of a given token into miner controlled wallets (that we have labelled) during the time period specified. The avg_txn_value, inflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/miner_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc (only btc supported for now)
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
avg_txn_value decimal The average amount of tokens transferred per transaction into the given miner on this date/hour.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction into the given miner on this date/hour.
date string The date in YYYY-MM-DD
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
inflow decimal The total amount of the token that flowed into the miner on this date/hour. Denominated in the token in question.
inflow_usd decimal The USD value of the total amount of the token that flowed into the miner on this date/hour
miner_name string The name of the miner or mining pool in question
number_of_txns integer The number of transactions sending the token into this miner on this date/hour.

Miner Full Historical Outflow

curl "https://api.tokenanalyst.io/analytics/private/v1/miner_flow_window_historical/last?token=btc&direction=outflow&window=1h&from_date=2019-02-07&to_date=2019-02-08&format=json&limit=2&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2019-02-08",
    "datetime": "2019-02-08 20:00:00.000", // not available when window 1d
    "hour": "20:00:00", // not available when window 1d
    "miner_name": "SlushPool",
    "outflow": 12.51808781,
    "number_of_txns": 1,
    "avg_txn_value": 12.51808781,
    "outflow_usd": 45818.33,
    "avg_txn_value_usd": 45818.33
  },
  {
    "date": "2019-02-08",
    "datetime": "2019-02-08 21:00:00.000", // not available when window 1d
    "hour": "21:00:00", // not available when window 1d
    "miner_name": "SlushPool",
    "outflow": 38.15583246,
    "number_of_txns": 2,
    "avg_txn_value": 19.07791623,
    "outflow_usd": 138582.75,
    "avg_txn_value_usd": 69291.37
  }
]

This endpoint returns the outflow of a given token out of miner controlled wallets (that we have labelled) during the time period specified. The avg_txn_value, outflow, and number_of_txns are calculated over the window (either 1 hour or 1 day). hour is in UTC

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/miner_flow_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc (only btc supported for now)
direction string inflow
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
avg_txn_value decimal The average amount of tokens transferred per transaction out of the given miner on this date/hour.
avg_txn_value_usd decimal The USD value of the average amount of tokens transferred per transaction out of the given miner on this date/hour.
date string The date in YYYY-MM-DD
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
outflow decimal The total amount of the token that flowed out of the miner on this date/hour. Denominated in the token in question.
outflow_usd decimal The USD value of the total amount of the token that flowed out of the miner on this date/hour
miner_name string The name of the miner or mining pool in question
number_of_txns integer The number of transactions sending the token out of this miner on this date/hour.

Prices (USD)

The US Dollar (USD) price of each asset we support is available through this endpoint. The mean hourly and daily price is available for each asset.

The list of assets we currently support is:

Name API Parameter
Basic Attention Token bat
Bitcoin Cash bch
Binance Coin bnb
Bancor bnt
Bitcoin btc
Bitcoin BEP2 (Binance Chain) btcb
Bezant bznt
Civic cvc
Dai dai
Ethereum Classic etc
Ethereum eth
Fetch fet
Fantom ftm
Golem gnt
Gemini Dollar gusd
ICON icx
Kyber Network knc
Chainlink link
Loom Network loom
Litecoin ltc
Decentraland mana
Matic Network matic
Mithril mith
Maker mkr
Numeraire nmr
OmiseGO omg
1Coin one
Paxos Standard Token pax
Augur rep
iExec rlc
Status snt
Storj storj
Monolith tkn
TrueUSD tusd
USD Coin usdc
StableUSD (Binance chain) usdsb
Tether usdt_erc20
Monero xmr
Ripple xrp
Zcash zec
Zilliqa zil
0x zrx

curl "https://api.tokenanalyst.io/analytics/private/v1/token_price_usd_window_historical/last?token=btc&window=1h&format=json&key=API_KEY"

The above command returns JSON structured like this:

[
  {
    "date": "2017-12-27",
    "hour": "05:00:00", // not available when window 1d
    "datetime": "2017-12-27 05:00:00", // not available when window 1d
    "price_usd": 16416.71,
  },
  {
    "date": "2017-12-28",
    "hour": "06:00:00", // not available when window 1d
    "datetime": "2017-12-27 06:00:00", // not available when window 1d
    "price_usd": 13868.98,
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_price_usd_window_historical/last?

Query Parameters

Parameter Type Description
key string Your unique API key
format string What format you want your data in (json or csv)
token string btc
window string 1h or 1d
from_date * string Start date of returned data specified as YYYY-MM-DD (ISO date format)
to_date * string End date of returned data specified as YYYY-MM-DD (ISO date format)
limit * integer The number of entries returned before the latest data point (or the to_date if specified)

Data Overview

Field Type Description
date string The date in YYYY-MM-DD
datetime * string The hour of the day in datetime format YYYY-MM-DD HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
hour * string The hour of the day in HH:MM:SS (UTC time zone). This is an optional field field and appears when window is 1h
price_usd decimal The daily price of the token in USD (the hourly or daily mean of minute-level price data)

Websocket Feed [BETA]

The TokenAnalyst websocket feed provides real-time (with 3 blocks confirmation) bitcoin inflows and outflows to/from exchanges that we have labelled.

ws://ws.tokenanalyst.io:8000

Subscribing to the above URL returns JSON structured like this:

[
  {
    "blockNumber": 595307,
    "blockHash": "000000000000000000165c78ea45068c6ed0308dd7c5295608cd2ec5bf1a7c34",
    "transactionId": "eb98ab622365d63daf6baf5c9f02eaf52eefcbab78d25932b1d8bbd1725db647",
    "timestamp": 1568735726,
    "from": ["1JBRJFRBDEgNEiXkgRR7cGyi7c1W3r1NPd"],
    "to": ["Bitmex"],
    "value": 0.00026469,
    "flowType": "Inflow"
  },
  {
    "blockNumber": 595307,
    "blockHash": "000000000000000000165c78ea45068c6ed0308dd7c5295608cd2ec5bf1a7c34",
    "transactionId": "5bbe6732e5d191e12b9d005968fff9a40c74ebf16dd6295b7c84128112cf2096",
    "timestamp": 1568735726,
    "from": [
      "13UfH12GBuvmACQUy54fTKx8ScsoSySK6b",
      "1HUJCVmBGFNw5229uyg8GjRztzX1krocyj"
    ],
    "to": ["Binance"],
    "value": 0.04793434,
    "flowType": "Inflow"
  }
]

URL

ws://ws.tokenanalyst.io:8000

WS Data Overview

Field Type Description
blockNumber integer The block number where this transaction occurred
blockHash string The hash of the block where this transaction occurred
transactionId string The id of the transaction in question
timestamp integer Unix timestamp of the transaction in question
from [string] A list of sending public key hashes (if infow) or exchange names (if outfow)
to [string] A list of receiving public key hashes (if outflow) or exchange names (if inflow)
value decimal The total amount of BTC sent in the transaction
flowType string One of either Inflow, Outflow, or IntraFlow (if funds flow within exchange wallets)