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