query-token-audit

クエリトークン監査スキル

概要

API	機能	ユースケース
トークンセキュリティ監査	トークンのセキュリティスキャン	ハニーポット、ラグプル、詐欺、悪意のある関数を検出

ユースケース

1. 取引前の安全性確認：購入またはスワップの前にトークンのセキュリティを確認します
2. 詐欺の検出：ハニーポット、偽トークン、悪意のあるコントラクトを特定します
3. コントラクトの分析：危険な所有権関数や隠れたリスクを確認します
4. 税率の確認：取引前に通常と異なる購入税・売却税を検出します

対応チェーン

チェーン名	chainId
BSC	56
Base	8453
Solana	CT_501
Ethereum	1

---

API：トークンセキュリティ監査

メソッド：POST

URL：

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

リクエストパラメーター：

パラメーター	型	必須	説明
binanceChainId	string	はい	チェーン ID：CT_501（Solana）、56（BSC）、8453（Base）、1（Ethereum）
contractAddress	string	はい	トークンのコントラクトアドレス
requestId	string	はい	一意のリクエスト ID（UUID v4 形式）

リクエストヘッダー：

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

リクエスト例：

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)'"
}'

レスポンス例：

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

レスポンスフィールド：

フィールド	型	説明
hasResult	boolean	監査データが利用可能かどうか
isSupported	boolean	トークンが監査に対応しているかどうか
riskLevelEnum	string	リスクレベル：LOW、MEDIUM、HIGH
riskLevel	number	リスクレベルの数値（1～5）
extraInfo.buyTax	string	購入税率（不明な場合は null）
extraInfo.sellTax	string	売却税率（不明な場合は null）
extraInfo.isVerified	boolean	コントラクトコードが検証済みかどうか
riskItems[].id	string	リスクカテゴリ：CONTRACT_RISK、TRADE_RISK、SCAM_RISK
riskItems[].details[].title	string	リスクチェックのタイトル
riskItems[].details[].description	string	リスクチェックの説明
riskItems[].details[].isHit	boolean	true = リスクを検出
riskItems[].details[].riskType	string	RISK（重大）または CAUTION（警告）

リスクレベルの目安：

riskLevel	riskLevelEnum	対応	説明
0-1	LOW	注意して進めてください	検出されたリスクは低いものの、安全が保証されるわけではありません。ご自身で調査してください。
2-3	MEDIUM	注意してください	中程度のリスクが検出されました。リスク項目を慎重に確認してください
4	HIGH	取引を避けてください	重大なリスクが検出されました。損失が発生する可能性が高いです
5	HIGH	取引をブロックしてください	深刻なリスクが確認されました。絶対に進めないでください

重要：リスクが LOW でも「安全」という意味ではありません。監査結果は特定時点のスナップショットです。プロジェクトチームは、購入後にコントラクトを変更したり、流動性を制限したりできます。こうしたリスクを事前に予測することはできません。

レスポンスの処理：

• hasResult=false または isSupported=false の場合： → 次のように返信します：「このチェーンでは、このトークンのセキュリティ監査データを利用できません。」 → riskLevel、riskLevelEnum、riskItems は表示しないでください（いずれかのフィールドが false の場合、データの信頼性がありません） → コントラクトアドレスとチェーンを確認するか、後でもう一度試すようユーザーに提案してもかまいません
• hasResult=true かつ isSupported=true の場合： → リスクレベル、税率情報、すべてのリスク項目を含む監査結果全体を表示します → 上記の「リスクレベルの目安」表に従って、実行可能な指針を示します

---

User Agent ヘッダー

次の文字列を含む User-Agent ヘッダーを設定します：binance-web3/1.4 (Skill)

注意事項

1. すべての数値フィールドは文字列形式です。使用する際に変換してください
2. 監査結果が有効なのは、hasResult: true かつ isSupported: true の場合のみです
3. riskLevel: 5 は取引をブロックする必要があることを意味します。riskLevel: 4 は高リスクです
4. 税率のしきい値：10% 超は重大、5～10% は警告、5% 未満は許容範囲です
5. 監査リクエストごとに一意の UUID v4 を生成してください
6. セキュリティチェックのリスクフラグのみを出力し、投資に関する助言は行わないでください
7. 必ず次の免責事項で終えてください：⚠️ This audit result is for reference only and does not constitute investment advice. Always conduct your own research.