Skill: jolestar/binance-web3-openapi-skill (version 1.0.0)

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

path: agents/openai.yaml
content: interface:
  display_name: "Binance Web3 API"
  short_description: "Operate Binance Web3 public token, address holdings, ranking, audit, and signal APIs via UXC + OpenAPI schema mapping"
  default_prompt: "Use $binance-web3-openapi-skill to discover and execute Binance Web3 public read operations through UXC with the curated OpenAPI schema and operation-level headers where required."


path: references/binance-web3.openapi.json
content: {
  "openapi": "3.1.0",
  "info": {
    "title": "Binance Web3 Public API",
    "version": "1.0.0",
    "description": "Curated OpenAPI schema for selected public Binance Web3 endpoints on web3.binance.com."
  },
  "servers": [
    {
      "url": "https://web3.binance.com"
    }
  ],
  "paths": {
    "/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search": {
      "get": {
        "summary": "Search tokens",
        "description": "Search tokens by keyword, optionally filtered by chain IDs and sort order.",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chainIds",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Comma-separated Binance chain IDs such as 56,8453,CT_501."
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Token search results",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenSearchEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info": {
      "get": {
        "summary": "Get token metadata",
        "description": "Fetch token metadata, social links, creator address, and description.",
        "parameters": [
          {
            "name": "chainId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "contractAddress",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Token metadata",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenMetadataEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info": {
      "get": {
        "summary": "Get token market data",
        "description": "Fetch real-time token market data such as price, volume, holder counts, and liquidity.",
        "parameters": [
          {
            "name": "chainId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "contractAddress",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Token market data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenMarketEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list": {
      "get": {
        "summary": "List address active positions",
        "description": "Fetch active token positions for a wallet address. This endpoint requires operation-level browser-style headers and should not be modeled as host-wide defaults.",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chainId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "name": "clienttype",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clientversion",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Address active positions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AddressPositionsEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/security/token/audit": {
      "post": {
        "summary": "Audit token security",
        "description": "Run Binance Web3 token security checks such as contract risk, trading risk, and scam risk.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenAuditRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Token audit result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenAuditEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard": {
      "get": {
        "summary": "Get social hype leaderboard",
        "description": "Retrieve Binance Web3 social hype leaderboard entries by chain and time range.",
        "parameters": [
          {
            "name": "chainId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "targetLanguage",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timeRange",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sentiment",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "All",
                "Positive",
                "Negative",
                "Neutral"
              ]
            }
          },
          {
            "name": "socialLanguage",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Social hype leaderboard",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialHypeLeaderboardEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/unified/rank/list": {
      "post": {
        "summary": "List unified token rank",
        "description": "Query trending, top search, alpha, or stock token rankings.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UnifiedRankRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Unified token ranking",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnifiedRankEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/rank/list": {
      "post": {
        "summary": "List meme rush rank",
        "description": "Query meme token launchpad rankings such as New, Finalizing, and Migrated.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemeRushRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Meme rush ranking",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemeRushEnvelope"
                }
              }
            }
          }
        }
      }
    },
    "/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money": {
      "post": {
        "summary": "List smart money signals",
        "description": "Retrieve Binance Web3 smart money buy and sell signals.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SmartMoneySignalsRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Smart money signals",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SmartMoneySignalsEnvelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "EnvelopeBase": {
        "type": "object",
        "properties": {
          "code": {
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "messageDetail": {
            "type": [
              "string",
              "null"
            ]
          },
          "success": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "LinkItem": {
        "type": "object",
        "properties": {
          "label": {
            "type": [
              "string",
              "null"
            ]
          },
          "link": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "TokenSearchItem": {
        "type": "object",
        "properties": {
          "chainId": {
            "type": "string"
          },
          "contractAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "tokenId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange24h": {
            "type": [
              "string",
              "null"
            ]
          },
          "volume24h": {
            "type": [
              "string",
              "null"
            ]
          },
          "marketCap": {
            "type": [
              "string",
              "null"
            ]
          },
          "liquidity": {
            "type": [
              "string",
              "null"
            ]
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinkItem"
            }
          }
        },
        "additionalProperties": true
      },
      "TokenSearchEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/TokenSearchItem"
                }
              }
            }
          }
        ]
      },
      "TokenMetadata": {
        "type": "object",
        "properties": {
          "tokenId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "chainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "chainName": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "decimals": {
            "type": [
              "integer",
              "null"
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "creatorAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinkItem"
            }
          }
        },
        "additionalProperties": true
      },
      "TokenMetadataEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/TokenMetadata"
              }
            }
          }
        ]
      },
      "TokenMarketData": {
        "type": "object",
        "properties": {
          "price": {
            "type": [
              "string",
              "null"
            ]
          },
          "nativeTokenPrice": {
            "type": [
              "string",
              "null"
            ]
          },
          "volume24h": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange5m": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange1h": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange4h": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange24h": {
            "type": [
              "string",
              "null"
            ]
          },
          "marketCap": {
            "type": [
              "string",
              "null"
            ]
          },
          "fdv": {
            "type": [
              "string",
              "null"
            ]
          },
          "liquidity": {
            "type": [
              "string",
              "null"
            ]
          },
          "holders": {
            "type": [
              "string",
              "null"
            ]
          },
          "top10HoldersPercentage": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "TokenMarketEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/TokenMarketData"
              }
            }
          }
        ]
      },
      "AddressPositionItem": {
        "type": "object",
        "properties": {
          "chainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "tokenId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "string",
              "null"
            ]
          },
          "percentChange24h": {
            "type": [
              "string",
              "null"
            ]
          },
          "remainQty": {
            "type": [
              "string",
              "null"
            ]
          },
          "costAmount": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": [
              "string",
              "null"
            ]
          },
          "pnlAmount": {
            "type": [
              "string",
              "null"
            ]
          },
          "pnlPercent": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "AddressPositionsData": {
        "type": "object",
        "properties": {
          "offset": {
            "type": [
              "integer",
              "null"
            ]
          },
          "addressStatus": {
            "type": [
              "string",
              "null"
            ]
          },
          "list": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AddressPositionItem"
            }
          }
        },
        "additionalProperties": true
      },
      "AddressPositionsEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/AddressPositionsData"
              }
            }
          }
        ]
      },
      "TokenAuditRequest": {
        "type": "object",
        "required": [
          "binanceChainId",
          "contractAddress",
          "requestId"
        ],
        "properties": {
          "binanceChainId": {
            "type": "string"
          },
          "contractAddress": {
            "type": "string"
          },
          "requestId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "additionalProperties": false
      },
      "RiskItemDetail": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "isHit": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "riskType": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "RiskItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskItemDetail"
            }
          }
        },
        "additionalProperties": true
      },
      "TokenAuditData": {
        "type": "object",
        "properties": {
          "requestId": {
            "type": [
              "string",
              "null"
            ]
          },
          "hasResult": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "isSupported": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "riskLevelEnum": {
            "type": [
              "string",
              "null"
            ]
          },
          "riskLevel": {
            "type": [
              "integer",
              "null"
            ]
          },
          "extraInfo": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "riskItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RiskItem"
            }
          }
        },
        "additionalProperties": true
      },
      "TokenAuditEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/TokenAuditData"
              }
            }
          }
        ]
      },
      "SocialHypeLeaderboardItem": {
        "type": "object",
        "properties": {
          "metaInfo": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "marketInfo": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "socialHypeInfo": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      },
      "SocialHypeLeaderboardData": {
        "type": "object",
        "properties": {
          "leaderBoardList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SocialHypeLeaderboardItem"
            }
          }
        },
        "additionalProperties": true
      },
      "SocialHypeLeaderboardEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/SocialHypeLeaderboardData"
              }
            }
          }
        ]
      },
      "UnifiedRankRequest": {
        "type": "object",
        "properties": {
          "rankType": {
            "type": "integer",
            "enum": [
              10,
              11,
              20,
              40
            ]
          },
          "chainId": {
            "type": "string"
          },
          "period": {
            "type": "integer"
          },
          "sortBy": {
            "type": "integer"
          },
          "orderAsc": {
            "type": "boolean"
          },
          "page": {
            "type": "integer",
            "minimum": 1
          },
          "size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          }
        },
        "additionalProperties": true
      },
      "RankTokenItem": {
        "type": "object",
        "properties": {
          "chainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "string",
              "null"
            ]
          },
          "marketCap": {
            "type": [
              "string",
              "null"
            ]
          },
          "liquidity": {
            "type": [
              "string",
              "null"
            ]
          },
          "holders": {
            "type": [
              "string",
              "null"
            ]
          },
          "launchTime": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "UnifiedRankData": {
        "type": "object",
        "properties": {
          "tokens": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankTokenItem"
            }
          },
          "total": {
            "type": [
              "integer",
              "null"
            ]
          },
          "page": {
            "type": [
              "integer",
              "null"
            ]
          },
          "size": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "UnifiedRankEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/UnifiedRankData"
              }
            }
          }
        ]
      },
      "MemeRushRequest": {
        "type": "object",
        "required": [
          "chainId",
          "rankType"
        ],
        "properties": {
          "chainId": {
            "type": "string"
          },
          "rankType": {
            "type": "integer",
            "enum": [
              10,
              20,
              30
            ]
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "excludes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": true
      },
      "MemeRushData": {
        "type": "object",
        "properties": {
          "tokens": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankTokenItem"
            }
          },
          "total": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "MemeRushEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/MemeRushData"
              }
            }
          }
        ]
      },
      "SmartMoneySignalsRequest": {
        "type": "object",
        "required": [
          "page",
          "pageSize",
          "chainId"
        ],
        "properties": {
          "smartSignalType": {
            "type": "string"
          },
          "page": {
            "type": "integer",
            "minimum": 1
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "chainId": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "SmartMoneySignalItem": {
        "type": "object",
        "properties": {
          "signalId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "ticker": {
            "type": [
              "string",
              "null"
            ]
          },
          "chainId": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractAddress": {
            "type": [
              "string",
              "null"
            ]
          },
          "smartSignalType": {
            "type": [
              "string",
              "null"
            ]
          },
          "smartMoneyCount": {
            "type": [
              "integer",
              "null"
            ]
          },
          "direction": {
            "type": [
              "string",
              "null"
            ]
          },
          "signalTriggerTime": {
            "type": [
              "integer",
              "null"
            ]
          },
          "alertPrice": {
            "type": [
              "string",
              "null"
            ]
          },
          "currentPrice": {
            "type": [
              "string",
              "null"
            ]
          },
          "maxGain": {
            "type": [
              "string",
              "null"
            ]
          },
          "exitRate": {
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      },
      "SmartMoneySignalsEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/EnvelopeBase"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SmartMoneySignalItem"
                }
              }
            }
          }
        ]
      }
    }
  }
}


path: references/usage-patterns.md
content: # Binance Web3 API Skill - Usage Patterns

## Link Setup

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

## Read Examples

```bash
# Search tokens by keyword
binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search \
  keyword=bnb chainIds=56 orderBy=volume24h

# Get token metadata
binance-web3-openapi-cli get:/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info \
  chainId=56 contractAddress=0x55d398326f99059ff775485246999027b3197955

# Get token market snapshot
binance-web3-openapi-cli get:/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info \
  chainId=56 contractAddress=0x55d398326f99059ff775485246999027b3197955

# List active positions for an address
binance-web3-openapi-cli get:/bapi/defi/v3/public/wallet-direct/buw/wallet/address/pnl/active-position-list \
  address=0x0000000000000000000000000000000000000001 chainId=56 offset=0 \
  clienttype=web clientversion=1.2.0
```

## Ranking And Signal Examples

```bash
# Social hype leaderboard
binance-web3-openapi-cli get:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/social/hype/rank/leaderboard \
  chainId=56 targetLanguage=en timeRange=1 sentiment=All socialLanguage=ALL

# Unified token rank
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}'

# Meme rush rank
binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/pulse/rank/list \
  '{"chainId":"CT_501","rankType":10,"limit":20}'

# Smart money signals
binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money \
  '{"smartSignalType":"","page":1,"pageSize":50,"chainId":"56"}'
```

## Token Audit Example

```bash
request_id="$(uuidgen)"

binance-web3-openapi-cli post:/bapi/defi/v1/public/wallet-direct/security/token/audit \
  "{\"binanceChainId\":\"56\",\"contractAddress\":\"0x55d398326f99059ff775485246999027b3197955\",\"requestId\":\"${request_id}\"}"
```

## Fallback Equivalence

- `binance-web3-openapi-cli <operation> ...` is equivalent to
  `uxc https://web3.binance.com --schema-url <binance_web3_openapi_schema> <operation> ...`.


path: scripts/validate.sh
content: #!/usr/bin/env bash
set -euo pipefail

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
SKILL_DIR="${ROOT_DIR}/skills/binance-web3-openapi-skill"
SKILL_FILE="${SKILL_DIR}/SKILL.md"
OPENAI_FILE="${SKILL_DIR}/agents/openai.yaml"
SCHEMA_FILE="${SKILL_DIR}/references/binance-web3.openapi.json"
USAGE_FILE="${SKILL_DIR}/references/usage-patterns.md"

fail() {
  printf '[validate] error: %s\n' "$*" >&2
  exit 1
}

need_cmd() {
  command -v "$1" >/dev/null 2>&1 || fail "required command not found: $1"
}

need_cmd rg
need_cmd jq

required_files=(
  "${SKILL_FILE}"
  "${OPENAI_FILE}"
  "${USAGE_FILE}"
  "${SCHEMA_FILE}"
)

for file in "${required_files[@]}"; do
  [[ -f "${file}" ]] || fail "missing required file: ${file}"
done

rg -q '^name:\s*binance-web3-openapi-skill\s*$' "${SKILL_FILE}" || fail 'invalid skill name'
rg -q '^description:\s*.+' "${SKILL_FILE}" || fail 'missing description'

rg -q 'command -v binance-web3-openapi-cli' "${SKILL_FILE}" || fail 'missing link-first command check'
rg -q 'uxc link binance-web3-openapi-cli https://web3.binance.com --schema-url ' "${SKILL_FILE}" || fail 'missing fixed link create command with schema-url'
rg -q 'binance-web3-openapi-cli -h' "${SKILL_FILE}" || fail 'missing help-first host discovery example'
rg -q 'binance-web3-openapi-cli get:/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search -h' "${SKILL_FILE}" || fail 'missing operation-level help example'
rg -q 'UUID v4 `requestId`' "${SKILL_FILE}" || fail 'missing audit requestId guardrail'

if rg -q -- "--args\\s+'\\{" "${SKILL_FILE}" "${USAGE_FILE}"; then
  fail 'found banned legacy JSON argument pattern'
fi

rg -q '^\s*display_name:\s*"Binance Web3 API"\s*$' "${OPENAI_FILE}" || fail 'missing display_name'
rg -q '^\s*short_description:\s*".+"\s*$' "${OPENAI_FILE}" || fail 'missing short_description'
rg -q '^\s*default_prompt:\s*".*\$binance-web3-openapi-skill.*"\s*$' "${OPENAI_FILE}" || fail 'default_prompt must mention $binance-web3-openapi-skill'

jq -e '.openapi == "3.1.0"' "${SCHEMA_FILE}" >/dev/null || fail 'schema must be OpenAPI 3.1.0 JSON'
jq -e '.paths[[REDACTED_SECRET]].get' "${SCHEMA_FILE}" >/dev/null || fail 'missing token search path'
jq -e '.paths[[REDACTED_SECRET]].post' "${SCHEMA_FILE}" >/dev/null || fail 'missing token audit path'

echo "skills/binance-web3-openapi-skill validation passed"


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)