TES-0018: Tokenview Block Explorer API Routes

B.Abstract

This proposal brings standardization between block explorers API routes when linking transactions, blocks, accounts, tokens, smart contracts and charts.

Blockchain users, including web users, wallets, exchanges, will identify and link transaction, blocks, accounts, tokens, smart contracts, charts with blockchain related information to blockchain explorer web pages. Standardizing the API routes to these links improves interoperability between block explorers and web users, wallets, exchanges.

D.Specification

Block explorers will route their web pages accordingly for the following data:

Blocks

applicable to all public chains

Blocks

&ltBLOCK_EXPORER_URL>/block/&ltBLOCK_HASH_OR_HEIGHT>

Blocklist

&ltBLOCK_EXPORER_URL>/blocklist

Uncle Blocklist

&ltBLOCK_EXPORER_URL>/uncleblocklist

Transactions

applicable to all public chains

Transactions

&ltBLOCK_EXPORER_URL>/tx/&ltTX_HASH>

Pending Transactions

&ltBLOCK_EXPORER_URL>/pending/&ltTX_HASH>

Accounts

applicable to all public chains

Accounts

&ltBLOCK_EXPORER_URL>/address/&ltACCOUNT_ADDRESS>

Top Accounts

&ltBLOCK_EXPORER_URL>/topaccount

Tokens

applicable to all public chains that supports smart contracts. E.g. ETH, TRX, NEO and so on

Tokens

&ltBLOCK_EXPORER_URL>/token/&ltTOKEN_ADDRESS>

Token List

&ltBLOCK_EXPORER_URL>/tokenlist

Token Transactions

&ltBLOCK_EXPORER_URL>/tokentxns/&ltTOKEN_TX_HASH>

Charts

applicable to all public chains

Charts

&ltBLOCK_EXPORER_URL>/charts

Daily Price Chart

&ltBLOCK_EXPORER_URL>/chart/coinPrice

Daily Market Cap Chart

&ltBLOCK_EXPORER_URL>/chart/marketInfo

Daily Block Number Chart

&ltBLOCK_EXPORER_URL>/chart/blockNum

Block Size Chart

&ltBLOCK_EXPORER_URL>/chart/blockSize

Block Generation Period Chart

&ltBLOCK_EXPORER_URL>/chart/blockTime

Daily Average Hashrate Chart

&ltBLOCK_EXPORER_URL>/chart/dailyHashrate

Mining Difficulty Chart

&ltBLOCK_EXPORER_URL>/chart/dailyDiff

Mining Reward (USD) Chart

&ltBLOCK_EXPORER_URL>/chart/RewardUsd

Mining Reward Chart

&ltBLOCK_EXPORER_URL>/chart/dailyReward

Average Fee of Each Transaction (USD) Chart

&ltBLOCK_EXPORER_URL>/chart/dailyTxFeeUsd

Daily Total Fee (USD) Chart

&ltBLOCK_EXPORER_URL>/chart/dailyFeeUsd

Daily Total Fee Chart

&ltBLOCK_EXPORER_URL>/chart/dailyFee

Average Block Fee Chart

&ltBLOCK_EXPORER_URL>/chart/mineFee

Average Block Fee Median Chart

&ltBLOCK_EXPORER_URL>/chart/mineFeeMedian

Mining Revenue Chart

&ltBLOCK_EXPORER_URL>/chart/rewardUsd

Median Daily Transaction Amount in a Single Block Chart

&ltBLOCK_EXPORER_URL>/chart/dailyMedianBlock

Daily Transaction Amount Chart

&ltBLOCK_EXPORER_URL>/chart/dailySentVolume

Daily Average Trade Volume Per Transaction Chart

&ltBLOCK_EXPORER_URL>/chart/dailyVolume

Daily Transaction Counts Chart

&ltBLOCK_EXPORER_URL>/chart/dailyCount

Daily Trade Volume (USD) Chart

&ltBLOCK_EXPORER_URL>/chart/dailyTotalVolumeUsd

Daily Active Address & Newly Created Address Chart

&ltBLOCK_EXPORER_URL>/chart/dailyAccounts

Mining Outputs Chart

&ltBLOCK_EXPORER_URL>/chart/dailyMinedCoin

Full Node Size Chart

&ltBLOCK_EXPORER_URL>/chart/dailyChainSize

Smart Contract

applicable to all public chains that supports smart contracts

Smart Contract

&ltBLOCK_EXPORER_URL>/contract/&ltCONTRACT_ADDRESS>

E.Backward Compatibility

No compatibility issues. Special cases will depend on the actual situation.

F.Security Considerations

To be determined.

G. Copyright

H.Citation

Please cite this document as:

Tokenview, 'TBS-0018: Block Explorer API Routes', Tokenview Blockchain Standards, no.0018, January 2018. Available: https://tokenview.io/proposals/tbs-0018