Query Token Audit Skill

SkillSecurity

Before you trade or swap a crypto token, your AI can check it for signs of scams, honeypots, and malicious contracts. An audit returns a security analysis that covers risks in the token's contract, the risks of trading it, and whether it looks like a scam. It fits questions like 'is this token safe?' or a last check before a swap.

Available today. Use it from your connected AI after setup.

After adding it, ask your AI something like 'is this token safe?' or 'check token security' about a specific token. It is most useful as a last check right before you trade or swap.

Then ask your AI: use the Query Token Audit Skill skill

What your AI can do with it

  • Check whether a token looks like a scam or a honeypot before you trade it
  • Detect malicious contracts before a trade or swap
  • Report contract risks and trading risks for a token
  • Answer questions like 'is this token safe?' with a security audit
  • Run a final security check right before you swap a token

What this skill tells your AI

The instructions your AI receives, as published by ccxt/ccxt in .agents/skills/query-token-audit/SKILL.md and read by ahel’s review.

Overview

APIFunctionUse Case
Token Security AuditToken security scanDetect 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 NamechainId
BSC56
Base8453
SolanaCT_501
Ethereum1

API: Token Security Audit

Method: POST

URL:

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit

Request Parameters:

ParameterTypeRequiredDescription
binanceChainIdstringYesChain ID: CT_501 (Solana), 56 (BSC), 8453 (Base), 1 (Ethereum)
contractAddressstringYesToken contract address
requestIdstringYesUnique request ID (UUID v4 format)

Request Headers:

Content-Type: application/json
Accept-Encoding: identity
User-Agent: binance-web3/1.4 (Skill)

Example Request:

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' \
--header 'User-Agent: binance-web3/1.4 (Skill)' \
--data '{
    "binanceChainId": "56",
    "contractAddress": "0x55d398326f99059ff775485246999027b3197955",
    "requestId": "'$(uuidgen)'"
}'

Response Example:

{
    "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:

FieldTypeDescription
hasResultbooleanWhether audit data is available
isSupportedbooleanWhether the token is supported for audit
riskLevelEnumstringRisk level: LOW, MEDIUM, HIGH
riskLevelnumberRisk level number (1-5)
extraInfo.buyTaxstringBuy tax percentage (null if unknown)
extraInfo.sellTaxstringSell tax percentage (null if unknown)
extraInfo.isVerifiedbooleanWhether contract code is verified
riskItems[].idstringRisk category: CONTRACT_RISK, TRADE_RISK, SCAM_RISK
riskItems[].details[].titlestringRisk check title
riskItems[].details[].descriptionstringRisk check description
riskItems[].details[].isHitbooleantrue = risk detected
riskItems[].details[].riskTypestringRISK (critical) or CAUTION (warning)

Risk Level Reference:

riskLevelriskLevelEnumActionDescription
0-1LOWProceed with cautionLower risk detected, but NOT guaranteed safe. DYOR.
2-3MEDIUMExercise cautionModerate risks detected, review risk items carefully
4HIGHAvoid tradingCritical risks detected, high probability of loss
5HIGHBlock transactionSevere 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.

Response Handling:

  • If hasResult=false OR isSupported=false: → Reply: "Security audit data is not available for this token on this chain." → Do NOT show riskLevel, riskLevelEnum, or riskItems (data is unreliable when either field is false) → You may suggest the user verify the contract address and chain, or try again later
  • If hasResult=true AND isSupported=true: → Show the full audit result including risk level, tax info, and all risk items → Apply the Risk Level Reference table above for actionable guidance

User Agent Header

Include User-Agent header with the following string: binance-web3/1.4 (Skill)

Notes

  1. All numeric fields are string format, convert when using
  2. Audit results are ONLY valid when hasResult: true AND isSupported: true
  3. riskLevel: 5 means transaction should be blocked; riskLevel: 4 is high risk
  4. Tax thresholds: >10% is critical, 5-10% is warning, <5% is acceptable
  5. Generate unique UUID v4 for each audit request
  6. Only output security check risk flags, do NOT provide any investment advice
  7. Always end with disclaimer: ⚠️ This audit result is for reference only and does not constitute investment advice. Always conduct your own research.

Signals

GitHub stars
44k
Forks
9k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
query-token-audit
Source
github.com/ccxt/ccxt