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

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, 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

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

Response Content

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

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

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