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
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
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
success
Y
Boolean
Success Boolean
data
N
List
Response list
error_code
N
String
Error code
error_msg
N
String
Error message
Data Content
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
id
Y
String
Function name id
name
Y
String
Function name
Cex_dict Content
id
N
String
id
is_vault
N
Boolean
logo_url
N
String
cex's logo
name
N
String
cex's name
History_list Content
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
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
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
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
spender
N
String
token_address
N
String
Token address
value
N
String
Authorized value
Project_dict Content
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
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
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
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
}
Last updated