Blockin.ai OpenAPI
  • Welcome
  • 🥳GETTING STARTED
    • 🗝️Creating an Account
    • 👀Product Overview
  • 😈REFERENCE
    • 🐙API Reference
      • Chain
        • Query available chain list
      • Protocol
        • Query available protocol
        • Query available protocol list
        • Query all available protocol list
        • Query available tagInfo list
        • Query available protocol detail
        • Query available protocol detail list
        • Query all available protocol detail list
        • Query liquidity change list by chain name and pool address
        • Query swap list by chain name and pool address
      • User
        • Query used chain by user address
        • Query chain balance by chain name and user address
        • Query protocol portfolio list by chain name and user address
        • Query protocol portfolios on all chains by user address
        • Query protocol portfolio by chain name, protocol name and user address
        • Query protocol portfolios on all chains by protocol name and user address
        • Query protocol top holders by chain name and protocol name
        • Query simple protocol list by chain name and user address
        • Query simple protocol list on all chains by user address
        • Query token list by chain name and user address
        • Query token list on all chains by user address
        • Query token top holders by chain name and token address
        • Query collections by chain name and user address
        • Query collections on all chains by user address
        • Query collections on Bitcoin by user address
        • Query items by chain name, collection address and user address
        • Query inscriptions on Bitcoin by user address
        • Query items transfer list by chain name and user address
        • Query history list by chain name and user address
        • Query all history list by user address
        • Query User history - Advanced edition
        • Query total balance on all supported chains by user address
        • Query token authorized list by chain name and user address
        • Query nft authorized list by chain name and user address
        • Query 24-hour net assets curve by chain name and user address
        • Query 24-hour net assets curve on all supported chains by user address
        • Query 24-hour protocol portfolios curve by chain name and user address
        • Query 24-hour protocol portfolios curve on all supported chains by user address
        • Query 24-hour wallet curve by chain name and user address
        • Query 24-hour wallet curve on all supported chains by user address
      • Token
        • Query token info
        • Query token info list
        • Query token market info list
        • Subscribe to token kline data
        • Unsubscribe token kline
        • Query pool list by chain name and token address
        • Query liquidity change list by chain name and token address
        • Query swap list by chain name and token address
        • Query real-time exchange rate
        • Query real-time token price
        • Query LP_token info
        • Query symbol's price from foreign exchange
      • NFT
        • Query collection metadata by chain name and collection address
        • Query collection trade list by chain name and collection address
        • Query item info list by chain name and collection address
        • Query item metadata by chain name, collection address and item id
        • Refresh collection metadata
        • Query inscriptions metadata on Bitcoin by inscriptions id
      • Mirror
        • Query historical token list
        • Query historical protocol portfolios
        • Query historical assets
        • Query historical token list on all supported chains
        • Query historical protocol portfolios on all supported chains
        • Query historical assets on all supported chains
        • Query historical LP_token info
      • Subscription
        • Create history subscription
        • Update history subscription
        • Delete history subscription
        • History subscription query
        • Socket Subscription Connection
        • Subscription notify
        • Alter history subscription
        • History subscription- Query Batch_no List
        • Create history subscription V2
        • Delete history subscription V2
        • Query history subscription wallet V2
        • Query history subscription detail V2
        • History subscription Message query V2
        • Socket Subscription Connection V2
    • 📜Enumeration
    • 🎭Error Code
      • Pre exec error code
    • 🍪Related Features
      • Usage
    • ⌨️Change Log
    • 😎Terms of Service
Powered by GitBook
On this page
  • Description
  • Request Header
  • Request Parameters
  • Response
  • Public Response
  • Response Content
  • Request Sample
  • Successful Response Sample
  1. REFERENCE
  2. API Reference
  3. User

Query simple protocol list by chain name and user address

Description

  • Method: HTTPS GET

  • Encoding: UTF-8

  • Path: https://api.blockin.ai/v2/user/simple_protocol_list

  • Description: Query simple protocol list by chain name and user address

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

address

Y

String

User's address

Response

Public Response

Parameter
Required
Type
Description

success

Y

Boolean

Success Boolean

data

N

List

Response object

error_code

N

String

Error code

error_msg

N

String

Error message

Response Content

Parameter
Required
Type
Description

protocol_name

Y

String

Protocol's name

chain_name

Y

String

Chain'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

net_usd_value

Y

BigDecimal

Amount of the user's net assets in the protocol.

asset_usd_value

Y

BigDecimal

Amount of the user's total assets in the protocol.

debt_usd_value

Y

BigDecimal

Debt USD value.

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/simple_protocol_list?address=0x1c3cb7e3920c77eba162cf044f418a854c12ffef&chain_name=eth"

Successful Response Sample

{
    "success": true,
    "data": [
        {
            "protocol_name": "lido",
            "chain_name": "Ethereum",
            "project_name": "LIDO",
            "logo_url": "https://www.blockin.ai/image/protocol/lido.png",
            "site_url": "https://stake.lido.fi",
            "net_usd_value": 0.00000393278602006233,
            "asset_usd_value": 0.00000393278602006233,
            "debt_usd_value": 0
        },
        {
            "protocol_name": "snowswap",
            "chain_name": "Ethereum",
            "project_name": "SnowSwap",
            "logo_url": "https://www.blockin.ai/image/protocol/snowswap.png",
            "site_url": "https://snowswap.org",
            "net_usd_value": 551614.24120078157577403559634146066929563177,
            "asset_usd_value": 551614.24120078157577403559634146066929563177,
            "debt_usd_value": 0
        },
        {
            "protocol_name": "curve",
            "chain_name": "Ethereum",
            "project_name": "Curve",
            "logo_url": "https://www.blockin.ai/image/protocol/curve.png",
            "site_url": "https://curve.fi/",
            "net_usd_value": 551614.24120078157577403559634146066929563177,
            "asset_usd_value": 551614.24120078157577403559634146066929563177,
            "debt_usd_value": 0
        }
    ],
    "error_code": null,
    "error_msg": null
}
PreviousQuery protocol top holders by chain name and protocol nameNextQuery simple protocol list on all chains by user address

Last updated 1 year ago

Chain's name,support single chain's name. eg: eth,Ethereum.

😈
🐙
Enumeration