binance-web3-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Binance Web3 API Skill

Binance Web3 API 技能

Use this skill to run Binance Web3 public read operations through

uxc

+ OpenAPI.

Reuse the

uxc

skill for shared execution and error-handling guidance.

使用本技能可通过

uxc

+ OpenAPI执行Binance Web3的公开只读操作。

可复用

uxc

技能中的通用执行与错误处理指引。

Prerequisites

前置条件

```
uxc
```
is installed and available in
```
PATH
```
.
Network access to
```
https://web3.binance.com
```
.

Access to the curated OpenAPI schema URL:

https://raw.githubusercontent.com/holon-run/uxc/main/skills/binance-web3-openapi-skill/references/binance-web3.openapi.json

已安装
```
uxc
```
且其路径已加入
```
PATH
```
环境变量。
可访问
```
https://web3.binance.com
```
的网络环境。

可访问精选OpenAPI架构的URL：

https://raw.githubusercontent.com/holon-run/uxc/main/skills/binance-web3-openapi-skill/references/binance-web3.openapi.json

Scope

适用范围

This skill covers the public

web3.binance.com

endpoints for:

token search
token metadata
token market snapshots
address holdings
token security audit
social hype leaderboard
unified token ranks
meme rush ranks
smart money signals

This skill does not cover:

Binance Spot / account trading APIs
Binance Square posting
K-line candles hosted on
```
https://dquery.sintral.io
```

本技能涵盖

web3.binance.com

的以下公开接口：

代币搜索
代币元数据
代币市场快照
地址持仓
代币安全审计
社交热度排行榜
统一代币排名
Meme币热潮排名
聪明资金信号

本技能不涵盖：

Binance现货/账户交易API
Binance Square发帖功能
托管在
```
https://dquery.sintral.io
```
上的K线数据

Authentication

身份验证

Most operations are public and do not require API credentials.

大多数操作均为公开访问，无需API凭证。

Core Workflow

核心工作流程

Use the fixed link command by default:

```
command -v binance-web3-openapi-cli
```

If missing, create it:

uxc link binance-web3-openapi-cli https://web3.binance.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/binance-web3-openapi-skill/references/binance-web3.openapi.json

```
binance-web3-openapi-cli -h
```

Inspect operation schema first:

binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search -h

binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/security/token/audit -h

Execute operation:

key/value:

binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search keyword=bnb chainIds=56 orderBy=volume24h

positional JSON:

binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list '{"rankType":10,"chainId":"56","period":50,"page":1,"size":20}'

默认使用固定链接命令：

```
command -v binance-web3-openapi-cli
```

若不存在则创建：

uxc link binance-web3-openapi-cli https://web3.binance.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/binance-web3-openapi-skill/references/binance-web3.openapi.json

```
binance-web3-openapi-cli -h
```

先查看操作架构：

binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search -h

binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/security/token/audit -h

执行操作：

键值对形式：

binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search keyword=bnb chainIds=56 orderBy=volume24h

位置参数JSON形式：

binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list '{"rankType":10,"chainId":"56","period":50,"page":1,"size":20}'

Operation Groups

操作分组

Token Discovery And Market Snapshot

代币发现与市场快照

Search tokens:

get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search

Fetch token metadata:

get:/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info

Fetch token market data:

get:/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info

搜索代币：

get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search

获取代币元数据：

get:/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info

获取代币市场数据：

get:/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info

Rankings And Signals

排名与信号

Social hype leaderboard:

get:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard

Unified token rank:

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list

Meme rush rank:

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/rank/list

Smart money signals:

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money

社交热度排行榜：

get:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard

统一代币排名：

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list

Meme币热潮排名：

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/rank/list

聪明资金信号：

post:/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money

Research

研究分析

Address holdings:

get:/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list

Token audit:

post:/bapi/defi/v1/public/wallet-direct/security/token/audit

地址持仓：

get:/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list

代币审计：

post:/bapi/defi/v1/public/wallet-direct/security/token/audit

Guardrails

注意事项

Keep automation on the JSON output envelope; do not use
```
--text
```
.
Parse stable envelope fields first:
```
ok
```
,
```
kind
```
,
```
protocol
```
,
```
data
```
,
```
error
```
.
Binance Web3 responses usually wrap payloads as
```
code
```
,
```
message
```
,
```
success
```
,
```
data
```
; treat
```
code == "000000"
```
as success.
```
audit
```
requires a UUID v4
```
requestId
```
; generate one for every request instead of reusing old IDs.
Address holdings requires operation-level headers
```
clienttype=web
```
and
```
clientversion=1.2.0
```
; keep them scoped to that operation instead of injecting them host-wide.
For non-string objects, prefer positional JSON instead of flattening complex filters into many
```
key=value
```
args.

binance-web3-openapi-cli <operation> ...

is equivalent to

uxc https://web3.binance.com --schema-url <binance_web3_openapi_schema> <operation> ...

自动化处理时请使用JSON输出格式，不要使用
```
--text
```
参数。
优先解析稳定的外层字段：
```
ok
```
、
```
kind
```
、
```
protocol
```
、
```
data
```
、
```
error
```
。
Binance Web3的响应通常将数据包裹在
```
code
```
、
```
message
```
、
```
success
```
、
```
data
```
字段中；当
```
code == "000000"
```
时表示请求成功。
```
audit
```
操作需要UUID v4格式的
```
requestId
```
；每次请求都需生成新的ID，不要复用旧ID。
地址持仓操作需要添加操作级别的请求头
```
clienttype=web
```
和
```
clientversion=1.2.0
```
；请仅在该操作中添加，不要全局注入。
对于非字符串类型的对象，建议使用位置参数JSON形式，不要将复杂过滤器拆分为多个
```
key=value
```
参数。

binance-web3-openapi-cli <operation> ...

等效于

uxc https://web3.binance.com --schema-url <binance_web3_openapi_schema> <operation> ...

。

References

参考资料

Usage patterns:
```
references/usage-patterns.md
```
Curated OpenAPI schema:
```
references/binance-web3.openapi.json
```
Binance skills hub source material: https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3

使用模式：
```
references/usage-patterns.md
```
精选OpenAPI架构：
```
references/binance-web3.openapi.json
```
Binance技能中心源资料：https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3