zhuyansen Query Address Info 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
API Endpoint
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., 0x0000000000000000000000000000000000000001 |
| chainId | string | Yes | Chain ID, e.g., 56 (BSC), 8453 (Base) |
| offset | number | Yes | Pagination offset, default 0 |
Request Headers:
clienttype: web
clientversion: 1.2.0
Accept-Encoding: identity
User-Agent: binance-web3/1.0 (Skill)
Example Request:
curl --location 'https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list?address=0x0000000000000000000000000000000000000001&chainId=56&offset=0' \
--header 'clienttype: web' \
--header 'clientversion: 1.2.0' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.0 (Skill)'
Response Example:
{
"code": "000000",
"message": null,
"messageDetail": null,
"data": {
"offset": 0,
"addressStatus": null,
"list": [
{
"chainId": "56",
"address": "0x0000000000000000000000000000000000000001",
"contractAddress": "token contract address",
"name": "name of token",
"symbol": "symbol of token",
"icon": "/images/web3-data/public/token/logos/xxxx.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 |
Supported Chains
| Chain Name | chainId |
|---|---|
| BSC | 56 |
| 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
User Agent Header
Include User-Agent header with the following string: binance-web3/1.0 (Skill)
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