tokens.
Get all tokens
/tokens
Returns a list of all tokens that match a given string query or of a certain type (ERC-20/721/1155).
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens?q=USDT&type=ERC-20%2CERC-721%2CERC-1155' \
-H 'accept: application/json'
{
"items": [
{
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
],
"next_page_params": {
"contract_address_hash": "0x68749665ff8d2d112fa859aa293f07a622782f38",
"holder_count": 1011,
"is_name_null": false,
"items_count": 50,
"market_cap": "482534473.2170469",
"name": "Tether Gold"
}
}
Get all tokens for a specific address
/tokens/{address_hash}
Returns info on all tokens held by the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997' \
-H 'accept: application/json'
{
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
Get all transfers for a specific address
/tokens/{address_hash}/transfers
Returns all token transfers performed by the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/transfers' \
-H 'accept: application/json'
{
"items": [
{
"block_hash": "0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a",
"from": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"log_index": "243",
"method": "transfer",
"timestamp": "2023-07-03T20:09:59.000000Z",
"to": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
},
"total": {
"decimals": "18",
"value": "1000"
},
"tx_hash": "0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592",
"type": "token_transfer"
}
],
"next_page_params": {
"block_number": 27736955,
"index": 61
}
}
Get all token holders for a specific address
/tokens/{address_hash}/holders
Returns all token holders for the given address.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/holders' \
-H 'accept: application/json'
{
"items": [
{
"address": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"value": "10000",
"token_id": "10000",
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
}
],
"next_page_params": {
"items_count": 2,
"value": 790000000000000000000
}
}
Get count of token holders and transfers for a specific address
/tokens/{address_hash}/counters
Returns a counter for token holders and transfers for the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/counters' \
-H 'accept: application/json'
{
"token_holders_count": "100",
"transfers_count": "1000"
}
Get all NFT instances for a specific address
/tokens/{address_hash}/instances
Returns all non-fungible token (NFT) instances for the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances' \
-H 'accept: application/json'
{
"items": [
{
"is_unique": true,
"id": "431",
"holder_address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"image_url": "example.com/picture.png",
"animation_url": "example.com/video.mp4",
"external_app_url": "d-app.com",
"metadata": {
"year": 2023,
"tags": [
"poap",
"event"
],
"name": "Social Listening Committee #2 Attendees",
"image_url": "https://assets.poap.xyz/chanel-poap-4c-2023-logo-1675083420470.png",
"home_url": "https://app.poap.xyz/token/6292128",
"external_url": "https://api.poap.tech/metadata/99010/6292128",
"description": "This is the POAP for attendees of the second Social Listening Committee.",
"attributes": [
{
"value": "01-Feb-2023",
"trait_type": "startDate"
},
{
"value": "01-Feb-2023",
"trait_type": "endDate"
},
{
"value": "false",
"trait_type": "virtualEvent"
},
{
"value": "Paris",
"trait_type": "city"
},
{
"value": "France",
"trait_type": "country"
},
{
"value": "https://www.chanel.com",
"trait_type": "eventURL"
}
]
},
"owner": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
}
],
"next_page_params": {
"unique_token": 97464
}
}
Get specific NFT instance for a specific address
/tokens/{address_hash}/instances/{id}
Returns an NFT instance by id from a the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431' \
-H 'accept: application/json'
{
"is_unique": true,
"id": "431",
"holder_address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"image_url": "example.com/picture.png",
"animation_url": "example.com/video.mp4",
"external_app_url": "d-app.com",
"metadata": {
"year": 2023,
"tags": [
"poap",
"event"
],
"name": "Social Listening Committee #2 Attendees",
"image_url": "https://assets.poap.xyz/chanel-poap-4c-2023-logo-1675083420470.png",
"home_url": "https://app.poap.xyz/token/6292128",
"external_url": "https://api.poap.tech/metadata/99010/6292128",
"description": "This is the POAP for attendees of the second Social Listening Committee.",
"attributes": [
{
"value": "01-Feb-2023",
"trait_type": "startDate"
},
{
"value": "01-Feb-2023",
"trait_type": "endDate"
},
{
"value": "false",
"trait_type": "virtualEvent"
},
{
"value": "Paris",
"trait_type": "city"
},
{
"value": "France",
"trait_type": "country"
},
{
"value": "https://www.chanel.com",
"trait_type": "eventURL"
}
]
},
"owner": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
}
Get transfers for a specific NFT instance in a specific address
/tokens/{address_hash}/instances/{id}/transfers
Returns transfers of the specified NFT instance for the given address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/transfers' \
-H 'accept: application/json'
{
"items": [
{
"block_hash": "0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a",
"from": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"log_index": "243",
"method": "transfer",
"timestamp": "2023-07-03T20:09:59.000000Z",
"to": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
},
"total": {
"decimals": "18",
"value": "1000"
},
"tx_hash": "0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592",
"type": "token_transfer"
}
],
"next_page_params": {
"block_number": 27736955,
"index": 61,
"token_id": 50
}
}
Get token holders for a specific NFT instance and address
/tokens/{address_hash}/instances/{id}/holders
Returns token holders for a specific NFT instance and address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/holders' \
-H 'accept: application/json'
{
"items": [
{
"address": {
"hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"implementation_name": "implementationName",
"name": "contractName",
"is_contract": true,
"private_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"watchlist_names": [
{
"display_name": "name to show",
"label": "label"
}
],
"public_tags": [
{
"address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
"display_name": "name to show",
"label": "label"
}
],
"is_verified": true
},
"value": "10000",
"token_id": "10000",
"token": {
"circulating_market_cap": "83606435600.3635",
"icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
"name": "Tether USD",
"decimals": "6",
"symbol": "USDT",
"address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
"type": "ERC-20",
"holders": "837494234523",
"exchange_rate": "0.99",
"total_supply": "10000000"
}
}
],
"next_page_params": {
"value": 790000000000000000000,
"token_id": "953848",
"items_count": 50
}
}
Get count of transfers for a specific NFT instance and address
/tokens/{address_hash}/instances/{id}/transfers-count
Returns a transfer counter for the specific NFT instance and address hash.
Request
curl -X 'GET' \
'https://evm-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/transfers-count' \
-H 'accept: application/json'
{
"transfers_count": 10
}