Query historical token list

Description

• Method：HTTPS POST

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/mirror/user/token_list

• Description: Query historical token list by chain name, user address and mirror time or block height.

Request Header

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

Request Parameters

Parameter	Required	Type	Description
mirror_time	N	Long	Historical timestamp you want to query. Mirror time needs to be accurate to the second.(Either block number or mirror time is required)
block_height	N	Long	Historical block height you want to query.(Either block height or mirror time is required)
chain_name	Y	String	Chain's name, only support single chain's name (abbr or full name). eg: eth,Ethereum. Enumeration
address	Y	String	User's address

Response

Public Response

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

Response Content

Parameter	Required	Type	Description
mirror_time	Long	Y	Historical timestamp(seconds) that you want to query.
chain_block	Map	N	The block height of the querying chains in response data.
tokens	List	Y	Response data. Like this token_list

Request Sample

curl --request POST --url https://www.blockin.ai/v2/mirror/user/token_list --header 'AccessKey: 1bdb01c947c54919b64d1fc6794atest' --header 'content-type: application/json' --data '{ "chain_name": "eth", "mirror_time": 1688019180, "block_height": null, "address": "0x4d0e439ba905eb39aee88097433add619cf5257b", "protocol_name": null }'

Successful Response Sample

{
    "success": true,
    "data": {
        "mirror_time": 1688019180,
        "chain_block": {
            "Ethereum": 17583097
        },         
        "tokens":[...]
    },
    "error_code": null,
    "error_msg": null
}