TokenForge

API リファレンス

REST APIでTokenForgeをシステムに統合

APIアクセスにはPro以上のプランが必要です。

認証

すべてのAPIリクエストにはAPIキーが必要です。 ダッシュボードの「設定」→「APIキー」から取得できます。

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.token-forge.me/v1/scan

ベースURL

https://api.token-forge.me/v1

エンドポイント

POST /scan

Solanaアドレス（トークンまたはウォレット）をスキャン

リクエスト

{
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}

レスポンス

{
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "address_type": "token",
  "risk_level": "HIGH",
  "risk_score": 45,
  "detections": [
    {
      "detector_id": "C1",
      "detector_name": "MINT_AUTHORITY_ACTIVE",
      "severity": "CRITICAL",
      "description": "Mint authority has not been revoked. Token supply can be increased.",
      "details": {
        "authority": "5ZiE3v..."
      }
    },
    {
      "detector_id": "H2",
      "detector_name": "TOP_HOLDER_OVER_50PCT",
      "severity": "HIGH",
      "description": "Top 10 holders control more than 50% of supply.",
      "details": {
        "top10_percentage": 62.4
      }
    }
  ],
  "token_name": "Example Token",
  "token_symbol": "EXT",
  "scanned_at": "2026-02-10T12:00:00Z"
}
POST /scan/batch

複数アドレスを一括スキャン（Starter: 10件/回、Pro: 100件/回）

リクエスト

{
  "addresses": [
    "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  ]
}
GET /scan/:id

過去のスキャン結果を取得

GET /scans

スキャン履歴一覧を取得

クエリパラメータ

パラメータ型説明
limitnumber取得件数（デフォルト: 20, 最大: 100）
offsetnumberオフセット
address_typestringアドレス種別でフィルタ（"token" | "wallet"）
risk_levelstringリスクレベルでフィルタ

レート制限

プランリクエスト/分リクエスト/日
Starter10500
Pro605,000
レート制限超過時は429エラーが返されます。Retry-Afterヘッダーを確認してください。

エラーコード

コード説明
400不正なリクエスト（パラメータエラー）
401認証エラー（APIキーが無効または未設定）
403アクセス拒否（プランの機能制限）
404リソースが見つからない
429レート制限超過
500サーバーエラー

SDK（予定）

Python、JavaScript、Go用のSDKを準備中です。

Python JavaScript Go
検知機能 対応ネットワーク

© 2026 TokenForge. All rights reserved.