query-address-info

Original：🇺🇸 English

Not 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.

2installs

Sources60007766/binance-openclaw

Added on2026-04-06

NPX Install

npx skill4agent add s60007766/binance-openclaw query-address-info

SKILL.md Content

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:

bash

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:

json

{
    "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