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