Back to Details

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

核心工作流程

  1. 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
  2. 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
  3. 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}'
  1. 默认使用固定链接命令：
    • 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
  2. 先查看操作架构：
    • 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
  3. 执行操作：
    • 键值对形式： 
      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

参考资料