Query liquidity change list by chain name and token address
Description
Method: HTTPS POST
Encoding: UTF-8
Path: https://api.blockin.ai/v2/dexs/token/liquidity_change_list
Description: Query the adding and removing liquidity list of a pool
Request Header
Content-Type
Y
String
application/json
AccessKey
Y
String
1bdb01c947c54919b64d1fc6794atest
Request Parameters
chain_name
Y
String
Chain's name, only support ethereum
address
Y
String
Token address
page
Y
Integer
Page num
page_size
Y
Integer
Page size (The maximum size is 100)
start_usd_value
N
BigDecimal
minimum usd value
end_usd_value
N
BigDecimal
maximum usd value
start_timestamp
N
Long
Start timestamp (Default is the last three months, timestamp in seconds)
end_timestamp
N
Long
End timestamp (Timestamp in seconds)
Response
Public Response
success
Y
Boolean
Success Boolean
data
Y
JSONObject
Response object
error_code
N
String
Error code
error_msg
N
String
Error message
Response Content
total
Y
Integer
Total number
current
Y
Integer
Current page number
count_page
Y
Integer
Total page number
page_size
Y
Integer
Current page size
records
Y
List
Paginated list
Records Content
account
Y
String
User address
protocol_name
Y
String
Protocol's name
project_name
Y
String
Project's name
logo_url
Y
String
URL of the protocol's logo image
site_url
Y
String
Website url
pool_address
Y
String
Pool address
usd_value
Y
BigDecimal
USD value
type
Y
String
Type (mint,burn)
tokens
Y
List
Token info list
block_time
Y
Long
Transaction time (Timestamp in seconds)
tx
Y
String
Transaction hash
Tokens Content
address
Y
String
Token's address
name
Y
String
Token's name
symbol
Y
String
Token's symbol
decimal
Y
Integer
Token's decimal
amount
Y
BigDecimal
Token's amount
price
N
BigDecimal
Token's price
logo_url
Y
String
Token's logo
Request Sample
curl -X POST 'https://api.blockin.ai/v2/dexs/token/liquidity_change_list' -H 'Accesskey: 1bdb01c947c54919b64d1fc6794atest' -H 'Content-Type: application/json' --data '{"chain_name": "eth","address": "0x6c3f90f043a72fa612cbac8115ee7e52bde6e490","page": 1,"page_size": 20,"start_usd_value": 32300320,"end_usd_value": 32300321,"start_timestamp": 1695286019,"end_timestamp": 1695286019}'
Successful Response Sample
{
"success": true,
"data": {
"total": 1,
"current": 1,
"count_page": 1,
"page_size": 20,
"records": [
{
"protocol_name": "curve",
"project_name": "Curve",
"logo_url": "https://www.blockin.ai/image/protocol/curve.png",
"site_url": "https://curve.fi/",
"pool_address": "0x5a6a4d54456819380173272a5e8e9b9904bdf41b",
"account": "0x07b577f10d4e00f3018542d08a87f255a49175a5",
"usd_value": 32300320.734432003201542923,
"type": "burn",
"tokens": [
{
"address": "0x99d8a9c45b2eca8864373a26d1459e3dff1e17f3",
"name": "Magic Internet Money",
"symbol": "MIM",
"decimal": 18,
"amount": 0,
"price": 0,
"logo_url": "https://www.blockin.ai/image/token/0x99d8a9c45b2eca8864373a26d1459e3dff1e17f3.png"
},
{
"address": "0x6c3f90f043a72fa612cbac8115ee7e52bde6e490",
"name": "Curve.fi DAI/USDC/USDT",
"symbol": "3Crv",
"decimal": 18,
"amount": 31509216.690595366256064178,
"price": 1.025107067928881892,
"logo_url": "https://www.blockin.ai/image/token/0x6c3f90f043a72fa612cbac8115ee7e52bde6e490.png"
}
],
"block_time": 1695286019,
"tx": "0x3bde9fa9bf21d3c6ef5f893aa4a9433a3cea30abaf5140b99d98ab0264a010c7"
}
]
},
"error_code": null,
"error_msg": null
}
Failed Response Sample
{
"success": false,
"data": null,
"error_code": "Unauthorized",
"error_msg": "AccessKey status error"
}
Last updated