---
id: sm-query-address-info
name: "query-address-info"
url: https://skills.yangsir.net/skill/sm-query-address-info
author: binance
domain: web3
tags: ["blockchain-address", "wallet-information", "binance-api", "transaction-history"]
install_count: 4400
rating: 4.40 (20 reviews)
github: https://github.com/binance/binance-skills-hub
---

# query-address-info

> 查询链上钱包地址的代币持有情况，包括所有代币列表及其当前价格。

**Stats**: 4,400 installs · 4.4/5 (20 reviews)

## Before / After 对比

### 区块链地址资产查询对比

## Readme

# query-address-info

# 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

Weekly Installs1.3KRepository[binance/binance…ills-hub](https://github.com/binance/binance-skills-hub)GitHub Stars473First SeenMar 2, 2026Security Audits[Gen Agent Trust HubPass](/binance/binance-skills-hub/query-address-info/security/agent-trust-hub)[SocketPass](/binance/binance-skills-hub/query-address-info/security/socket)[SnykPass](/binance/binance-skills-hub/query-address-info/security/snyk)Installed oncodex1.3Kopencode1.3Kcursor1.3Kgemini-cli1.3Kgithub-copilot1.3Kamp1.3K

---
*Source: https://skills.yangsir.net/skill/sm-query-address-info*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-query-address-info/markdown*