Binance Web3 API Skill

uxc

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

Scope

web3.binance.com

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

• Binance Spot / account trading APIs
• Binance Square posting
• K-line candles hosted on

  https://dquery.sintral.io

Authentication

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

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

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

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

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

  .

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