Query liquidity change list by chain name and pool address

Description

• Method: HTTPS POST

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/dexs/pool/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	Pool 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/pool/liquidity_change_list' -H 'Accesskey: 1bdb01c947c54919b64d1fc6794atest' -H 'Content-Type: application/json' --data '{"chain_name": "eth","address": "0x2673099769201c08e9a5e63b25fbaf25541a6557","page": 1,"page_size": 20,"start_usd_value": 13915114,"end_usd_value": 13915115,"start_timestamp": 1695268139,"end_timestamp": 1695268139}'

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": "0x2673099769201c08e9a5e63b25fbaf25541a6557",
                "account": "0xa79828df1850e8a3a3064576f380d90aecdd3359",
                "usd_value": 13915114.769739657979944712,
                "type": "burn",
                "tokens": [
                    {
                        "address": "0xdf3ac4f479375802a821f7b7b46cd7eb5e4262cc",
                        "name": "eUSD",
                        "symbol": "eUSD",
                        "decimal": 18,
                        "amount": 0,
                        "price": 0,
                        "logo_url": "https://www.blockin.ai/image/token/0xdf3ac4f479375802a821f7b7b46cd7eb5e4262cc.png"
                    },
                    {
                        "address": "0x6c3f90f043a72fa612cbac8115ee7e52bde6e490",
                        "name": "Curve.fi DAI/USDC/USDT",
                        "symbol": "3Crv",
                        "decimal": 18,
                        "amount": 13559792.514087444932815531,
                        "price": 1.026204107126496525,
                        "logo_url": "https://www.blockin.ai/image/token/0x6c3f90f043a72fa612cbac8115ee7e52bde6e490.png"
                    }
                ],
                "block_time": 1695268139,
                "tx": "0xafee13e7e61fbf7df0da74dfe1179301710dd04b80839f538d5612035440316a"
            }
        ]
    },
    "error_code": null,
    "error_msg": null
}

Failed Response Sample

{
    "success": false,
    "data": null,
    "error_code": "Unauthorized",
    "error_msg": "AccessKey status error"
}