Query pool list by chain name and token address

Description

• Method: HTTPS POST

• Encoding：UTF-8

• Path：https://api.blockin.ai/v2/dexs/token/pool_list

• Description：Query the relevant pool list based on the token, and the top 100 are queried by default

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 number
page_size	Y	Integer	Page size (The maximum page size is 100)
order_by	N	String	Sorting field (tvl,volume_24h), defaults to tvl in reverse order
top	N	Integer	Query top n pools

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
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
pool_name	Y	String	Pool name
tokens	Y	List	Token info list
tvl	N	BigDecimal	TVL in USD
volume_24h	N	BigDecimal	24 hour volume in USD

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/pool_list' -H 'Accesskey: 1bdb01c947c54919b64d1fc6794atest' -H 'Content-Type: application/json' --data '{"chain_name": "eth","address": "0x8e870d67f660d95d5be530380d0ec0bd388289e1","page": 1,"page_size": 10,"order_by": "tvl","top": 1}'

Successful Response Sample

{
  "success": true,
  "data": {
    "total": 1,
    "current": 1,
    "count_page": 1,
    "page_size": 10,
    "records": [
      {
        "protocol_name": "uniswap2",
        "project_name": "Uniswap V2",
        "logo_url": "https://www.blockin.ai/image/protocol/uniswap2.png",
        "site_url": "https://app.uniswap.org",
        "pool_address": "0x142390917526d47946a26dda1e7a555821dcf2cd",
        "pool_name": "RAZOR/USDP",
        "tokens": [
          {
            "address": "0x50de6856358cc35f3a9a57eaaa34bd4cb707d2cd",
            "name": "RAZOR",
            "symbol": "RAZOR",
            "decimal": 18,
            "amount": 21010989.644679196,
            "price": 0.004050012610379891,
            "logo_url": "https://www.blockin.ai/image/token/0x50de6856358cc35f3a9a57eaaa34bd4cb707d2cd.png"
          },
          {
            "address": "0x8e870d67f660d95d5be530380d0ec0bd388289e1",
            "name": "Pax Dollar",
            "symbol": "USDP",
            "decimal": 18,
            "amount": 85103.68427127892,
            "price": 0.9994535629200868,
            "logo_url": "https://www.blockin.ai/image/token/0x8e870d67f660d95d5be530380d0ec0bd388289e1.png"
          }
        ],
        "tvl": 170151.95348006792,
        "volume_24h": 2823.3751271136102
      }
    ]
  },
  "error_code": null,
  "error_msg": null
}

Failed Response Sample

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