NAV
shell

Introduction

API Endpoint
https://www.tokenanalyst.io/api/v1/

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 Ethereum Blockchain. This API reference provides information on available endpoints and how to interact with it.

Our REST API has predictable, resource-oriented URLs, and uses standard HTTP response codes to indicate API errors. JSON is returned by all API responses, including errors.

Interacting with the API


#curl is a command-line tool that allows one to transfer data from or to a server using one of the standard supported protocols.
The below example gets meta-data on the TokenAnalyst endpoint.
curl -i -X HEAD https://www.tokenanalyst.io/api/v1/

You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Authentication

Example of an authorized API call to the Token Stats endpoint for the Airswap (AST) token.

curl "https://www.tokenanalyst.io/api/v1/tokenstats?apikey=API_KEY&symbol=AST"

Make sure to replace API_KEY with your API key.

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:

apikey=API_KEY

Objects

Before examining the endpoints for the API - and for reference while you are exploring the data, it is useful to have a detailed listing of all the data points that are returned. This section details all the objects exposed by the API.

Block

Attribute Type Description
transactions Array Array of transactions (each one an object) contained in the block
difficulty integer Integer of the difficulty for this block
gas_limit integer The maximum gas allowed in this block
gas_used integer The total used gas by all transactions in this block
block_hash string Hash of the block
miner string The address of the beneficiary to whom the mining rewards were given.
number integer The block number
size integer The size of this block in bytes
block_timestamp integer The unix timestamp for when the block was mined
total_difficulty string Hash of total difficulty in the chain up until this block

Transaction

Attribute Type Description
id integer Unique integer id for transaction
block_timestamp integer The unix timestamp for when this transaction’s block was mined
block_number integer The block number for the block that this transaction was in
from_address string Hash address of the sender
to_address string Hash address of the receiver
gas integer Gas provided by the sender
gas_price integer Gas price provided by the sender in Wei
transaction_hash string Hash of the Transaction
nonce integer The number of transactions made by the sender prior to this one.

Token Transfer

Attribute Type Description
id integer Unique integer id for the token transfer
token_name string Human readable name of the token being transferred
from_address string Hash address of the sender
to_address string Hash address of the receiver
quantity string Exact amount of tokens transferred
transaction_hash string Hash of the Transaction this token transfer belongs to
timestamp integer Unix timestamp when this token transfer occurred
block_number integer The block number of the block this token transfer was recorded in.

Token Stats

Attribute Type Description
id integer Unique integer id for the token transfer
token_name string Human readable name of the token being transferred
token_symbol string Ticker symbol of the token
modified_at string Full UTC date for when this statistic was recorded
daily_transaction_volume string Amount of tokens transferred on the day
daily_transaction_count string Count of token transfers that occurred during the date
historical_transaction_data string Array of objects containing historical transaction volume and count details
top_5_transactions integer Array of arrays containing the largest transactions of the day. Each array has the transaction hash, the token amount transferred, and the date on which the transfer occurred

Addresses

We keep track of every Ethereum address. Some addresses contain additional user-contributed data (e.g., identifying an address as an exchange).

Get address information

Example Query


curl https://www.tokenanalyst.io/api/v1/address?apikey=API_KEY&address=0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98

Example Response



{
"address_hash": "0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98",
"address_type": "account",
"name": "Bittrex",
"address_timestamp": 1511636973
}

HTTP Request

GET https://www.tokenanalyst.io/api/v1/address



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
address address address hash (including 0x prefix)

Blocks

Currently our API is designed such that querying by blocks is the fastest route to efficiently getting transaction data from the Ethereum Blockchain. It is important to distinguish here between what we deem a transaction and a token transfer. While a transaction refers to the movement of Ether on the Ethereum blockchain between two parties, a token transfer refers to the movement of ERC20 Tokens between two parties.

This endpoint allows you to get transactions and block details by block number. There are currently over 5 million blocks on the Ethereum Blockchain. For some context (when you want to query historical data) - here is a simple table of block numbers and the date in which they were mined.

Block Number Date
1 July 30, 2015
1,000,000 February 13, 2016
2,000,000 August 2, 2016
3,000,000 January 15, 2017
4,000,000 July 9, 2017
5,034,419 February 5, 2018

Get a single block

Returns block and transactions

Example Query


curl https://www.tokenanalyst.io/api/v1/block?apikey=API_KEY&number=3300000

Example Response

{
"transactions": [
{
"id": 14482030,
"block_timestamp": 1488769200,
"block_number": 3300000,
"from_address": "0x00472c1e4275230354dbe5007a5976053f12610a",
"to_address": "0xcd111aa492a9c77a367c36e6d6af8e6f212e0c8e",
"value": "0",
"gas": 940000,
"gas_price": 21600612284,
"transaction_hash": "0x50eaff997f08a0087926e626a33efac0c9083ad843918b56d2a5752b5f60b253",
"nonce": 159871
},
{
"id": 14482029,
"block_timestamp": 1488769200,
"block_number": 3300000,
"from_address": "0x6ec1412e053250431f141ffb7bf7fa3cf68f2ff2",
"to_address": "0xff6a2ba5523a9039da4b4c9be06fd8099e2742ac",
"value": "1000000000000000000",
"gas": 90000,
"gas_price": 21600612284,
"transaction_hash": "0x4e89a67d13fff6a1fc75484e6b708e5d2450f0631708539972c13e2e0631474b",
"nonce": 0
},
{
"id": 14482028,
"block_timestamp": 1488769200,
"block_number": 3300000,
"from_address": "0xd6910a23e14bb77c4b0fbd843f50a10d4f6de061",
"to_address": "0x0018334de29b519b728674063bde967436f2aeb5",
"value": "999097000000000000",
"gas": 21000,
"gas_price": 43000000000,
"transaction_hash": "0xfcb888b906f3217163f330e698aaecaccfc01b4e501ccd4ca55357fd9e6bd687",
"nonce": 0
}
],
"difficulty": 164687944952832,
"gas_limit": 4000033,
"gas_used": 107864,
"block_hash": "0x750b88eb32e95294dcac85fe09e0f80efac87b03439a7a1a0af924a88e695eb7",
"miner": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
"number": 3300000,
"size": 901,
"block_timestamp": 1488769200,
"total_difficulty": "0x88ca92fecb0a25855"
}

HTTP Request

GET https://www.tokenanalyst.io/api/v1/block



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
number integer Block number of the block whose details you want to get

Get a range of blocks

Returns block

Example Query


curl https://www.tokenanalyst.io/api/v1/blocks?apikey=API_KEY&start=5&end=9

Example Response

[
{
"transactions": [],
"difficulty": 17154711556,
"gas_limit": 5000,
"gas_used": 0,
"block_hash": "0xf37c632d361e0a93f08ba29b1a2c708d9caa3ee19d1ee8d2a02612bffe49f0a9",
"miner": "0x05a56e2d52c817161883f50c441c3228cfe54d9f",
"number": 5,
"size": 537,
"block_timestamp": 1438270083,
"total_difficulty": "0x17f980bffb"
},
{
"transactions": [],
"difficulty": 17146335232,
"gas_limit": 5000,
"gas_used": 0,
"block_hash": "0x1f1aed8e3694a067496c248e61879cda99b0709a1dfbacd0b693750df06b326e",
"miner": "0x0193d941b50d91be6567c7ee1c0fe7af498b4137",
"number": 6,
"size": 537,
"block_timestamp": 1438270107,
"total_difficulty": "0x1bf7810ffb"
},
{
"transactions": [],
"difficulty": 17154707466,
"gas_limit": 5000,
"gas_used": 0,
"block_hash": "0xe0c7c0b46e116b874354dce6f64b8581bd239186b03f30a978e3dc38656f723a",
"miner": "0xdd2f1e6e498202e86d8f5442af596580a4f03c2c",
"number": 7,
"size": 1078,
"block_timestamp": 1438270110,
"total_difficulty": "0x1ff6012005"
},
{
"transactions": [],
"difficulty": 17163083788,
"gas_limit": 5000,
"gas_used": 0,
"block_hash": "0x2ce94342df186bab4165c268c43ab982d360c9474f429fec5565adfc5d1f258b",
"miner": "0x0193d941b50d91be6567c7ee1c0fe7af498b4137",
"number": 8,
"size": 537,
"block_timestamp": 1438270112,
"total_difficulty": "0x23f5010011"
},
{
"transactions": [],
"difficulty": 17171464200,
"gas_limit": 5000,
"gas_used": 0,
"block_hash": "0x997e47bf4cac509c627753c06385ac866641ec6f883734ff7944411000dc576e",
"miner": "0xdd2f1e6e498202e86d8f5442af596580a4f03c2c",
"number": 9,
"size": 544,
"block_timestamp": 1438270115,
"total_difficulty": "0x27f480c019"
}
]

HTTP Request

GET https://www.tokenanalyst.io/api/v1/blocks



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
start integer Block number of the starting block (beginning of range)
end integer Block number of the ending block (end of range)


Transactions

Get Transactions by time

Example Query


curl https://www.tokenanalyst.io/api/v1/transactions?apikey=API_KEY&startdate=1517666446&enddate=1517666546

Example Response


[
{
"id": 158129018,
"block_timestamp": 1517666534,
"block_number": 5023586,
"from_address": "0xa6f5ce3025d51311dc5d6b8aa9018ed83fa8a72d",
"to_address": "0x6fc82a5fe25a5cdb58bc74600a40a69c065263f8",
"value": "24922948800000000000",
"gas": 47008,
"gas_price": 22000000000,
"transaction_hash": "0x2f8cb4c8e48f3548e04e2c06e9a6475a868e9d95e52bfc49cac5850f1bb8d5e1",
"nonce": 9
},
{
"id": 158129017,
"block_timestamp": 1517666534,
"block_number": 5023586,
"from_address": "0x09ff39d5e679f5f83d8c388cfd05017c01599656",
"to_address": "0xfa52274dd61e1643d2205169732f29114bc240b3",
"value": "200078853516134016",
"gas": 35000,
"gas_price": 22260000000,
"transaction_hash": "0x2cbe2cdd4bc5e031918846e0e7696f4b7d504a90dabfac586eba00b1bcdae20b",
"nonce": 49
},
{
"id": 158129016,
"block_timestamp": 1517666534,
"block_number": 5023586,
"from_address": "0xa31ce4c8d679321f0c0051eaea00fec22ff4f24f",
"to_address": "0xe71964746c3aad9eccf6445d59568ea793535314",
"value": "135000000000000000",
"gas": 21000,
"gas_price": 23000000000,
"transaction_hash": "0x930fc42318898d0f8d70bec1e1aeef667fd6d50f072c0694fb68f5a69b4c4f52",
"nonce": 7
}
]

HTTP Request

GET https://www.tokenanalyst.io/api/v1/transactions



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
startdate UNIX Unix timestamp to indicate start of range
enddate UNIX Unix timestamp to indicate end of range

Tokens

If you want to explore the data for a specific ERC20 token, use this endpoint. Currently the tokens we support are:

Token Name
Airswap
0x
Status
Numeraire
OmiseGo
Request-Network
Maker
FunFair
Quantstamp
Decentraland
DigixDao
Civic
VeChain
Gnosis-Gno
Aragon
Bancor
Tron
Golem
Icon
EOS

Token Transfers

Returns token transfer

Example Query


curl https://www.tokenanalyst.io/api/v1/tokentransfers?apikey=API_KEY&symbol=NMR&startdate=1517750000&enddate=1517760300

Example Response

[
{
"id": 254198,
"token_name": "Numeraire",
"from_address": "0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98",
"to_address": "0xa10dedd0e14bc14299c843972922155960a4d2b8",
"quantity": "34.56",
"transaction_hash": "0x1608f38e958b7380ca6b6cf077acc252ab2f2ec7ed708e81f168c7cc80dc91d3",
"timestamp": 1517753873,
"block_number": 5029629
},
{
"id": 254201,
"token_name": "Numeraire",
"from_address": "0x09670237f465d1321063f26baea9fb480a858d7f",
"to_address": "0xbafae9b254675281e86d1a5bf80a13ce4bf6391f",
"quantity": "2.12",
"transaction_hash": "0x3facacc9c19dc262f00283106cce4f0ab6c7a3d469dadb4b75908f527dbbe92a",
"timestamp": 1517754825,
"block_number": 5029690
},
{
"id": 254204,
"token_name": "Numeraire",
"from_address": "0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98",
"to_address": "0xab76c3d8800e3c96650eb9fee50bb65c91d6a24a",
"quantity": "3.35",
"transaction_hash": "0xa17070771754f3fd7310cdb953f67ed522f2939ae13c74daf6c1e2e0cf65617a",
"timestamp": 1517755786,
"block_number": 5029757
},
{
"id": 254207,
"token_name": "Numeraire",
"from_address": "0xbafae9b254675281e86d1a5bf80a13ce4bf6391f",
"to_address": "0xb68704549cab20de1fadad34d27a86ffabb04a6e",
"quantity": "2.12",
"transaction_hash": "0x7dc5afeb03d15f86eb5ff8e6c68970a9a780d8829a6a4b22b8e8a7989fdfd78c",
"timestamp": 1517756506,
"block_number": 5029793
}
]

HTTP Request

GET https://www.tokenanalyst.io/api/v1/tokentransfers



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
symbol string Ticker symbol of the token
startdate UNIX Unix timestamp to indicate start of range
enddate UNIX Unix timestamp to indicate end of range

Token Stats

Returns token stats

Example Query


curl https://www.tokenanalyst.io/api/v1/tokenstats?apikey=API_KEY&symbol=MANA

Example Response


{
"id": 10,
"token_name": "Decentraland",
"token_symbol": "MANA",
"modified_at": "2018-02-05T16:30:58.559492Z",
"daily_transaction_volume": "19415662.69707825",
"daily_transaction_count": "214",
"historical_transaction_data": "[{'date': '2017-10-09', 'tx_volume': 77751000, 'tx_count': 4, 'price': 0}, {'date': '2017-09-15', 'tx_volume': 759545643.513798, 'tx_count': 5096, 'price': 0}, {'date': '2017-09-16', 'tx_volume': 407148790.864749, 'tx_count': 4784, 'price': 0}, {'date': '2017-09-17', 'tx_volume': 122182064.383507, 'tx_count': 1575, 'price': 0}, {'date': '2017-09-18', 'tx_volume': 56166766.6615552, 'tx_count': 815, 'price': 0}, {'date': '2017-09-19', 'tx_volume': 46972703.059016, 'tx_count': 488, 'price': 0}, {'date': '2017-09-20', 'tx_volume': 72876497.0933871, 'tx_count': 340, 'price': 0}, {'date': '2017-09-21', 'tx_volume': 142901752.16417, 'tx_count': 639, 'price': 0}, {'date': '2017-09-22', 'tx_volume': 59083627.7383587, 'tx_count': 334, 'price': 0.01822}, {'date': '2017-09-23', 'tx_volume': 31841827.1067969, 'tx_count': 197, 'price': 0.01879}, {'date': '2017-09-24', 'tx_volume': 40379728.2968533, 'tx_count': 321, 'price': 0.01452}, {'date': '2017-09-25', 'tx_volume': 65720766.482481, 'tx_count': 306, 'price': 0.01565}, {'date': '2017-09-26', 'tx_volume': 74463179.0343577, 'tx_count': 261, 'price': 0.01542}, {'date': '2017-09-27', 'tx_volume': 69058800.2934769, 'tx_count': 244, 'price': 0.01563}, {'date': '2017-09-28', 'tx_volume': 43727549.4880046, 'tx_count': 192, 'price': 0.01624}, {'date': '2017-09-29', 'tx_volume': 60307918.0723764, 'tx_count': 455, 'price': 0.01444}, {'date': '2017-09-30', 'tx_volume': 36154459.3946549, 'tx_count': 486, 'price': 0.01413}, {'date': '2017-10-01', 'tx_volume': 19283148.1329806, 'tx_count': 340, 'price': 0.01365}, {'date': '2017-10-02', 'tx_volume': 19048977.1672415, 'tx_count': 203, 'price': 0.01307}, {'date': '2017-10-03', 'tx_volume': 27932404.0179306, 'tx_count': 226, 'price': 0.01415}, {'date': '2017-10-04', 'tx_volume': 19404893.5517191, 'tx_count': 114, 'price': 0.01401}, {'date': '2017-10-05', 'tx_volume': 19495856.6610576, 'tx_count': 285, 'price': 0.01443}, {'date': '2017-10-06', 'tx_volume': 21632249.1340318, 'tx_count': 307, 'price': 0.01447}, {'date': '2017-10-07', 'tx_volume': 17971410.5878975, 'tx_count': 285, 'price': 0.01451}, {'date': '2017-10-08', 'tx_volume': 17192853.6812479, 'tx_count': 166, 'price': 0.01319}, {'date': '2017-10-09', 'tx_volume': 29395115.1372295, 'tx_count': 201, 'price': 0.01003}, {'date': '2017-10-10', 'tx_volume': 25172742.3007701, 'tx_count': 170, 'price': 0.01143}, {'date': '2017-10-11', 'tx_volume': 27784779.0085573, 'tx_count': 128, 'price': 0.01081}, {'date': '2017-10-12', 'tx_volume': 17283503.1312864, 'tx_count': 202, 'price': 0.009724}, {'date': '2017-10-13', 'tx_volume': 85093064.3238956, 'tx_count': 306, 'price': 0.01764}, {'date': '2017-10-14', 'tx_volume': 658009584.321713, 'tx_count': 3794, 'price': 0.02004}, {'date': '2017-10-15', 'tx_volume': 61085813.2550327, 'tx_count': 422, 'price': 0.01377}, {'date': '2017-10-16', 'tx_volume': 113664944.987154, 'tx_count': 349, 'price': 0.01227}, {'date': '2017-10-17', 'tx_volume': 20457474.497446, 'tx_count': 223, 'price': 0.01075}, {'date': '2017-10-18', 'tx_volume': 52968575.0518558, 'tx_count': 195, 'price': 0.01093}, {'date': '2017-10-19', 'tx_volume': 16674649.2016697, 'tx_count': 212, 'price': 0.01311}, {'date': '2017-10-20', 'tx_volume': 34055720.2779848, 'tx_count': 164, 'price': 0.01193}, {'date': '2017-10-21', 'tx_volume': 85550638.5963638, 'tx_count': 143, 'price': 0.01009}, {'date': '2017-10-22', 'tx_volume': 44507266.0638088, 'tx_count': 133, 'price': 0.008855}, {'date': '2017-10-23', 'tx_volume': 32702586.2598, 'tx_count': 190, 'price': 0.008678}, {'date': '2017-10-24', 'tx_volume': 80267838.9797621, 'tx_count': 550, 'price': 0.01053}, {'date': '2017-10-25', 'tx_volume': 25003264.6573135, 'tx_count': 116, 'price': 0.01055}, {'date': '2017-10-26', 'tx_volume': 11555397.9263072, 'tx_count': 177, 'price': 0.01001}, {'date': '2017-10-27', 'tx_volume': 5812562.69890205, 'tx_count': 85, 'price': 0.01003}, {'date': '2017-10-28', 'tx_volume': 23925686.3134939, 'tx_count': 118, 'price': 0.01002}, {'date': '2017-10-29', 'tx_volume': 20290801.4976167, 'tx_count': 174, 'price': 0.01002}, {'date': '2017-10-30', 'tx_volume': 17923342.6551415, 'tx_count': 191, 'price': 0.009799}, {'date': '2017-10-31', 'tx_volume': 37788066.1926235, 'tx_count': 196, 'price': 0.00929}, {'date': '2017-11-01', 'tx_volume': 25734541.1757012, 'tx_count': 231, 'price': 0.01031}, {'date': '2017-11-02', 'tx_volume': 23985567.4967046, 'tx_count': 209, 'price': 0.009975}, {'date': '2017-11-03', 'tx_volume': 12566736.2065462, 'tx_count': 185, 'price': 0.01037}, {'date': '2017-11-04', 'tx_volume': 2642200.72873063, 'tx_count': 41, 'price': 0.01156}, {'date': '2017-11-05', 'tx_volume': 24594339.367715, 'tx_count': 256, 'price': 0.01227}, {'date': '2017-11-06', 'tx_volume': 28347900.851696, 'tx_count': 244, 'price': 0.01197}, {'date': '2017-11-07', 'tx_volume': 14502800.4060417, 'tx_count': 209, 'price': 0.0135}, {'date': '2017-11-08', 'tx_volume': 39588586.9438272, 'tx_count': 470, 'price': 0.01444}, {'date': '2017-11-09', 'tx_volume': 90945166.1769942, 'tx_count': 443, 'price': 0.01511}, {'date': '2017-11-10', 'tx_volume': 67398057.8162396, 'tx_count': 757, 'price': 0.01274}, {'date': '2017-11-11', 'tx_volume': 34506153.5270983, 'tx_count': 439, 'price': 0.01192}, {'date': '2017-11-12', 'tx_volume': 54839875.8899156, 'tx_count': 409, 'price': 0.01035}, {'date': '2017-11-13', 'tx_volume': 53111302.2159575, 'tx_count': 249, 'price': 0.01128}, {'date': '2017-11-14', 'tx_volume': 24962280.3742748, 'tx_count': 226, 'price': 0.01128}, {'date': '2017-11-15', 'tx_volume': 39172681.0394101, 'tx_count': 167, 'price': 0.01194}, {'date': '2017-11-16', 'tx_volume': 1973729.69940915, 'tx_count': 26, 'price': 0.0117}, {'date': '2017-11-17', 'tx_volume': 4479492.48477889, 'tx_count': 73, 'price': 0.01186}, {'date': '2017-11-18', 'tx_volume': 59024006.8623216, 'tx_count': 219, 'price': 0.01307}, {'date': '2017-11-19', 'tx_volume': 12731778.9059286, 'tx_count': 152, 'price': 0.01311}, {'date': '2017-11-20', 'tx_volume': 22961557.9854933, 'tx_count': 253, 'price': 0.01294}, {'date': '2017-11-21', 'tx_volume': 24952613.9670191, 'tx_count': 205, 'price': 0.01312}, {'date': '2017-11-22', 'tx_volume': 43806396.9876447, 'tx_count': 214, 'price': 0.01342}, {'date': '2017-11-23', 'tx_volume': 110507231.393043, 'tx_count': 323, 'price': 0.0137}, {'date': '2017-11-24', 'tx_volume': 163828505.565162, 'tx_count': 1242, 'price': 0.01583}, {'date': '2017-11-25', 'tx_volume': 61407069.2585763, 'tx_count': 460, 'price': 0.0155}, {'date': '2017-11-26', 'tx_volume': 17509413.2721545, 'tx_count': 245, 'price': 0.01565}, {'date': '2017-11-27', 'tx_volume': 73587030.1467683, 'tx_count': 456, 'price': 0.01733}, {'date': '2017-11-28', 'tx_volume': 86388747.0199974, 'tx_count': 712, 'price': 0.01833}, {'date': '2017-11-29', 'tx_volume': 71616680.1961751, 'tx_count': 485, 'price': 0.01545}, {'date': '2017-11-30', 'tx_volume': 21698135.4633737, 'tx_count': 126, 'price': 0.01492}, {'date': '2017-12-01', 'tx_volume': 63112926.6962502, 'tx_count': 524, 'price': 0.01597}, {'date': '2017-12-02', 'tx_volume': 17625462.9569854, 'tx_count': 288, 'price': 0.01702}, {'date': '2017-12-03', 'tx_volume': 62125298.4455563, 'tx_count': 561, 'price': 0.01754}, {'date': '2017-12-04', 'tx_volume': 13244431.1317659, 'tx_count': 254, 'price': 0.01802}, {'date': '2017-12-05', 'tx_volume': 27852186.1062617, 'tx_count': 366, 'price': 0.02263}, {'date': '2017-12-06', 'tx_volume': 325540956.198382, 'tx_count': 1759, 'price': 0.05912}, {'date': '2017-12-07', 'tx_volume': 334134092.827948, 'tx_count': 3490, 'price': 0.06016}, {'date': '2017-12-08', 'tx_volume': 159346598.149414, 'tx_count': 2331, 'price': 0.04959}, {'date': '2017-12-09', 'tx_volume': 336387331.072888, 'tx_count': 1947, 'price': 0.05329}, {'date': '2017-12-10', 'tx_volume': 135752983.791771, 'tx_count': 2779, 'price': 0.07439}, {'date': '2017-12-11', 'tx_volume': 30495916.2344083, 'tx_count': 789, 'price': 0.07346}, {'date': '2017-12-12', 'tx_volume': 112045291.039076, 'tx_count': 2352, 'price': 0.08405}, {'date': '2017-12-13', 'tx_volume': 152117264.302214, 'tx_count': 3066, 'price': 0.122}, {'date': '2017-12-14', 'tx_volume': 122897385.521583, 'tx_count': 2716, 'price': 0.1303}, {'date': '2017-12-15', 'tx_volume': 7124876.62842179, 'tx_count': 60, 'price': 0.1058}, {'date': '2017-12-16', 'tx_volume': 2503397.63445611, 'tx_count': 68, 'price': 0.1}, {'date': '2017-12-17', 'tx_volume': 13911943.1038485, 'tx_count': 191, 'price': 0.103}, {'date': '2017-12-18', 'tx_volume': 66466168.7310247, 'tx_count': 1711, 'price': 0.1142}, {'date': '2017-12-19', 'tx_volume': 73945438.3282901, 'tx_count': 1639, 'price': 0.1106}, {'date': '2017-12-20', 'tx_volume': 68083906.8238073, 'tx_count': 1727, 'price': 0.1161}, {'date': '2017-12-21', 'tx_volume': 62518923.1949723, 'tx_count': 1938, 'price': 0.1085}, {'date': '2017-12-22', 'tx_volume': 71829853.1746438, 'tx_count': 1562, 'price': 0.08773}, {'date': '2017-12-23', 'tx_volume': 19099425.3303185, 'tx_count': 727, 'price': 0.08782}, {'date': '2017-12-24', 'tx_volume': 32716459.8715234, 'tx_count': 1224, 'price': 0.08522}, {'date': '2017-12-25', 'tx_volume': 22435687.0807032, 'tx_count': 782, 'price': 0.09172}, {'date': '2017-12-26', 'tx_volume': 8405640.44855022, 'tx_count': 284, 'price': 0.08682}, {'date': '2017-12-27', 'tx_volume': 13401220.3822147, 'tx_count': 421, 'price': 0.08217}, {'date': '2017-12-28', 'tx_volume': 11160847.4420553, 'tx_count': 472, 'price': 0.0887}, {'date': '2017-12-29', 'tx_volume': 36658289.3116974, 'tx_count': 1017, 'price': 0.0888}, {'date': '2017-12-30', 'tx_volume': 41179024.0266949, 'tx_count': 1338, 'price': 0.09762}, {'date': '2017-12-31', 'tx_volume': 22435270.5199469, 'tx_count': 809, 'price': 0.101}, {'date': '2018-01-01', 'tx_volume': 17456493.2055127, 'tx_count': 568, 'price': 0.0999}, {'date': '2018-01-02', 'tx_volume': 49117842.2557035, 'tx_count': 969, 'price': 0.1039}, {'date': '2018-01-03', 'tx_volume': 80593781.3717821, 'tx_count': 1654, 'price': 0.1546}, {'date': '2018-01-04', 'tx_volume': 490426614.840679, 'tx_count': 1199, 'price': 0.1951}, {'date': '2018-01-05', 'tx_volume': 268335830.974845, 'tx_count': 2843, 'price': 0.1648}, {'date': '2018-01-06', 'tx_volume': 60878503.1388163, 'tx_count': 1335, 'price': 0.1825}, {'date': '2018-01-07', 'tx_volume': 69959743.9358791, 'tx_count': 1341, 'price': 0.2332}, {'date': '2018-01-08', 'tx_volume': 122819046.237593, 'tx_count': 1182, 'price': 0.2339}, {'date': '2018-01-09', 'tx_volume': 98386770.1619994, 'tx_count': 1724, 'price': 0.2487}, {'date': '2018-01-10', 'tx_volume': 55148536.2196505, 'tx_count': 1025, 'price': 0.2096}, {'date': '2018-01-11', 'tx_volume': 37367268.4903599, 'tx_count': 726, 'price': 0.1719}, {'date': '2018-01-12', 'tx_volume': 20659811.0242451, 'tx_count': 708, 'price': 0.1845}, {'date': '2018-01-13', 'tx_volume': 34709895.0621025, 'tx_count': 680, 'price': 0.1769}, {'date': '2018-01-14', 'tx_volume': 28315961.5141498, 'tx_count': 708, 'price': 0.1493}, {'date': '2018-01-15', 'tx_volume': 27611204.2335433, 'tx_count': 508, 'price': 0.1339}, {'date': '2018-01-16', 'tx_volume': 33361447.2040252, 'tx_count': 659, 'price': 0.09601}, {'date': '2018-01-17', 'tx_volume': 58446732.4023096, 'tx_count': 811, 'price': 0.14}, {'date': '2018-01-18', 'tx_volume': 45237538.7696356, 'tx_count': 747, 'price': 0.1318}, {'date': '2018-01-19', 'tx_volume': 44360810.0812941, 'tx_count': 702, 'price': 0.14}, {'date': '2018-01-20', 'tx_volume': 11229131.0392912, 'tx_count': 468, 'price': 0.1492}, {'date': '2018-01-21', 'tx_volume': 26425871.1518488, 'tx_count': 551, 'price': 0.123}, {'date': '2018-01-22', 'tx_volume': 19751693.8723412, 'tx_count': 642, 'price': 0.1227}, {'date': '2018-01-23', 'tx_volume': 31829216.8411295, 'tx_count': 813, 'price': 0.1471}, {'date': '2018-01-24', 'tx_volume': 40521247.6234362, 'tx_count': 532, 'price': 0.1381}, {'date': '2018-01-25', 'tx_volume': 35107338.04057055, 'tx_count': 449, 'price': 0.1433}, {'date': '2018-01-26', 'tx_volume': 14321623.042409752, 'tx_count': 360, 'price': 0.1385}, {'date': '2018-01-27', 'tx_volume': 9252497.621453416, 'tx_count': 297, 'price': 0.1422}, {'date': '2018-01-28', 'tx_volume': 21334159.196300067, 'tx_count': 404, 'price': 0.1406}, {'date': '2018-01-29', 'tx_volume': 19392584.9519479, 'tx_count': 367, 'price': 0.1349}, {'date': '2018-01-30', 'tx_volume': 16290958.376167191, 'tx_count': 330, 'price': 0.1136}, {'date': '2018-01-31', 'tx_volume': 19534327.432154194, 'tx_count': 345, 'price': 0.1291}, {'date': '2018-02-01', 'tx_volume': 18523677.188231774, 'tx_count': 465, 'price': 0.1016}, {'date': '2018-02-02', 'tx_volume': 31238002.404005375, 'tx_count': 444, 'price': 0.09439}, {'date': '2018-02-03', 'tx_volume': 8669700.14340487, 'tx_count': 223, 'price': 0.09886}, {'date': '2018-02-04', 'tx_volume': 18230562.33446326, 'tx_count': 442, 'price': 0.09927}, {'date': '2018-02-05', 'tx_volume': 19415662.69707825, 'tx_count': 214, 'price': 0.08024}]",
"top_5_transactions": "[['0xf5d6d6a631d144045888a0ae6131ff51ad9fd55f983cef07570b03737fc9ffc8', 7194206.0, '2018-02-05'], ['0xda023e1d022b5dbb8a44ebb85d660a1122f3fb6c59abe9ee89601e55b9ffd04b', 6465102.06072346, '2018-02-05'], ['0x6c7bde388c0b201cc2a1fc89f74fd6fab85f7fc476055883ae1e6b1ee7017da6', 4999964.0, '2018-02-03'], ['0x37770cccdda3639f84dbd7d156cb882c5f4a89d4559bfe7475934c00a81ba419', 1500000.0, '2018-02-04'], ['0x39fe832eb6a87e3ee595c81e3806a73e163a4bd517256c90e8d97e587a499aba', 1500000.0, '2018-02-04']]"
}

HTTP Request

GET https://www.tokenanalyst.io/api/v1/tokenstats



Required URL Parameters

Parameter Type Description
apikey string Your unique API Key
symbol string Ticker symbol of the token

Errors

The TokenAnalyst API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request was not in the correct format
403 Forbidden – The information requested is hidden for administrators only
404 Not Found – The specified information could not be found
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintenance. Please try again later.