query-address-info

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Query Address Info Skill

查询地址信息Skill

Overview

概述

This skill queries any on-chain wallet address for token holdings, supporting:

List of all tokens held by a wallet address
Current price of each token
24-hour price change percentage
Holding quantity

本Skill可查询任意链上钱包地址的代币持仓信息，支持：

列出钱包地址持有的所有代币
每个代币的当前价格
24小时价格涨跌幅百分比
持仓数量

API Endpoint

API端点

Query Wallet Token Balance

查询钱包代币余额

Method: GET

URL:

https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list

Request Parameters:

Parameter	Type	Required	Description
address	string	Yes	Wallet address, e.g., `0x02e9b4708d41ca10632918edd9e94e21edd82ed1`
chainId	string	Yes	Chain ID, e.g., `56` (BSC), `1` (ETH), `8453` (Base)
offset	number	No	Pagination offset, default 0

Request Headers:

clienttype: web
clientversion: 1.2.0
Accept-Encoding: identity

Example Request:

bash

curl --location 'https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list?address=0x02e9b4708d41ca10632918edd9e94e21edd82ed1&chainId=56&offset=0' \
--header 'clienttype: web' \
--header 'clientversion: 1.2.0' \
--header 'Accept-Encoding: identity'

Response Example:

json

{
    "code": "000000",
    "message": null,
    "messageDetail": null,
    "data": {
        "offset": 0,
        "addressStatus": null,
        "list": [
            {
                "chainId": "56",
                "address": "0x02e9b4708d41ca10632918edd9e94e21edd82ed1",
                "contractAddress": "0xe97b7ba92e5058d0456894ff6f969683cfd44444",
                "name": "The Giraffes",
                "symbol": "GIRAFFES",
                "icon": "/images/web3-data/public/token/logos/A0B22474BF610AE1646962D05D2BE933.png",
                "decimals": 18,
                "price": "0.0000045375251839978",
                "percentChange24h": "6.84",
                "remainQty": "20"
            }
        ]
    },
    "success": true
}

Response Fields:

Field	Type	Description
chainId	string	Chain ID
address	string	Wallet address
contractAddress	string	Token contract address
name	string	Token name
symbol	string	Token symbol
icon	string	Token icon URL path
decimals	number	Token decimals
price	string	Current price (USD)
percentChange24h	string	24-hour price change (%)
remainQty	string	Holding quantity

请求方法: GET

请求URL:

https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list

请求参数:

参数名	类型	是否必填	描述
address	string	是	钱包地址，例如： `0x02e9b4708d41ca10632918edd9e94e21edd82ed1`
chainId	string	是	链ID，例如： `56` (BSC)、 `1` (ETH)、 `8453` (Base)
offset	number	否	分页偏移量，默认值为0

请求头:

clienttype: web
clientversion: 1.2.0
Accept-Encoding: identity

请求示例:

bash

curl --location 'https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list?address=0x02e9b4708d41ca10632918edd9e94e21edd82ed1&chainId=56&offset=0' \
--header 'clienttype: web' \
--header 'clientversion: 1.2.0' \
--header 'Accept-Encoding: identity'

响应示例:

json

{
    "code": "000000",
    "message": null,
    "messageDetail": null,
    "data": {
        "offset": 0,
        "addressStatus": null,
        "list": [
            {
                "chainId": "56",
                "address": "0x02e9b4708d41ca10632918edd9e94e21edd82ed1",
                "contractAddress": "0xe97b7ba92e5058d0456894ff6f969683cfd44444",
                "name": "The Giraffes",
                "symbol": "GIRAFFES",
                "icon": "/images/web3-data/public/token/logos/A0B22474BF610AE1646962D05D2BE933.png",
                "decimals": 18,
                "price": "0.0000045375251839978",
                "percentChange24h": "6.84",
                "remainQty": "20"
            }
        ]
    },
    "success": true
}

响应字段:

字段名	类型	描述
chainId	string	链ID
address	string	钱包地址
contractAddress	string	代币合约地址
name	string	代币名称
symbol	string	代币符号
icon	string	代币图标URL路径
decimals	number	代币精度
price	string	当前价格（美元）
percentChange24h	string	24小时价格涨跌幅（%）
remainQty	string	持仓数量

Supported Chains

支持的链

Chain Name	chainId
BSC	56
Ethereum	1
Base	8453
Solana	CT_501

链名称	chainId
BSC	56
Ethereum	1
Base	8453
Solana	CT_501

Use Cases

使用场景

Query Wallet Assets: When users want to view tokens held by a wallet address
Track Holdings: Monitor wallet token positions
Portfolio Analysis: Understand wallet asset allocation

查询钱包资产: 当用户想要查看某个钱包地址持有的代币时
追踪持仓: 监控钱包的代币持仓情况
投资组合分析: 了解钱包的资产分配情况

Notes

注意事项

Icon URL requires full domain prefix:
```
bin.bnbstatic.com
```
+ icon path
Price and quantity are string format, convert to numbers when using
Use offset parameter for pagination

图标URL需要添加完整域名前缀：
```
bin.bnbstatic.com
```
+ 图标路径
价格和数量为字符串格式，使用时请转换为数字类型
可使用offset参数进行分页查询