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

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)

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)

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

Ethereum Fundamentals

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)

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)

Token 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"
  },
  {
    "date": "2015-08-01",
    "supply": "103205.0"
  }
]

This endpoint returns the total token supply of Ether on the blockchain for everyday of Ethereum's existence since its genesis in 2015.

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

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": "2016-11-11",
    "active_senders": "9513",
    "active_receivers": "14658"
  },
  {
    "date": "2016-11-12",
    "active_senders": "8838",
    "active_receivers": "13746"
  }
]

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

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
Storj storj
Tokencard tkn
Bancor bnt
Icon icx
Loom Network loom
Status snt
Civic cvc
Kyber Network knc
iExec RLC rlc

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": "1.00001170833E9",
    "price_usd": "0.11",
    "volume_usd": "1.1305799085E8"
  },
  {
    "date": "2017-08-13",
    "volume": "8.275E7",
    "price_usd": "0.18",
    "volume_usd": "1.490913652E7"
  }
]

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

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

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

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

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

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

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

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

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

Ethereum Exchange Flows

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

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

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

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.682652737595422",
    "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 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?

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

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

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