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

Parameter	Required	Type	Description
Content-Type	Y	String	application/json
AccessKey	Y	String	1bdb01c947c54919b64d1fc6794atest

Request Parameters

Parameter	Required	Type	Description
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

Parameter	Required	Type	Description
success	Y	Boolean	Success Boolean
data	N	List	Response object
error_code	N	String	Error code
error_msg	N	String	Error message

Response Content

Parameter	Required	Type	Description
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)

Parameter	Required	Type	Description
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"
}