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"
}

Last updated