查询地址信息技能 - 查询链上钱包资产、代币价格和持仓情况 | Binance Skills Hub

query-address-info by binance/binance-skills-hub

1,700 周安装量

516 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/binance/binance-skills-hub --skill query-address-info

开发数据分析区块链

🇨🇳中文介绍

查询地址信息技能

概述

此技能可查询任意链上钱包地址的资产持有情况，支持：

钱包地址持有的所有代币列表
每种代币的当前价格
24小时价格变化百分比
持有数量

API 端点

查询钱包代币余额

方法 : GET

URL :

https://web3.binance.com/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list

请求参数 :

参数	类型	必填	说明
address	string	是	钱包地址，例如 `0x0000000000000000000000000000000000000001`
chainId	string

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

685,800 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

240,900 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

193,000 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

125,300 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

clienttype: web
clientversion: 1.2.0
Accept-Encoding: identity
User-Agent: binance-web3/1.0 (Skill)

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)'

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

字段	类型	说明
chainId	string	链 ID
address	string	钱包地址
contractAddress	string	代币合约地址
name	string	代币名称
symbol	string	代币符号
icon	string	代币图标 URL 路径
decimals	number	代币小数位数
price	string	当前价格 (USD)
percentChange24h	string	24小时价格变化 (%)
remainQty	string	持有数量

链名称	chainId
BSC	56
Base	8453
Solana	CT_501

查询钱包资产 : 当用户想要查看钱包地址持有的代币时
跟踪持仓 : 监控钱包的代币持仓情况
投资组合分析 : 了解钱包的资产配置情况

包含 User-Agent 头，其字符串为：binance-web3/1.0 (Skill)

图标 URL 需要完整的域名前缀：bin.bnbstatic.com + 图标路径
价格和数量为字符串格式，使用时需转换为数字
使用 offset 参数进行分页

🇺🇸English

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

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 Installs

603

Repository

binance/binance…ills-hub

GitHub Stars

396

First Seen

10 days ago

Security Audits

Gen Agent Trust HubPass SocketFail SnykPass

Installed on

codex582

opencode581

gemini-cli580

github-copilot580

amp580

cursor580