/binance-web3-openapi-skill

name: binance-web3-openapi-skill
description: Operate Binance Web3 public market and research APIs through UXC with a curated OpenAPI schema. Use when tasks need token search, token metadata/market snapshots, address holdings, rankings, token audit, or smart money signals on Binance Web3.

Binance Web3 API Skill

Use this skill to run Binance Web3 public read operations through `uxc` + OpenAPI.

Reuse the `uxc` skill for shared execution and error-handling guidance.

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

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`

Authentication

Most operations are public and do not require API credentials.

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