Query token audit Skill from Binance

skills/query-token-audit/SKILL.md

@@ -0,0 +1,155 @@
+---
+id: query-token-audit
+name: Query Token Audit
+description: Query token security audit details to detect scams, honeypots, malicious contract risks, and dangerous trading conditions before swapping.
+category: Blockchain
+author: binance-web3-team
+version: 1.4.0
+requires: []
+examples:
+  - Check if this BSC token is safe before I buy it.
+  - Audit this Base token contract for honeypot and scam risk.
+  - Run a token security check on this Solana contract and summarize the risk items.
+---
+
+# Query Token Audit Skill
+
+## Overview
+
+| API | Function | Use Case |
+|-----|----------|----------|
+| Token Security Audit | Token security scan | Detect honeypot, rug pull, scam, malicious functions |
+
+## Use Cases
+
+1. **Pre-Trade Safety Check**: Verify token security before buying or swapping
+2. **Scam Detection**: Identify honeypots, fake tokens, and malicious contracts
+3. **Contract Analysis**: Check for dangerous ownership functions and hidden risks
+4. **Tax Verification**: Detect unusual buy/sell taxes before trading
+
+## Supported Chains
+
+| Chain Name | chainId |
+|------------|---------|
+| BSC | 56 |
+| Base | 8453 |
+| Solana | CT_501 |
+| Ethereum | 1 |
+
+---
+
+## API: Token Security Audit
+
+### Method: POST
+
+**URL**:
+`https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit`
+
+**Request Parameters**:
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| binanceChainId | string | Yes | Chain ID: `CT_501` (Solana), `56` (BSC), `8453` (Base), `1` (Ethereum) |
+| contractAddress | string | Yes | Token contract address |
+| requestId | string | Yes | Unique request ID (UUID v4 format) |
+
+**Request Headers**:
+```text
+Content-Type: application/json
+Accept-Encoding: identity
+```
+
+**Example Request**:
+```bash
+curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit' \
+--header 'Content-Type: application/json' \
+--header 'source: agent' \
+--header 'Accept-Encoding: identity' \
+--data '{
+  "binanceChainId": "56",
+  "contractAddress": "0x55d398326f99059ff775485246999027b3197955",
+  "requestId": "'$(uuidgen)'"
+}'
+```
+
+**Response Example**:
+```json
+{
+  "code": "000000",
+  "data": {
+    "requestId": "d6727c70-de6c-4fad-b1d7-c05422d5f26b",
+    "hasResult": true,
+    "isSupported": true,
+    "riskLevelEnum": "LOW",
+    "riskLevel": 1,
+    "extraInfo": {
+      "buyTax": "0",
+      "sellTax": "0",
+      "isVerified": true
+    },
+    "riskItems": [
+      {
+        "id": "CONTRACT_RISK",
+        "name": "Contract Risk",
+        "details": [
+          {
+            "title": "Honeypot Risk Not Found",
+            "description": "A honeypot is a token that can be bought but not sold",
+            "isHit": false,
+            "riskType": "RISK"
+          }
+        ]
+      }
+    ]
+  },
+  "success": true
+}
+```
+
+**Response Fields**:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| hasResult | boolean | Whether audit data is available |
+| isSupported | boolean | Whether the token is supported for audit |
+| riskLevelEnum | string | Risk level: `LOW`, `MEDIUM`, `HIGH` |
+| riskLevel | number | Risk level number (1-5) |
+| extraInfo.buyTax | string | Buy tax percentage (null if unknown) |
+| extraInfo.sellTax | string | Sell tax percentage (null if unknown) |
+| extraInfo.isVerified | boolean | Whether contract code is verified |
+| riskItems[].id | string | Risk category: `CONTRACT_RISK`, `TRADE_RISK`, `SCAM_RISK` |
+| riskItems[].details[].title | string | Risk check title |
+| riskItems[].details[].description | string | Risk check description |
+| riskItems[].details[].isHit | boolean | true = risk detected |
+| riskItems[].details[].riskType | string | `RISK` (critical) or `CAUTION` (warning) |
+
+**Risk Level Reference**:
+
+| riskLevel | riskLevelEnum | Action | Description |
+|-----------|---------------|--------|-------------|
+| 0-1 | LOW | Proceed with caution | Lower risk detected, but not guaranteed safe. DYOR. |
+| 2-3 | MEDIUM | Exercise caution | Moderate risks detected, review risk items carefully |
+| 4 | HIGH | Avoid trading | Critical risks detected, high probability of loss |
+| 5 | HIGH | Block transaction | Severe risks confirmed, do not proceed |
+
+**IMPORTANT**: LOW risk does not mean "safe." Audit results are point-in-time snapshots. Project teams can modify contracts or restrict liquidity after purchase. These risks cannot be predicted in advance.
+
+**Result Validity**:
+
+Audit results are valid only when both conditions are met:
+- `hasResult: true` - Audit data is available
+- `isSupported: true` - Token is supported for audit
+
+When invalid, do not display risk level or security checks.
+
+---
+
+## Notes
+
+1. All numeric fields may be returned in string format; convert when needed
+2. Audit results are valid only when `hasResult: true` and `isSupported: true`
+3. `riskLevel: 5` means transaction should be blocked; `riskLevel: 4` is high risk
+4. Tax thresholds: above 10% is critical, 5-10% is warning, below 5% is acceptable
+5. Generate a unique UUID v4 for each audit request
+6. Output only security check risk flags; do not provide investment advice
+7. Always end with this disclaimer: `This audit result is for reference only and does not constitute investment advice. Always conduct your own research.`