Query history list by chain name and user address

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/user/history_list

• Description: Query all transaction records of the chain supported by blockin through the 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_name	Y	String	Chain's name,support single chain'name. eg: eth,Ethereum,btc Enumeration
address	Y	String	User's address
start_time	N	Long	Trading time (Note: the first page :0 ; every subsequent page :the trading time of the last item of the previous page )
page_count	Y	Integer	Number of entries returned, the maximum count is 20.

Response

Public Response

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

Data Content

Parameter	Required	Type	Description
cate_dict	Y	Object	Dict-Call type category (eg. approve, receive, send)
cex_dict	N	Object	Dict of cex
history_list	N	List	Address's history transaction list
is_big_address	N	Boolean	Is it a large address
project_dict	Y	Object	Dict - Project which this address interacted
token_dict	Y	Object	Dict - Tokens which this address interacted

Cate_dict Content

Parameter	Required	Type	Description
id	Y	String	Function name id
name	Y	String	Function name

Cex_dict Content

Parameter	Required	Type	Description
id	N	String	id
is_vault	N	Boolean
logo_url	N	String	cex's logo
name	N	String	cex's name

History_list Content

Parameter	Required	Type	Description
cate_id	N	String	Function name id
cex_id	N	String	Cex'id
chain_name	Y	String	Chain name
chain_id	Y	Long	Chain id
chain_scan_img	Y	String	Chain scan image
chain_scan_tx	Y	String	Scan tx
chain_img	Y	String	Chain logo
chain_token	Y	String	Chain token
tx	Y	String	Transaction hash
is_scam	Y	String	Is it scam
other_address	N	String
project_name	N	String	Protocol name
receives	Y	List	Receives
sends	Y	List	Sends
time_at	Y	Long	Transaction time
token_approve	Y	List	Authorization info
tx_list	Y	Object	The transaction's base info

Receives Content

Parameter	Required	Type	Description
amount	N	BigDecimal	Received quantity of token
from_address	N	String	From address
price	N	BigDecimal	Price
token_address	N	String	Token address

Sends Content

Parameter	Required	Type	Description
amount	N	BigDecimal	Send quantity of token
to_address	N	String	Send to address
token_address	N	String	Token address
price	N	BigDecimal	Price

Tx Content

Parameter	Required	Type	Description
gas_fee	N	BigDecimal	Gas fee
from_address	Y	String	From address
name	N	String	Funtion name
function_code	N	String	Method id
params	N	List	Parameter
status	Y	int	Transaction status. 0 - Failed, 1 - Success
to_address	Y	String	To address
usd_gas_fee	N	BigDecimal	USD gas fee
value	N	BigDecimal	Quantity

Token_approve Content

Parameter	Required	Type	Description
spender	N	String
token_address	N	String	Token address
value	N	String	Authorized value

Project_dict Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain
id	Y	String	Protocol's id
logo_url	N	String	Prorocol's logo
contract_address	N	String	Contract address
name	N	String	Protocol's name
site_url	N	String	Protocol's website

Token_dict (token) Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain
decimal	N	Integer
display_symbol	N	String
id	Y	String	Token id
is_core	Y	Boolean
is_scam	Y	Boolean
is_verified	Y	Boolean
is_wallet	Y	Boolean
logo_url	N	String	Token's logo
name	Y	String	Token's name
optimized_symbol	N	String
price	N	BigDecimal	Token's price
protocol_name	N	String	Protocol's name
symbol	N	String	Token's symbol
time_at	N	Long	Time

Token_dict (NFT) Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain‘ name
id	Y	String	Primary key md5(contract address+NFT id), 32-bit lowercase
symbol	N	String	NFT's symbol
contract_address	N	String	Contract address
item_id	Y	String	Collection item id
collection	N	Object	Collection info
thumbnail_url	N	String	NFT's img
content	N	String
detail_url	N	String
content_type	N	String
name	N	String	Name
total_supply	N	BigDecimal	Total supply

Collection (NFT) Content

Parameter	Required	Type	Description
chain_name	Y	String	Chain
contract_address	Y	String	chain: contract address)
logo_url	N	String	Collection's logo
name	N	String	Collection's name
is_core	Y	Boolean
is_scam	Y	Boolean
is_verified	Y	Boolean

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" "https://api.blockin.ai/v2/user/history_list?chain_name=eth&address=0xa976ea51b9ba3232706af125a92e32788dc08ddc&start_time=0&page_count=2"

Successful Response Sample

{
    "success": true,
    "data": {
        "cate_dict": {
            "execTransaction": {
                "id": "execTransaction",
                "name": "ExecTransaction"
            }
        },
        "cex_dict": {},
        "history_list": [
            {
                "cate_id": "execTransaction",
                "cex_id": null,
                "chain_name": "Ethereum",
                "chain_id": 1,
                "chain_scan_img": "https://www.blockin.ai/image/scan/ethereum.png",
                "chain_scan_tx": "https://www.etherscan.io/tx/",
                "chain_img": "https://www.blockin.ai/image/chain/1.png",
                "chain_token": "ETH",
                "tx": "0xeb1841c4101228b3e728bc8ca3401f4fd3ad8a5f61f47f7f5fd392caec7d5f4d",
                "is_scam": false,
                "other_address": "0x17b732b45c3cdfa5c751e0c2cfef807b26a7f883",
                "project_name": null,
                "receives": [],
                "sends": [
                    {
                        "amount": -521.800000000000000000,
                        "from_address": "0xa976ea51b9ba3232706af125a92e32788dc08ddc",
                        "to_address": "0x17b732b45c3cdfa5c751e0c2cfef807b26a7f883",
                        "token_address": "ETH",
                        "price": 2026.9996482737771540700896013121744841108651725165815685736458028011275219813890937615
                    }
                ],
                "time_at": "1701135803",
                "token_approve": [],
                "tx_list": {
                    "gas_fee": 0.001966087554160226,
                    "from_address": "0xf31489df794a496f74161cd48c303db893149d63",
                    "name": "ExecTransaction",
                    "function_code": "0x6a761202",
                    "params": [
                        "address,uint256,bytes,uint8,uint256,uint256,uint256,address,address,bytes"
                    ],
                    "status": 1,
                    "to_address": "0xa976ea51b9ba3232706af125a92e32788dc08ddc",
                    "usd_gas_fee": 3.9853,
                    "value": 0.000000000000000000
                }
            },
            {
                "cate_id": "execTransaction",
                "cex_id": null,
                "chain_name": "Ethereum",
                "chain_id": 1,
                "chain_scan_img": "https://www.blockin.ai/image/scan/ethereum.png",
                "chain_scan_tx": "https://www.etherscan.io/tx/",
                "chain_img": "https://www.blockin.ai/image/chain/1.png",
                "chain_token": "ETH",
                "tx": "0x3f790da54c59e882c185711ef29a557ee88b7dcb95c9ecd295c5325f34f085e2",
                "is_scam": false,
                "other_address": "0x17b732b45c3cdfa5c751e0c2cfef807b26a7f883",
                "project_name": null,
                "receives": [],
                "sends": [
                    {
                        "amount": -9.823834350000000000,
                        "from_address": "0xa976ea51b9ba3232706af125a92e32788dc08ddc",
                        "to_address": "0x17b732b45c3cdfa5c751e0c2cfef807b26a7f883",
                        "token_address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
                        "price": 37140.2073088774948178112247694020782827204167892712537272869697056021735113363855854064
                    }
                ],
                "time_at": "1701135611",
                "token_approve": [],
                "tx_list": {
                    "gas_fee": 0.002377476507864190,
                    "from_address": "0xf31489df794a496f74161cd48c303db893149d63",
                    "name": "ExecTransaction",
                    "function_code": "0x6a761202",
                    "params": [
                        "address,uint256,bytes,uint8,uint256,uint256,uint256,address,address,bytes"
                    ],
                    "status": 1,
                    "to_address": "0xa976ea51b9ba3232706af125a92e32788dc08ddc",
                    "usd_gas_fee": 4.8142,
                    "value": 0.000000000000000000
                }
            }
        ],
        "is_big_addr": false,
        "project_dict": {},
        "token_dict": {
            "ETH": {
                "chain_name": "Ethereum",
                "decimal": 18,
                "display_symbol": null,
                "id": "ETH",
                "is_core": true,
                "is_verified": true,
                "is_wallet": true,
                "logo_url": "https://www.blockin.ai/image/token/ETH.png",
                "name": "ETH",
                "optimized_symbol": "ETH",
                "price": null,
                "protocol_name": null,
                "symbol": "ETH",
                "time_at": null,
                "address": null
            },
            "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
                "chain_name": "Ethereum",
                "decimal": 8,
                "display_symbol": null,
                "id": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
                "is_core": true,
                "is_verified": true,
                "is_wallet": true,
                "logo_url": "https://www.blockin.ai/image/token/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599.png",
                "name": "Wrapped BTC",
                "optimized_symbol": "ETH",
                "price": null,
                "protocol_name": null,
                "symbol": "WBTC",
                "time_at": null,
                "address": null
            }
        }
    },
    "error_msg": null,
    "error_code": null
}