← 返回 Skills 市场

Binance Query Address Info

Name: Binance Query Address Info
Author: binance-skills-hub

作者 binance-skills-hub · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

194

总下载

当前安装

版本数

在 OpenClaw 中安装

/install binance-web3-query-address-info

功能描述

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

使用说明 (SKILL.md)

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

安全使用建议

This skill uses a public Binance web3 endpoint to fetch on-chain wallet balances and asks for no credentials or local file access, so its behavior is coherent with its description. Before installing, consider: (1) authenticity — the registry entry lacks a homepage/source so the author identity isn't verifiable; (2) privacy — queries target public blockchain addresses (no private data required), but avoid querying addresses you don't have consent to track if that matters for your use case; (3) reliability — public endpoints can be rate-limited or change without notice; handle errors and validate responses. If you need a vendor-verified skill, prefer one with an official homepage or publisher identity.

功能分析

Type: OpenClaw Skill Name: binance-web3-query-address-info Version: 1.0.0 The skill is a standard API integration for querying on-chain wallet balances and token positions via a legitimate Binance Web3 endpoint (web3.binance.com). It contains no executable code, obfuscation, or instructions for data exfiltration, and its behavior aligns perfectly with its stated purpose in SKILL.md.

能力评估

ℹ Purpose & Capability

The name/description match the runtime instructions (a GET to a Binance web3 public endpoint that returns token holdings). One note: the SKILL.md claims author 'binance-web3-team' but the package has no source/homepage; this is an authenticity/branding observation, not a technical inconsistency with functionality.

✓ Instruction Scope

Instructions are narrowly scoped to making an HTTP GET to the documented public API endpoint with specific headers and query parameters. The skill does not instruct reading local files, environment variables, or transmitting unrelated data.

✓ Install Mechanism

There is no install spec or code files; the skill is instruction-only and therefore does not write files or install packages.

✓ Credentials

No environment variables, credentials, or config paths are requested, which is appropriate for a public read-only API call.

✓ Persistence & Privilege

The skill does not request always:true or elevated persistence. It permits autonomous invocation (the platform default), which is expected for skills; this alone is not a concern.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install binance-web3-query-address-info
安装完成后，直接呼叫该 Skill 的名称或使用 /binance-web3-query-address-info 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of the Query Address Info skill. - Enables querying any wallet address for on-chain token balances and positions across supported chains (BSC, Base, Solana). - Returns token details including name, symbol, price, 24h price change, and holding quantity. - Supports pagination via the offset parameter. - Documentation includes API example and details about request/response formats.

元数据

Slug binance-web3-query-address-info

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题