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
  • Data Content
  • Spenders Content
  • Protocol Content
  • Request Sample
  • Successful Response Sample
  1. REFERENCE
  2. API Reference
  3. User

Query token authorized list by chain name and user address

Description

  • Method: HTTPS GET

  • Encoding: UTF-8

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

  • Description:Query token authorized 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

Object

Response object

error_code

N

String

Error code

error_msg

N

String

Error message

Data Content

Parameter
Required
Type
Description

contract_address

N

String

Approved contract's address

name

N

String

Approved contract's name

symbol

N

String

Approved contract's symbol

logo_url

N

String

Approved contract's logo url

chain_name

N

String

Chain name

price

N

BigDecimal

Native token price of the chain

balance

N

BigDecimal

Address's balance of the chain

spenders

N

List

List of object with following fields

sum_exposure_usd

N

BigDecimal

Total number of exposure value denominated in USD

Spenders Content

Parameter
Required
Type
Description

spender_address

N

String

Spender's address

value

N

BigDecimal

Approved amount

exposure_usd

N

BigDecimal

Exposure value with usd

protocol

N

Object

Spender's protocol info

last_approve_block_time

N

Long

Last authorization time

Protocol Content

Parameter
Required
Type
Description

protocol_name

N

String

Protocol's name

project_name

N

String

Project's name

logo_url

N

String

URL of the protocol's logo image

chain_name

N

String

Chain's name

Request Sample

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

Successful Response Sample

{
    "success": true,
    "data": [
        {
            "contract_address": "0xed1840223484483c0cb050e6fc344d1ebf0778a9",
            "name": "Bend interest bearing WETH",
            "symbol": "bendWETH",
            "logo_url": "https://www.blockin.ai/image/token/0xed1840223484483c0cb050e6fc344d1ebf0778a9.png",
            "chain_name": "Ethereum",
            "price": 0,
            "balance": 0.001099195413540551,
            "spenders": [
                {
                    "spender_address": "0x3b968d2d299b895a5fcf3bba7a64ad0f566e6f88",
                    "value": 0.000735960424665247,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "benddao",
                        "project_name": "Bend DAO",
                        "logo_url": "https://www.blockin.ai/image/protocol/benddao.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684370615
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
            "name": "Liquid staked Ether 2.0",
            "symbol": "stETH",
            "logo_url": "https://www.blockin.ai/image/token/0xae7ab96520de3a18e5e111b5eaab095312d7fe84.png",
            "chain_name": "Ethereum",
            "price": 1596.128936761988504085,
            "balance": 2004.017848065853064448,
            "spenders": [
                {
                    "spender_address": "0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
                    "value": 100,
                    "exposure_usd": 159612.89,
                    "protocol": null,
                    "last_approve_block_time": 1684719131
                },
                {
                    "spender_address": "0x1111111254eeb25477b68fb85ed929f73a960582",
                    "value": 18709.495796796023556052,
                    "exposure_usd": 29862767.63,
                    "protocol": {
                        "protocol_name": "1inch2",
                        "project_name": "1inch",
                        "logo_url": "https://www.blockin.ai/image/protocol/1inch2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1690998971
                },
                {
                    "spender_address": "0x7d2768de32b0b80b7a3454c06bdac94a69ddc7a9",
                    "value": 14.934963570560543486,
                    "exposure_usd": 23838.13,
                    "protocol": {
                        "protocol_name": "aave2",
                        "project_name": "Aave V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/aave2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1688516855
                }
            ],
            "sum_exposure_usd": 3198670.88
        },
        {
            "contract_address": "0x06325440d014e39736583c165c2963ba99faf14e",
            "name": "Curve.fi ETH/stETH",
            "symbol": "steCRV",
            "logo_url": "https://www.blockin.ai/image/token/0x06325440d014e39736583c165c2963ba99faf14e.png",
            "chain_name": "Ethereum",
            "price": 0,
            "balance": 0.506323332162388374,
            "spenders": [
                {
                    "spender_address": "0x182b723a58739a9c974cfdb385ceadb237453c28",
                    "value": 0,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "curve",
                        "project_name": "Curve",
                        "logo_url": "https://www.blockin.ai/image/protocol/curve.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684719467
                },
                {
                    "spender_address": "0xf403c135812408bfbe8713b5a23a04b3d48aae31",
                    "value": 3728.064876241736617844,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "curve",
                        "project_name": "Curve",
                        "logo_url": "https://www.blockin.ai/image/protocol/curve.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684719419
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "name": "Tether USD",
            "symbol": "USDT",
            "logo_url": "https://www.blockin.ai/image/token/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
            "chain_name": "Ethereum",
            "price": 1.00028151882212828,
            "balance": 54007.224796,
            "spenders": [
                {
                    "spender_address": "0x7d2768de32b0b80b7a3454c06bdac94a69ddc7a9",
                    "value": 20000000,
                    "exposure_usd": 20005630.38,
                    "protocol": {
                        "protocol_name": "aave2",
                        "project_name": "Aave V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/aave2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1690998623
                }
            ],
            "sum_exposure_usd": 54022.43
        },
        {
            "contract_address": "0x498c00e1ccc2afff80f6cc6144eaeb95c46cc3b5",
            "name": "Uniswap V2",
            "symbol": "UNI-V2",
            "logo_url": "https://www.blockin.ai/image/token/0x498c00e1ccc2afff80f6cc6144eaeb95c46cc3b5.png",
            "chain_name": "Ethereum",
            "price": 0,
            "balance": 0,
            "spenders": [
                {
                    "spender_address": "0xc8187048f7ab0db0774b674fef3f4f4285a01bf4",
                    "value": 5436.885024387348182459,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "agility",
                        "project_name": "Agility",
                        "logo_url": "https://www.blockin.ai/image/protocol/agility.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1681606019
                },
                {
                    "spender_address": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                    "value": 5436.885024387348182459,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "uniswap2",
                        "project_name": "Uniswap V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/uniswap2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1681893755
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "name": "USD Coin",
            "symbol": "USDC",
            "logo_url": "https://www.blockin.ai/image/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png",
            "chain_name": "Ethereum",
            "price": 1.002814495094098804,
            "balance": 0,
            "spenders": [
                {
                    "spender_address": "0x1111111254eeb25477b68fb85ed929f73a960582",
                    "value": 115792089237316195423570985008687907853269984665640564039457584007913129.639935,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "1inch2",
                        "project_name": "1inch",
                        "logo_url": "https://www.blockin.ai/image/protocol/1inch2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684944491
                },
                {
                    "spender_address": "0x000000000022d473030f116ddee9f6b43ac78ba3",
                    "value": 200009,
                    "exposure_usd": 200571.92,
                    "protocol": {
                        "protocol_name": "uniswap2",
                        "project_name": "Uniswap V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/uniswap2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1681605671
                },
                {
                    "spender_address": "0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2",
                    "value": 1499986.826117,
                    "exposure_usd": 1504208.53,
                    "protocol": {
                        "protocol_name": "aave3",
                        "project_name": "Aave V3",
                        "logo_url": "https://www.blockin.ai/image/protocol/aave3.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1681204895
                },
                {
                    "spender_address": "0xcee284f754e854890e311e3280b767f80797180d",
                    "value": 115792089237316195423570985008687907853269984665640564039457584007913129.639935,
                    "exposure_usd": 0.00,
                    "protocol": null,
                    "last_approve_block_time": 1679480543
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0x5f18ea482ad5cc6bc65803817c99f477043dce85",
            "name": "Agility",
            "symbol": "AGI",
            "logo_url": "https://www.blockin.ai/image/token/0x5f18ea482ad5cc6bc65803817c99f477043dce85.png",
            "chain_name": "Ethereum",
            "price": 0.003946394518129187,
            "balance": 0,
            "spenders": [
                {
                    "spender_address": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
                    "value": 40438.816361944625808486,
                    "exposure_usd": 159.59,
                    "protocol": {
                        "protocol_name": "uniswap2",
                        "project_name": "Uniswap V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/uniswap2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1681605959
                },
                {
                    "spender_address": "0x000000000022d473030f116ddee9f6b43ac78ba3",
                    "value": 0,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "uniswap2",
                        "project_name": "Uniswap V2",
                        "logo_url": "https://www.blockin.ai/image/protocol/uniswap2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1683110243
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0x9518c9063eb0262d791f38d8d6eb0aca33c63ed0",
            "name": "Curve.fi ETH/stETH Convex Deposit",
            "symbol": "cvxsteCRV",
            "logo_url": "https://www.blockin.ai/image/token/0x9518c9063eb0262d791f38d8d6eb0aca33c63ed0.png",
            "chain_name": "Ethereum",
            "price": 0,
            "balance": 0,
            "spenders": [
                {
                    "spender_address": "0x0a760466e1b4621579a82a39cb56dda2f4e70f03",
                    "value": 3728.064876241736617844,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "convex",
                        "project_name": "Convex",
                        "logo_url": "https://www.blockin.ai/image/protocol/convex.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684719467
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "name": "Wrapped Ether",
            "symbol": "WETH",
            "logo_url": "https://www.blockin.ai/image/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.png",
            "chain_name": "Ethereum",
            "price": 1604.46276855924276032,
            "balance": 0.000000000068692107,
            "spenders": [
                {
                    "spender_address": "0x1111111254eeb25477b68fb85ed929f73a960582",
                    "value": 2400,
                    "exposure_usd": 3850710.64,
                    "protocol": {
                        "protocol_name": "1inch2",
                        "project_name": "1inch",
                        "logo_url": "https://www.blockin.ai/image/protocol/1inch2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1690986371
                }
            ],
            "sum_exposure_usd": 0.00
        },
        {
            "contract_address": "0x0d02755a5700414b26ff040e1de35d337df56218",
            "name": "Bend Token",
            "symbol": "BEND",
            "logo_url": "https://www.blockin.ai/image/token/0x0d02755a5700414b26ff040e1de35d337df56218.png",
            "chain_name": "Ethereum",
            "price": 0.002929502357025627,
            "balance": 213719.158957856680759356,
            "spenders": [
                {
                    "spender_address": "0x26fc1f11e612366d3367fc0cbfff9e819da91c8d",
                    "value": 115792089237316195423570985008687907853269984665639743769952.855545941079746167,
                    "exposure_usd": 339213198345639530718508516079882745166370875249901236183.98,
                    "protocol": {
                        "protocol_name": "benddao",
                        "project_name": "Bend DAO",
                        "logo_url": "https://www.blockin.ai/image/protocol/benddao.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1684370363
                },
                {
                    "spender_address": "0x1111111254eeb25477b68fb85ed929f73a960582",
                    "value": 0,
                    "exposure_usd": 0.00,
                    "protocol": {
                        "protocol_name": "1inch2",
                        "project_name": "1inch",
                        "logo_url": "https://www.blockin.ai/image/protocol/1inch2.png",
                        "chain_name": "Ethereum"
                    },
                    "last_approve_block_time": 1683902255
                }
            ],
            "sum_exposure_usd": 626.09
        }
    ],
    "error_code": null,
    "error_msg": null
}
PreviousQuery total balance on all supported chains by user addressNextQuery nft authorized list by chain name and user address

Last updated 1 year ago

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

😈
🐙
Enumeration