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

Bitcoin Fundamentals

BTC On-chain Volume

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

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

The above command returns JSON structured like this:

[
  {
    "date": "2009-04-13",
    "volume_gross": 50.0,
    "volume_change": 40.0,
    "volume_real": 10.0,
    "price_usd": "",
    "volume_real_usd": "",
    "volume_change_usd": ""
  },
  {
    "date": "2009-04-18",
    "volume_gross": 182.51,
    "volume_change": 17.49,
    "volume_real": 165.01999999999998,
    "price_usd": "",
    "volume_real_usd": "",
    "volume_change_usd": ""
  }
]

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.

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 (in this case btc)

BTC On-chain Transaction Count

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

The above command returns JSON structured like this:

[
  {
    "date": "2009-03-12",
    "number_of_txns": 119
  },
  {
    "date": "2009-03-13",
    "number_of_txns": 114
  },
  {
    "date": "2009-03-14",
    "number_of_txns": 110
  }
]

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

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 volume for (in this case btc)

BTC Active addresses

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

The above command returns JSON structured like this:

[
  {
    "date": "2009-01-12",
    "active_senders": 3,
    "active_recipients": 1
  },
  {
    "date": "2009-01-14",
    "active_senders": 3,
    "active_recipients": 0
  }
]

This endpoint returns the active addresses on the Bitcoin 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_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

BTC Supply

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

The above command returns JSON structured like this:

[
  {
    "date": "2009-01-12",
    "supply": 50
  },
  {
    "date": "2009-01-13",
    "supply": 750
  }
]

This endpoint returns the historical supply of BTC on the Bitcoin blockchain for every day of its existence.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_supply_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

BTC NVT

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

The above command returns JSON structured like this:

[
  {
    "date": "2014-09-24",
    "marketcap_usd": 5708841339.86,
    "nvt": 33.195
  },
  {
    "date": "2014-09-25",
    "marketcap_usd": 5516694629.19,
    "nvt": 35.833
  }
]

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_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

BTC Fees

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

The above command returns JSON structured like this:

[
  {
    "day": "2012-08-10",
    "total_fee": 44.53058517,
    "avg_size_bytes": 403,
    "price": 9.1,
    "total_fee_usd": 405.23,
    "avg_satoshis_per_byte": 389,
    "avg_fee": 156935.983,
    "avg_fee_usd": 0.01
  },
  {
    "day": "2012-08-11",
    "total_fee": 19.13775992,
    "avg_size_bytes": 393,
    "price": 9.1,
    "total_fee_usd": 174.15,
    "avg_satoshis_per_byte": 147,
    "avg_fee": 57749.962,
    "avg_fee_usd": 0.01
  }
]

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.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_fees_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

BTC UTXO Age

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

The above command returns JSON structured like this:

[
  {
    "1-3m": 0.0872,
    "12-18m": 0.1227,
    "18-24m": 0.1173,
    "1d-1w": 0.032,
    "1w-1m": 0.0806,
    "2-3y": 0.0576,
    "3-5y": 0.0586,
    "3-6m": 0.0674,
    "5-10y": 0.1408,
    "6-12m": 0.1448,
    "<1d": 0.0123,
    ">10y": 0.0786,
    "date": "2019-06-10"
  },
  {
    "1-3m": 0.0883,
    "12-18m": 0.1219,
    "18-24m": 0.1179,
    "1d-1w": 0.021,
    "1w-1m": 0.0856,
    "2-3y": 0.0576,
    "3-5y": 0.0586,
    "3-6m": 0.0684,
    "5-10y": 0.1407,
    "6-12m": 0.145,
    "<1d": 0.0162,
    ">10y": 0.0787,
    "date": "2019-06-11"
  }
]

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).

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/token_utxo_age_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

Ethereum Fundamentals

ETH On-chain Volume

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

The above command returns JSON structured like this:

[
  {
    "date": "2015-08-07",
    "volume_internal": 39.7,
    "volume_external": 2008602.5114319662,
    "price_usd": 1.25,
    "volume_internal_usd": 49.625,
    "volume_external_usd": 2510753.139289958
  },
  {
    "date": "2015-08-08",
    "volume_internal": 3568.434161233944,
    "volume_external": 1681503.1468948543,
    "price_usd": 1.7404166,
    "volume_internal_usd": 6210.56221437989,
    "volume_external_usd": 2926516.067163448
  }
]

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_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)

ETH On-chain Transaction Count

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

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 on the full historical Ethereum blockchain for every day since its genesis in 2015.

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 volume for (in this case eth)

ETH Active addresses

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

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_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

ETH Supply

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

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_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

ETH NVT

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

The above command returns JSON structured like this:

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

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_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

ETH Fees

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

The above command returns JSON structured like this:

[
  {
    "day": "2015-10-19",
    "price": 0.5,
    "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
  },
  {
    "day": "2015-10-20",
    "price": 0.49,
    "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_nvt_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

ERC20 Token Stats

ERC20 tokens we currently support are:

Name Symbol
Binance Coin bnb
Maker mkr
Basic Attention Token bat
Venchain ven
OmiseGo omg
Augur rep
Golem gnt
ZRX zrx
Zilliqa zil
Decentraland mana
Numerai nmr
Tokencard tkn
Bancor bnt
Icon icx
Loom Network loom
Status snt
Civic cvc
Kyber Network knc
iExec RLC rlc

ERC20 On-chain Volume

curl "https://api.tokenanalyst.io/analytics/private/v1/token_volume_historical/last?format=json&token=zrx&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 any of the major ERC20 tokens that we support.

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

ERC20 On-chain Transaction Count

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

The above command returns JSON structured like this:

[
  {
    "tokenaddress": "0x0F5D2fB29fb7d3CFeE444a200298f468908cC942",
    "date": "2017-09-06",
    "number_of_token_transfers": 4
  },
  {
    "tokenaddress": "0x0F5D2fB29fb7d3CFeE444a200298f468908cC942",
    "date": "2017-09-15",
    "number_of_token_transfers": 5512
  },
  {
    "tokenaddress": "0x0F5D2fB29fb7d3CFeE444a200298f468908cC942",
    "date": "2017-09-16",
    "number_of_token_transfers": 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_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

ERC20 Active addresses

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

The above command returns JSON structured like this:

[
  {
    "date": "2016-11-11",
    "active_senders": 23,
    "active_receivers": 31
  },
  {
    "date": "2016-11-12",
    "active_senders": 332,
    "active_receivers": 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_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

Stablecoin Stats

The stablecoins we currently support are:

Name Symbol
Tether usdt
USDC usdc
Paxos Standard Token pax
TrueUSD tusd
Gemini Dollar gusd
Dai dai

Stablecoin On-chain Volume

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

The above command returns JSON structured like this:

[
  {
    "date": "2018-09-10",
    "volume": 22.2,
    "price_usd": 0.0,
    "volume_usd": 0.0
  },
  {
    "date": "2018-09-12",
    "volume": 2.5,
    "price_usd": 0.0,
    "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_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

Stablecoin On-chain Transaction Count

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

The above command returns JSON structured like this:

[
  {
    "date": "2017-12-18",
    "number_of_token_transfers": 161
  },
  {
    "date": "2017-12-19",
    "number_of_token_transfers": 599
  },
  {
    "date": "2017-12-20",
    "number_of_token_transfers": 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_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

Stablecoin Active addresses

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

The above command returns JSON structured like this:

[
  {
    "date": "2016-11-11",
    "active_senders": 23,
    "active_receivers": 31
  },
  {
    "date": "2016-11-12",
    "active_senders": 332,
    "active_receivers": 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_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

DeFi metrics

The decentralized finance (DeFi) projects we currently cover are

Name API Parameter
Dharma dharma
Compound compound

Number of loans originated

curl "https://api.tokenanalyst.io/analytics/private/v1/project_loans_originated_historical/last?project=dharma&format=json&key=API_KEY"

The response looks like:

[
  {
    "date": "2019-03-14 00:00:00.000",
    "loans_originated": 4
  },
  {
    "date": "2019-03-15 00:00:00.000",
    "loans_originated": 20
  }
]

This endpoint returns the number of loans that have been originated in various decentralized finance ('DeFi') projects throughout the project's lifespan on the blockchain.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/project_loans_originated_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)
project string An project from the list of ones we cover (Above)

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_historical/last?format=json&key=API_KEY&token=btc&exchange=binance&direction=inflow"

The response looks like:

[
  {
    "avg_txn_value": 0.79,
    "avg_txn_value_usd": 3306.01,
    "date": "2017-08-16",
    "entity": "Binance",
    "inflow": 1053.89,
    "inflow_usd": 4410336.79,
    "number_of_entity_receiving_addresses": 1349,
    "number_of_nonentity_sending_addresses": 19413,
    "number_of_txns": 1338
  },
  {
    "avg_txn_value": 1.15,
    "avg_txn_value_usd": 5009.32,
    "date": "2017-08-17",
    "entity": "Binance",
    "inflow": 2236.29,
    "inflow_usd": 9741124.94,
    "number_of_entity_receiving_addresses": 2121,
    "number_of_nonentity_sending_addresses": 24915,
    "number_of_txns": 1950
  }
]

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_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

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_historical/last?

This is an example:

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

The response looks like:

[
  {
    "avg_txn_value": 26.73,
    "avg_txn_value_usd": 69375.93,
    "date": "2017-07-05",
    "entity": "Binance",
    "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": "2017-07-12",
    "entity": "Binance",
    "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

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_historical/last?

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

This is what the response looks like

[
  {
    "date": "2017-06-23",
    "entity": "Binance",
    "rank": 1,
    "transactionhash": "0546f2545393d706b3b77ec251be93af12038dc28eefd5dc0d27acea9f0613a0",
    "transactionid": "0546f2545393d706b3b77ec251be93af12038dc28eefd5dc0d27acea9f0613a0",
    "value": 0.01,
    "value_usd": 52.51
  }
]

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

BTC Full Historical Top 10 Outflow Large Value Transactions

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

The response looks like:

[
  {
    "date": "2017-08-15",
    "entity": "Binance",
    "rank": 1,
    "transactionhash": "c1053514fbc010322e9fec4d9931e9f4271a1453e1f2b6941c367bf75fd47ca2",
    "transactionid": "c1053514fbc010322e9fec4d9931e9f4271a1453e1f2b6941c367bf75fd47ca2",
    "value": 20,
    "value_usd": 83539.6
  },
  {
    "date": "2017-08-15",
    "entity": "Binance",
    "rank": 2,
    "transactionhash": "d73a0d5c4100cbe3a680fc541d53a27133172f18da99768e89ec245cef93afa1",
    "transactionid": "d73a0d5c4100cbe3a680fc541d53a27133172f18da99768e89ec245cef93afa1",
    "value": 12.2471,
    "value_usd": 51155.89
  }
]

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.

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 btc
direction string outflow
exchange string An exchange from the list of ones we support

Ethereum Exchange Flows

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

ETH Full Historical Inflow to Exchanges

This is an example:

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

The response looks like:

[
  {
    "date": "2016-03-17",
    "inflow": 1.8164,
    "price": 11.64,
    "inflow_usd": 21.14,
    "number_of_txns": 8,
    "avg_txn_value": 0.22705,
    "avg_txn_value_usd": 2.64
  },
  {
    "date": "2016-03-18",
    "inflow": 3.7594499999999997,
    "price": 10.21,
    "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 is the average inflow value for transactions flowing into exchange wallets on a given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/last/exchange_flow_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

ETH Full Historical Outflows from Exchanges

This is an example:

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

The response looks like:

[
  {
    "date": "2019-01-12",
    "outflow": 72528.5501725,
    "price": 126.79,
    "outflow_usd": 9195562.38,
    "number_of_txns": 2620,
    "avg_txn_value": 27.62652737595422,
    "avg_txn_value_usd": 3509.76
  },
  {
    "date": "2019-01-13",
    "outflow": 81527.64908884998,
    "price": 122.27,
    "outflow_usd": 9968045.76,
    "number_of_txns": 3000,
    "avg_txn_value": 27.17588302961666,
    "avg_txn_value_usd": 3322.68
  }
]

This endpoint returns the outflow of ETH from exchange wallets. The 'avg_txn_value' is the average outflow value for transactions flowing out of exchange wallets on a given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/exchange_flow_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

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",
    "rank": 2,
    "value_usd": 537210.85
  },
  {
    "transactionhash": "0x5512d27b371bfbef2fc6dae353fb243866fe3dfb24ad546d6b6eebb4159fb7c2",
    "value": 3000.0,
    "date": "2019-04-29",
    "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

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",
    "rank": 3,
    "value_usd": 1129368.16
  },
  {
    "transactionhash": "0x0e3d275eeae64b27ccbb12b65861039a7c3662c0c99212f88b9927c41b37bbae",
    "value": 5982.0288,
    "date": "2019-04-26",
    "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

Stablecoin Exchange Flows

The stablecoins we currently support are:

Name Symbol
Tether usdt
USDC usdc
Paxos Standard Token pax
TrueUSD tusd
Gemini Dollar gusd
Dai dai

Stablecoin Full Historical Inflow to Exchanges

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

The above command returns JSON structured like this:

[
  {
    "date": "2018-11-28",
    "token_name": "USDC",
    "exchange": "Binance",
    "inflow": 7170265.744998998,
    "price": 1.01,
    "inflow_usd": 7253918.77,
    "number_of_txns": 174,
    "avg_txn_value": 41208.42382183332,
    "avg_txn_value_usd": 41689.19
  },
  {
    "date": "2018-11-28",
    "token_name": "USDC",
    "exchange": "Kucoin",
    "inflow": 7724.377048,
    "price": 1.01,
    "inflow_usd": 7814.49,
    "number_of_txns": 6,
    "avg_txn_value": 1287.3961746666666,
    "avg_txn_value_usd": 1302.42
  }
]

This endpoint returns the inflow of Stablecoins into exchange wallets. The avg_txn_value is the average transaction value for transactions flowing into exchange wallets on a given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_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

Stablecoin Full Historical Outflow from Exchanges

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

The above command returns JSON structured like this:

[
  {
    "date": "2018-11-06",
    "token_name": "USDC",
    "exchange": "Kucoin",
    "outflow": 509.689581,
    "price": 1.0,
    "outflow_usd": 511.09,
    "number_of_txns": 3,
    "avg_txn_value": 169.896527,
    "avg_txn_value_usd": 170.36
  },
  {
    "date": "2018-11-07",
    "token_name": "USDC",
    "exchange": "Kucoin",
    "outflow": 3585.887836,
    "price": 1.01,
    "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 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/erc20_exchanges_flow_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

ERC20 Exchange Flows

ERC20 tokens we currently support are:

Name Symbol
Binance Coin bnb
Maker mkr
Basic Attention Token bat
Venchain ven
OmiseGo omg
Augur rep
Golem gnt
ZRX zrx
Zilliqa zil
Decentraland mana
Numerai nmr
Tokencard tkn
Bancor bnt
Icon icx
Loom Network loom
Status snt
Civic cvc
Kyber Network knc
iExec RLC rlc

ERC20 Full Historical Inflow to Exchanges

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

The above command returns JSON structured like this:

[
  {
    "date": "2017-07-19",
    "token_name": "OMG",
    "exchange": "Bitfinex",
    "inflow": 1021328.4514801201,
    "price": 0.68,
    "inflow_usd": 695260.83,
    "number_of_txns": 46,
    "avg_txn_value": 22202.79242348087,
    "avg_txn_value_usd": 15114.37
  },
  {
    "date": "2017-07-19",
    "token_name": "OMG",
    "exchange": "Bittrex",
    "inflow": 2440563.297567261,
    "price": 0.68,
    "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 tokens into exchange wallets. The avg_txn_value is the average transaction value for transactions flowing into exchange wallets on a given day.

HTTP Request

GET https://api.tokenanalyst.io/analytics/private/v1/erc20_exchanges_flow_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

ERC20 Full Historical Outflow from Exchanges

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

The above command returns JSON structured like this:

[
  {
    "date": "2017-07-30",
    "token_name": "OMG",
    "exchange": "Bittrex",
    "outflow": 83173.64737858999,
    "price": 1.23,
    "outflow_usd": 102476.86,
    "number_of_txns": 115,
    "avg_txn_value": 723.249107639913,
    "avg_txn_value_usd": 891.1
  },
  {
    "date": "2017-07-31",
    "token_name": "OMG",
    "exchange": "Bitfinex",
    "outflow": 317922.74454691994,
    "price": 1.2,
    "outflow_usd": 382302.1,
    "number_of_txns": 95,
    "avg_txn_value": 3346.555205757052,
    "avg_txn_value_usd": 4024.23
  }
]

This endpoint returns the outflow of ERC20 tokens from exchange wallets. The avg_txn_value 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/erc20_exchanges_flow_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