Query protocol top holders by chain name and protocol name

Description

• Method: HTTPS POST

• Encoding：UTF-8

• Path：https://api.blockin.ai/v2/user/top_list

• Description：Query the list of top holders of a protocol

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 single chain's name (abbr or full name). eg: eth,Ethereum. Enumeration
protocol_name	Y	String	Protocol's name

Response

Public Response

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

UserListTotalResp Content

Parameter	Required	Type	Description
user_list	Y	List<UserListResp>	Top user info list

UserListResp Content

Parameter	Required	Type	Description
share	Y	BigDecimal	The proportion of users in the total tvl of the protocol
update_at	Y	Long	Update time
usd_value	Y	BigDecimal	Users hold USD assets of the protocol
address	Y	String	User address
ens_name	N	String	ENS name

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/top_list?chain_name=eth&protocol_name=lido"

Successful Response Sample

{
    "success": true,
    "data": {
        "user_list": [
            {
                "share": 0.0802607270,
                "update_at": 1695227920,
                "usd_value": 1132649810.512686,
                "address": "0x1982b2f5814301d4e9a8b0201555376e62f82428",
                "ens_name": null
            },
            {
                "share": 0.0786467411,
                "update_at": 1695227921,
                "usd_value": 1109873031.944046,
                "address": "0x248ccbf4864221fc0e840f29bb042ad5bfc89b5c",
                "ens_name": null
            },
            {
                "share": 0.0775406989,
                "update_at": 1695227917,
                "usd_value": 1094264421.443018,
                "address": "0x0b925ed163218f6662a35e0f0371ac234f9e9371",
                "ens_name": null
            },
        ....
        ]
    },
    "error_code": null,
    "error_msg": null
}