Query token list on all chains by user address
Description
Method: HTTPS GET
Encoding: UTF-8
Path: https://api.blockin.ai/v2/user/all_token_list
Description: Query token list on all chains by user address
Request Header
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
chain_names
N
String
If chain_names is empty, query all. Multiple chains are separated by commas. eg: eth, bsc, arb, btc. Enumeration
address
Y
String
User's address
is_all
N
Boolean
if true , return all the token info (including lp tokens) . if false, only return token info (excluding lp tokens) . Default is false
Response
Public Response
success
Y
Boolean
Success Boolean
data
N
List
Response object
error_code
N
String
Error code
error_msg
N
String
Error message
Response Content
token_address
Y
String
Token's address
chain_name
Y
String
Chain's name
name
Y
String
Token's name
symbol
Y
String
Token's symbol
decimals
Y
Integer
Token's decimals
logo_url
Y
String
URL of the token's logo image
chain_logo_url
Y
String
URL of the chain's logo image
price
Y
BigDecimal
Token's price
amount
Y
BigDecimal
Token's amount
Response Content (Tron)
token_id
N
Long
trc10's tokenId
type
Y
String
trc10/trc20
available_amount
N
BigDecimal
platformToken's available Amount
Request Sample
EVM Chain Request Sample
curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/all_token_list?chain_names=pol,bsc&address=0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0"
Bitcoin Request Sample
curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://www.blockin.ai/v2/user/all_token_list?address=39Puqo7cu5vowLsgPayaXVLDigUjPmQNnW&chain_names="
Tron Request Sample
curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/token_list?address=TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5&chain_name=Tron"
Successful Response Sample
EVM Chain Response Sample
{
"success": true,
"data": [
{
"token_address": "0x33c6005ae9c0355a595583081120c18818eaecd4",
"chain_name": "BSC",
"chain_logo_url": "https://www.blockin.ai/image/chain/56.png",
"name": "MetaPlay",
"symbol": "MPLAY",
"decimals": 18,
"logo_url": "https://www.blockin.ai/image/bsc/token/0x33c6005ae9c0355a595583081120c18818eaecd4.png",
"price": null,
"amount": 2
},
{
"token_address": "0x55d398326f99059ff775485246999027b3197955",
"chain_name": "BSC",
"chain_logo_url": "https://www.blockin.ai/image/chain/56.png",
"name": "Tether USD",
"symbol": "USDT",
"decimals": 18,
"logo_url": "https://www.blockin.ai/image/bsc/token/0x55d398326f99059ff775485246999027b3197955.png",
"price": null,
"amount": 74.71
},
{
"token_address": "MATIC",
"chain_name": "Polygon",
"chain_logo_url": "https://www.blockin.ai/image/chain/137.png",
"name": "MATIC",
"symbol": "MATIC",
"decimals": 18,
"logo_url": "https://www.blockin.ai/image/polygon/token/MATIC.png",
"price": null,
"amount": 0.011
}
],
"error_code": null,
"error_msg": null
}Bitcoin Response Sample
{
"success": true,
"data": [
{
"chain_name": "Bitcoin",
"chain_logo_url": "https://www.blockin.ai/image/chain/bitcoin.png",
"name": "SATS",
"logo_url": "https://www.blockin.ai/image/bitcoin/token/sats.png",
"price": 0.00000002748150662950,
"available_balance": 100000000.000000000000000000,
"transferable_balance": 0,
"last_event": 3784616,
"script_hash": "a9145484dba870b88d924051d4ad1d1eb23e9210614887"
},
{
"chain_name": "Bitcoin",
"chain_logo_url": "https://www.blockin.ai/image/chain/bitcoin.png",
"name": "ORDI",
"logo_url": "https://www.blockin.ai/image/bitcoin/token/ordi.png",
"price": 9.23644126789450000000,
"available_balance": 100.000000000000000000,
"transferable_balance": 0,
"last_event": 6815078,
"script_hash": "a9145484dba870b88d924051d4ad1d1eb23e9210614887"
},
{
"chain_name": "Bitcoin",
"chain_logo_url": "https://www.blockin.ai/image/chain/bitcoin.png",
"name": "BYLD",
"logo_url": "https://www.blockin.ai/image/bitcoin/token/byld.png",
"price": null,
"available_balance": 12000.000000000000000000,
"transferable_balance": 0,
"last_event": 8201554,
"script_hash": "a9145484dba870b88d924051d4ad1d1eb23e9210614887"
},
{
"chain_name": "Bitcoin",
"chain_logo_url": "https://www.blockin.ai/image/chain/bitcoin.png",
"name": "\uD835\uDD4F",
"logo_url": "https://www.blockin.ai/image/bitcoin/token/\uD835\uDD4F.png",
"price": null,
"available_balance": 10000.000000000000000000,
"transferable_balance": 0,
"last_event": 25854959,
"script_hash": "a9145484dba870b88d924051d4ad1d1eb23e9210614887"
}
],
"error_code": null,
"error_msg": null
}Tron Response Sample
{
"success": true,
"data": [
{
"chain_name": "Tron",
"chain_logo_url": "https://www.blockin.ai/image/chain/tron.png",
"name": "TRX",
"logo_url": "https://www.blockin.ai/image/tron/token/TRX.png",
"price": 0.105745985301831594,
"token_address": "TRX",
"symbol": "TRX",
"decimals": 6,
"amount": 2026712010.636548,
"chain_scan_token": "https://tronscan.org//#/token/0",
"chain_scan_image": "https://www.blockin.ai/image/scan/tron.png",
"token_id": null,
"type": null,
"available_amount": 443930944.636548
},
{
"chain_name": "Tron",
"chain_logo_url": "https://www.blockin.ai/image/chain/tron.png",
"name": "hashguess.com",
"logo_url": "https://www.blockin.ai/image/tron/token/1004980.png",
"price": null,
"token_address": "",
"symbol": "hashguess.com",
"decimals": 6,
"amount": 8.888888,
"chain_scan_token": "https://tronscan.org//#/token/1004980/transfers",
"chain_scan_image": "https://www.blockin.ai/image/scan/tron.png",
"token_id": 1004980,
"type": "trc10",
"available_amount": null
},
{
"chain_name": "Tron",
"chain_logo_url": "https://www.blockin.ai/image/chain/tron.png",
"name": "Wrapped TRX",
"logo_url": "https://www.blockin.ai/image/tron/token/TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR.png",
"price": 0.105745985301831594,
"token_address": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
"symbol": "WTRX",
"decimals": 6,
"amount": 367232696.361677,
"chain_scan_token": "https://tronscan.org//#/token20/TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
"chain_scan_image": "https://www.blockin.ai/image/scan/tron.png",
"token_id": null,
"type": "trc20",
"available_amount": null
}
],
"error_code": null,
"error_msg": null
}Failed Response Sample
{
"success": false,
"data": null,
"error_code": "CHAIN_NOT_SUPPORT",
"error_msg": "The current chain is not supported temporarily"
}Last updated