binance-web3-openapi-skill: Скилл для работы с Binance Web3 API

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