Query Token Audit Skill
Overview
| API |
Function |
Use Case |
| Token Security Audit |
Token security scan |
Detect honeypot, rug pull, scam, malicious functions |
Use Cases
- Pre-Trade Safety Check: Verify token security before buying or swapping
- Scam Detection: Identify honeypots, fake tokens, and malicious contracts
- Contract Analysis: Check for dangerous ownership functions and hidden risks
- 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:
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:
| 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.
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
- All numeric fields are string format, convert when using
- Audit results are ONLY valid when
hasResult: true AND isSupported: true
riskLevel: 5 means transaction should be blocked; riskLevel: 4 is high risk
- Tax thresholds: >10% is critical, 5-10% is warning, <5% is acceptable
- Generate unique UUID v4 for each audit request
- Only output security check risk flags, do NOT provide any investment advice
- Always end with disclaimer:
⚠️ This audit result is for reference only and does not constitute investment advice. Always conduct your own research.
1---
2name: query-token-audit
3description: |
4 Query token security audit to detect scams, honeypots, and malicious contracts before trading.
5 Returns comprehensive security analysis including contract risks, trading risks, and scam detection.
6 Use when users ask "is this token safe?", "check token security", "audit token", or before any swap.
7metadata:
8 author: binance-web3-team
9 version: "1.4"
10---
11
12# Query Token Audit Skill
13
14## Overview
15
16| API | Function | Use Case |
17|-----|---------------------|----------|
18| Token Security Audit | Token security scan | Detect honeypot, rug pull, scam, malicious functions |
19
20## Use Cases
21
221. **Pre-Trade Safety Check**: Verify token security before buying or swapping
232. **Scam Detection**: Identify honeypots, fake tokens, and malicious contracts
243. **Contract Analysis**: Check for dangerous ownership functions and hidden risks
254. **Tax Verification**: Detect unusual buy/sell taxes before trading
26
27## Supported Chains
28
29| Chain Name | chainId |
30|------------|---------|
31| BSC | 56 |
32| Base | 8453 |
33| Solana | CT_501 |
34| Ethereum | 1 |
35
36---
37
38## API: Token Security Audit
39
40### Method: POST
41
42**URL**:
43```
44https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit
45```
46
47**Request Parameters**:
48
49| Parameter | Type | Required | Description |
50|-----------|------|----------|-------------|
51| binanceChainId | string | Yes | Chain ID: `CT_501` (Solana), `56` (BSC), `8453` (Base), `1` (Ethereum) |
52| contractAddress | string | Yes | Token contract address |
53| requestId | string | Yes | Unique request ID (UUID v4 format) |
54
55**Request Headers**:
56```
57Content-Type: application/json
58Accept-Encoding: identity
59User-Agent: binance-web3/1.4 (Skill)
60```
61
62**Example Request**:
63```bash
64curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/security/token/audit' \
65--header 'Content-Type: application/json' \
66--header 'source: agent' \
67--header 'Accept-Encoding: identity' \
68--header 'User-Agent: binance-web3/1.4 (Skill)' \
69--data '{
70 "binanceChainId": "56",
71 "contractAddress": "0x55d398326f99059ff775485246999027b3197955",
72 "requestId": "'$(uuidgen)'"
73}'
74```
75
76**Response Example**:
77```json
78{
79 "code": "000000",
80 "data": {
81 "requestId": "d6727c70-de6c-4fad-b1d7-c05422d5f26b",
82 "hasResult": true,
83 "isSupported": true,
84 "riskLevelEnum": "LOW",
85 "riskLevel": 1,
86 "extraInfo": {
87 "buyTax": "0",
88 "sellTax": "0",
89 "isVerified": true
90 },
91 "riskItems": [
92 {
93 "id": "CONTRACT_RISK",
94 "name": "Contract Risk",
95 "details": [
96 {
97 "title": "Honeypot Risk Not Found",
98 "description": "A honeypot is a token that can be bought but not sold",
99 "isHit": false,
100 "riskType": "RISK"
101 }
102 ]
103 }
104 ]
105 },
106 "success": true
107}
108```
109
110**Response Fields**:
111
112| Field | Type | Description |
113|-----------------------------------|------|-----------------------------------------------------------|
114| hasResult | boolean | Whether audit data is available |
115| isSupported | boolean | Whether the token is supported for audit |
116| riskLevelEnum | string | Risk level: `LOW`, `MEDIUM`, `HIGH` |
117| riskLevel | number | Risk level number (1-5) |
118| extraInfo.buyTax | string | Buy tax percentage (null if unknown) |
119| extraInfo.sellTax | string | Sell tax percentage (null if unknown) |
120| extraInfo.isVerified | boolean | Whether contract code is verified |
121| riskItems[].id | string | Risk category: `CONTRACT_RISK`, `TRADE_RISK`, `SCAM_RISK` |
122| riskItems[].details[].title | string | Risk check title |
123| riskItems[].details[].description | string | Risk check description |
124| riskItems[].details[].isHit | boolean | true = risk detected |
125| riskItems[].details[].riskType | string | `RISK` (critical) or `CAUTION` (warning) |
126
127**Risk Level Reference**:
128
129| riskLevel | riskLevelEnum | Action | Description |
130|-----------|---------------|--------|-------------|
131| 0-1 | LOW | Proceed with caution | Lower risk detected, but NOT guaranteed safe. DYOR. |
132| 2-3 | MEDIUM | Exercise caution | Moderate risks detected, review risk items carefully |
133| 4 | HIGH | Avoid trading | Critical risks detected, high probability of loss |
134| 5 | HIGH | Block transaction | Severe risks confirmed, do NOT proceed |
135
136**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.
137
138**Response Handling**:
139
140- If `hasResult=false` OR `isSupported=false`:
141 → Reply: "Security audit data is not available for this token on this chain."
142 → Do NOT show `riskLevel`, `riskLevelEnum`, or `riskItems` (data is unreliable when either field is false)
143 → You may suggest the user verify the contract address and chain, or try again later
144- If `hasResult=true` AND `isSupported=true`:
145 → Show the full audit result including risk level, tax info, and all risk items
146 → Apply the Risk Level Reference table above for actionable guidance
147
148---
149
150## User Agent Header
151
152Include `User-Agent` header with the following string: `binance-web3/1.4 (Skill)`
153
154## Notes
155
1561. All numeric fields are string format, convert when using
1572. Audit results are ONLY valid when `hasResult: true` AND `isSupported: true`
1583. `riskLevel: 5` means transaction should be blocked; `riskLevel: 4` is high risk
1594. Tax thresholds: >10% is critical, 5-10% is warning, <5% is acceptable
1605. Generate unique UUID v4 for each audit request
1616. Only output security check risk flags, do NOT provide any investment advice
1627. Always end with disclaimer: `⚠️ This audit result is for reference only and does not constitute investment advice. Always conduct your own research.`