query-address-info

Original：🇺🇸 English

Translated

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.

12installs

Sourcebinance/binance-skills-hub

Added on2026-03-03

NPX Install

npx skill4agent add binance/binance-skills-hub query-address-info

SKILL.md Content

View Translation Comparison →

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., `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

Supported Chains

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