Etherscan-compatible endpoints for the Tokens module.

Get ERC20-Token TotalSupply by ContractAddress#

Returns the current amount of an ERC-20 token in circulation.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 token

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=stats&action=tokensupply&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=stats&action=tokensupply&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: string;

5}

Get ERC20-Token Account Balance for TokenContractAddress#

Returns the current balance of an ERC-20 token of an address.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 tokenaddressoptionalthe string representing the address to check for token balancetagoptionalthe string pre-defined block parameter, either earliest, pending or latest

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=tokenbalance&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&tag=latest&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=tokenbalance&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&tag=latest' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: string;

5}

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo#

Returns the amount of an ERC-20 token in circulation at a certain block height.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 tokenblocknooptionalthe integer block number to check total supply for eg. 12697906

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=stats&action=tokensupplyhistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&blockno=8000000&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=stats&action=tokensupplyhistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&blockno=8000000' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: string;

5}

Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo#

Returns the balance of an ERC-20 token of an address at a certain block height.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 tokenaddressoptionalthe string representing the address to check for balanceblocknooptionalthe integer block number to check total supply for eg. 12697906

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: string;

5}

Get Token Holder List by Contract Address#

Return the current ERC20 token holders and number of tokens held.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 tokenpageoptionalthe integer page number, if pagination is enabled offsetoptionalthe number of transactions displayed per page

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokenholderlist&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&page=1&offset=10&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokenholderlist&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&page=1&offset=10' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: {

5 TokenHolderAddress: string;

6 TokenHolderQuantity: string;

7 }[];

8}

Get Token Holder Count by Contract Address#

Return the current ERC20 token holders count

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 token

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokenholdercount&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokenholdercount&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: string;

5}

Get Token Info by ContractAddress#

Returns project information and social media links of an ERC20/ERC721/ERC1155 token.

GET

mainnettestnet

Ethereum

contractaddressoptionalthe contract address of the ERC-20 token

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokeninfo&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=token&action=tokeninfo&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: {

5 contractAddress: string;

6 tokenType: string;

7 tokenName: string;

8 symbol: string;

9 totalSupply: string;

10 blueCheckmark: string;

11 description: string;

12 website: string;

13 email: string;

14 blog: string;

15 reddit: string;

16 slack: string;

17 facebook: string;

18 twitter: string;

19 bitcointalk: string;

20 github: string;

21 telegram: string;

22 wechat: string;

23 linkedin: string;

24 discord: string;

25 whitepaperUrl: string;

26 audit: string;

27 }[];

28}

Get Address ERC20 Token Holding#

Returns the ERC-20 tokens and amount held by an address.

GET

mainnettestnet

Ethereum

addressoptionalthe string representing the address to check for balancepageoptionalthe integer page number, if pagination is enabledoffsetoptionalthe number of transactions displayed per page

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: {

5 TokenAddress: string;

6 TokenName: string;

7 TokenSymbol: string;

8 TokenQuantity: string;

9 TokenDivisor: string;

10 }[];

11}

Get Address ERC721 Token Holding#

Returns the ERC-721 tokens and amount held by an address.

GET

mainnettestnet

Ethereum

addressoptionalthe string representing the address to check for balancepageoptionalthe integer page number, if pagination is enabledoffsetoptionalthe number of transactions displayed per page

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokennftbalance&address=0x0000000000000000000000000000000000000000&page=1&offset=100&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokennftbalance&address=0x0000000000000000000000000000000000000000&page=1&offset=100' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: {

5 TokenAddress: string;

6 TokenQuantity: string;

7 TokenName: string;

8 TokenSymbol: string;

9 }[];

10}

Get Address ERC721 Token Inventory By Contract Address#

Returns the ERC-721 token inventory of an address, filtered by contract address.

GET

mainnettestnet

Ethereum

addressoptionalthe string representing the address to check for inventorycontractaddressoptionalthe string representing the ERC-721 token contractaddress to check for inventorypageoptionalthe integer page number, if pagination is enabledoffsetoptionalthe number of transactions displayed per page

API key (optional)

Show

https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokennftinventory&address=0x020ca66c30bec2c4fe3861a94e4db4a498a35872&contractaddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&page=1&offset=100&apikey=YourApiKeyToken

Send request

›_cURLJSJavaScriptPyPythonGoGophpPHPRbRuby

1curl 'https://api.routescan.io/v2/network/mainnet/evm/1/etherscan/api?module=account&action=addresstokennftinventory&address=0x020ca66c30bec2c4fe3861a94e4db4a498a35872&contractaddress=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&page=1&offset=100' \

2 -H 'apikey: YourApiKeyToken'

1{

2 status: string;

3 message: string;

4 result: {

5 TokenAddress: string;

6 TokenId: string;

7 }[];

8}