Agent Skill · Binance
query-address-info
Query any on-chain wallet address token balances and positions. Retrieves all token holdings for a specified wallet address on a given chain, including token name, symbol, price, 24h price change, and holding quantity. Use this skill when users ask about wallet balance, token holds, portfolio, or asset positions for any blockchain address.
Skill body
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/ai
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.1 (Skill)
Example Request:
curl --location 'https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list/ai?address=0x0000000000000000000000000000000000000001&chainId=56&offset=0' \
--header 'clienttype: web' \
--header 'clientversion: 1.2.0' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (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.1 (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
Skill frontmatter
metadata: {"author" => "binance-web3-team", "version" => "1.1"}
Work with this as data
Every skill here is available over the APIs.io API and to AI agents over MCP.