> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> ChainStream よくある質問

## アカウントと認証

<AccordionGroup>
  <Accordion title="Access Token はどのように取得しますか？">
    1. [ChainStream Dashboard](https://www.chainstream.io/dashboard) にログイン
    2. **Apps** ページに移動
    3. **Create New App** をクリック
    4. Client ID と Client Secret を取得
    5. Client ID と Client Secret を使用して Auth サービスから Access Token（JWT）をリクエスト

    詳細は [認証ドキュメント](/jp/docs/platform/authentication/api-keys-oauth) をご参照ください。
  </Accordion>
</AccordionGroup>

***

## データ関連

<AccordionGroup>
  <Accordion title="対応しているブロックチェーンは？">
    現在対応しているチェーン：

    | チェーン     | 状態     | 備考                 |
    | :------- | :----- | :----------------- |
    | Ethereum | ✅ 対応済み | メインネットおよび主要 L2 を含む |
    | Solana   | ✅ 対応済み |                    |
    | BSC      | ✅ 対応済み |                    |
    | Polygon  | ✅ 対応済み |                    |
    | Arbitrum | ✅ 対応済み |                    |
    | Optimism | ✅ 対応済み |                    |
    | Base     | ✅ 対応済み |                    |
    | Tron     | ✅ 対応済み |                    |

    詳細は [リアルタイムストリーミング](/jp/docs/access-methods/websocket) をご参照ください。
  </Accordion>

  <Accordion title="データの遅延はどのくらいですか？">
    | データ種別               | 遅延           |
    | :------------------ | :----------- |
    | リアルタイム価格（WebSocket） | \< 2ms (P99) |
    | REST API クエリ        | \< 100ms     |
    | 過去データクエリ            | \< 500ms     |

    遅延はネットワーク状況やデータの複雑さにより変動する場合があります。
  </Accordion>

  <Accordion title="データの更新頻度はどのくらいですか？">
    | データ種別           | 更新頻度             |
    | :-------------- | :--------------- |
    | トークン価格          | リアルタイム（各取引でトリガー） |
    | ウォレット残高         | ブロックごとに更新        |
    | Smart Money ラベル | 日次更新             |

    WebSocket を使用すると最もリアルタイムなデータプッシュが受けられます。
  </Accordion>
</AccordionGroup>

***

## 料金関連

<AccordionGroup>
  <Accordion title="無料プランの制限は？">
    無料プランの制限：

    * **クォータ：** 月間 30K Units
    * **リクエストレート：** 10 リクエスト/秒
    * **データ遅延：** 1〜2 秒の遅延が発生する場合があります
    * **SLA：** 保証なし
    * **超過：** クォータ消費後は 403 エラーを返し、翌月リセット

    開発テストや POC に適しています。本番環境での使用は推奨しません。
  </Accordion>

  <Accordion title="現在の使用量はどのように確認できますか？">
    1. [Dashboard](https://www.chainstream.io/dashboard) にログイン
    2. **Usage** ページで当月の使用量、残りクォータ、過去の推移を確認
  </Accordion>

  <Accordion title="対応している支払い方法は？">
    | 方法                               | 対応プラン               |
    | :------------------------------- | :------------------ |
    | クレジットカード（Visa, MasterCard, AMEX） | 全プラン                |
    | 暗号通貨（USDT, USDC）                 | Starter 以上          |
    | 銀行振込                             | Enterprise / Custom |

    暗号通貨は ERC-20 および TRC-20 ネットワークに対応しています。
  </Accordion>

  <Accordion title="いつでもアップグレードやダウングレードできますか？">
    * **アップグレード：** 即時適用、日割り計算
    * **ダウングレード：** 次の請求サイクルから適用

    Dashboard → Billing → Subscription で操作できます。
  </Accordion>

  <Accordion title="未使用のクォータは繰り越せますか？">
    いいえ。月間クォータは月末にリセットされ、翌月に繰り越されません。実際の使用量に合わせて適切なプランをお選びください。
  </Accordion>
</AccordionGroup>

***

## 技術的な問題

<AccordionGroup>
  <Accordion title="429 または 403 エラーが発生した場合は？">
    * **429 エラー**：リクエストレート超過
    * **403 エラー**：クォータ消費

    **トラブルシューティング：**

    1. **429 - レート制限の確認**
       * 無料プラン：10 リクエスト/分
       * 有料プラン：[API セキュリティ](/jp/docs/platform/security/api-security) を参照

    2. **403 - クォータ消費の確認**
       * Dashboard → Usage で残りクォータを確認
       * 有料プランでは追加クォータを購入してサービスを復旧可能

    **解決策：**

    * 429：リクエストスロットリングまたは指数バックオフリトライを実装
    * 403：追加クォータの購入またはプランのアップグレード
    * WebSocket を使用してポーリングを削減

    ```javascript theme={null}
    // Error handling example
    async function handleApiError(error) {
      if (error.status === 429) {
        // Rate limited, wait and retry
        await sleep(1000);
        return retry();
      } else if (error.status === 403) {
        // Quota exhausted, need to purchase additional quota
        console.error('Quota exhausted, please purchase additional quota in Dashboard');
      }
    }
    ```
  </Accordion>

  <Accordion title="WebSocket の切断にはどう対処しますか？">
    自動再接続メカニズムの実装を推奨します：

    ```javascript theme={null}
    class ChainStreamWebSocket {
      constructor(baseUrl, accessToken) {
        this.baseUrl = baseUrl;
        this.accessToken = accessToken;
        this.reconnectDelay = 1000;
        this.maxReconnectDelay = 30000;
        this.connect();
      }

      connect() {
        // Pass token via URL parameter
        const url = `${this.baseUrl}?token=${this.accessToken}`;
        this.ws = new WebSocket(url);
        this.ws.onopen = () => {
          console.log('Connected');
          this.reconnectDelay = 1000; // Reset delay
        };
        this.ws.onclose = () => {
          console.log('Disconnected, reconnecting...');
          setTimeout(() => this.connect(), this.reconnectDelay);
          // Exponential backoff
          this.reconnectDelay = Math.min(
            this.reconnectDelay * 2,
            this.maxReconnectDelay
          );
        };
        this.ws.onerror = (error) => {
          console.error('WebSocket error:', error);
        };
      }
    }
    ```

    **再接続のヒント：**

    * 指数バックオフを使用（1s → 2s → 4s → ... → 30s）
    * 最大再接続遅延を設定（例：30 秒）
    * 再接続成功後にデータを再購読
  </Accordion>

  <Accordion title="API のレスポンス形式は？">
    すべての API は JSON 形式を返します。

    **成功レスポンス：**

    ```json theme={null}
    {
      "chain": "solana",
      "address": "So11111111111111111111111111111111111111112",
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "decimals": 9,
      "price": 95.42
    }
    ```

    **エラーレスポンス：**

    ```json theme={null}
    {
      "error": {
        "code": "INVALID_TOKEN",
        "message": "Token not found"
      }
    }
    ```

    一般的なエラーコードは [エラーコード一覧](/jp/docs/reference/error-codes) をご参照ください。
  </Accordion>

  <Accordion title="API リクエストのデバッグ方法は？">
    **方法 1：API Playground を使用**

    [API Reference](/jp/api-reference/overview) ページの "Try It" 機能を使用して、コードを書かずにテストできます。

    **方法 2：cURL を使用**

    `-v` フラグで詳細なリクエスト情報を表示：

    ```bash theme={null}
    curl -v "https://api.chainstream.io/v1/token/{chain}/{address}/metadata" \
      -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
    ```
  </Accordion>
</AccordionGroup>

***

## KYT/KYA 関連

<AccordionGroup>
  <Accordion title="KYT と KYA の違いは？">
    | 機能      | KYA（アドレス検証）                    | KYT レポート                |
    | :------ | :----------------------------- | :---------------------- |
    | 目的      | アドレスのリスクおよびプロファイル分析            | トランザクションレベルのリスクレポート     |
    | 入力      | ウォレットアドレス                      | トランザクションハッシュまたはアドレス     |
    | 出力      | リスクレベル + アドレスタイプ + リスクエクスポージャー | トランザクション関連のリスク分析        |
    | 典型的な使用例 | ユーザー登録/入金前のアドレス審査              | 特定トランザクションのコンプライアンスチェック |

    詳細は [セキュリティコンプライアンスドキュメント](/jp/docs/compliance/overview) をご参照ください。
  </Accordion>

  <Accordion title="Address Verification はどのような情報を返しますか？">
    アドレス検証は以下のフィールドを返します：

    | フィールド          | 説明             | 値の例                                    |
    | :------------- | :------------- | :------------------------------------- |
    | Risk           | リスクレベル         | Low, Medium, High, Severe              |
    | Status         | 検証ステータス        | COMPLETE, PENDING                      |
    | Address Type   | アドレスタイプ        | PRIVATE\_WALLET, EXCHANGE, CONTRACT など |
    | Risk Exposures | リスクエクスポージャーの詳細 | リスクラベルと関連金額                            |
  </Accordion>

  <Accordion title="リスクレベルの解釈方法は？">
    Address Verification は以下のリスクレベルを返します：

    | リスクレベル | 意味                     | 推奨アクション       |
    | :----- | :--------------------- | :------------ |
    | Low    | 低リスク、明らかな不審な関連なし       | 通常処理          |
    | Medium | 中リスク、一部不審な関連あり         | 手動レビュー推奨      |
    | High   | 高リスク、重大な不審な関連あり        | 拒否または強化レビュー推奨 |
    | Severe | 深刻なリスク、制裁/違法団体との直接的な関連 | 拒否を強く推奨       |

    **注意：** 具体的な対処ポリシーはお客様のビジネスコンプライアンス要件に基づいて設定してください。上記は参考提案にすぎません。
  </Accordion>

  <Accordion title="Risk Exposures にはどのようなリスクラベルがありますか？">
    Risk Exposures はアドレスと各種リスク団体との関連を表示します。一般的なラベルは以下の通りです：

    **高リスクラベル（Severe）：**

    | ラベル                     | 説明         |
    | :---------------------- | :--------- |
    | sanctioned entity       | 制裁対象団体との関連 |
    | sanctioned jurisdiction | 制裁対象法域との関連 |
    | terrorist financing     | テロ資金供与との関連 |

    **中立/低リスクラベル：**

    | ラベル                    | 説明                  |
    | :--------------------- | :------------------ |
    | bridge                 | クロスチェーンブリッジ経由での資金移動 |
    | decentralized exchange | DEX 経由の取引           |
    | atm                    | 暗号通貨 ATM 経由の取引      |

    **その他のリスクラベル：**

    | ラベル      | 説明                |
    | :------- | :---------------- |
    | mixer    | ミキシングサービス経由       |
    | gambling | ギャンブルプラットフォームとの関連 |
    | darknet  | ダークネットマーケットとの関連   |

    各ラベルには以下が表示されます：

    * **direct / indirect**：直接的または間接的な関連
    * **amount**：関連資金額
    * **percentage**：総取引量に対する割合
  </Accordion>

  <Accordion title="direct と indirect の違いは？">
    | タイプ      | 意味                    | リスクレベル |
    | :------- | :-------------------- | :----- |
    | direct   | アドレスがリスク団体と直接やり取り     | より高い   |
    | indirect | アドレスが中間アドレスを通じて間接的に関連 | 比較的低い  |

    **例：**

    * `sanctioned entity + direct`：アドレスが制裁対象アドレスに直接送金
    * `sanctioned entity + indirect`：このアドレスの関連アドレスが過去に制裁対象アドレスとやり取り

    Severe レベルのラベル（制裁、テロ資金供与）を含む場合、間接的な関連であっても慎重な対応が求められます。
  </Accordion>

  <Accordion title="Address Type にはどのような種類がありますか？">
    | アドレスタイプ            | 説明             |
    | :----------------- | :------------- |
    | PRIVATE\_WALLET    | 個人ウォレットアドレス    |
    | EXCHANGE           | 中央集権取引所アドレス    |
    | CONTRACT           | スマートコントラクトアドレス |
    | MINING\_POOL       | マイニングプールアドレス   |
    | MERCHANT           | マーチャントアドレス     |
    | PAYMENT\_PROCESSOR | 決済プロセッサー       |

    アドレスタイプは資金フローとビジネスコンテキストの理解に役立ちます。
  </Accordion>

  <Accordion title="API で Address Verification を呼び出す方法は？">
    ```bash theme={null}
    curl -X POST "https://api.chainstream.io/v1/kya/address/verify" \
      -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "address": "So11111111111111111111111111111111111111112",
        "chain": "sol"
      }'
    ```

    **レスポンス例：**

    ```json theme={null}
    {
      "address": "So11111111111111111111111111111111111111112",
      "risk": "Low",
      "status": "COMPLETE",
      "address_type": "PRIVATE_WALLET",
      "risk_exposures": [
        {
          "label": "sanctioned entity",
          "severity": "Severe",
          "type": "indirect",
          "amount": 372262.76,
          "percentage": 0.6
        },
        {
          "label": "bridge",
          "severity": "Info",
          "type": "indirect",
          "amount": 816082.22,
          "percentage": 1.3
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="KYT の検出にはどのくらいの時間がかかりますか？">
    | 操作                   | 応答時間             |
    | :------------------- | :--------------- |
    | 新しいアドレスの初回検証         | 通常 1〜5 秒         |
    | キャッシュ済みアドレスのクエリ      | \< 500ms         |
    | 複雑なアドレス（多数のトランザクション） | 5〜10 秒かかる場合があります |

    ステータスが `PENDING` の場合は分析中です。後で再試行して完全な結果を取得してください。
  </Accordion>

  <Accordion title="KYT/KYA の課金方法は？">
    KYT/KYA API は**プランの Units を消費しません**。独立した KYT アカウント残高（USD 建て）から課金されます。

    | 操作      | コスト      |
    | :------ | :------- |
    | 入金リスク評価 | \$0.25/回 |
    | 出金リスク評価 | \$0.25/回 |
    | アドレス登録  | \$1.25/回 |

    Dashboard → KYT Service でチャージしてください。
  </Accordion>
</AccordionGroup>

***

## AI/MCP 関連

<AccordionGroup>
  <Accordion title="MCP とは何ですか？">
    MCP（Model Context Protocol）は Anthropic が提案したプロトコルで、AI モデルが外部ツールを呼び出せるようにするものです。

    ChainStream は MCP Server を提供しており、Claude などの AI がオンチェーンデータを直接クエリできます。

    詳細は [MCP Server ドキュメント](/jp/docs/ai-agents/mcp-server/introduction) をご参照ください。
  </Accordion>

  <Accordion title="Claude Desktop で ChainStream を使用するには？">
    1. ChainStream MCP Server をインストール
    2. Claude Desktop の MCP 設定を構成
    3. Claude Desktop を再起動
    4. チャットを開始 — Claude が自動的に ChainStream を呼び出してデータをクエリ

    詳細なセットアップは [Claude Integration ガイド](/jp/docs/ai-agents/mcp-server/setup) をご参照ください。
  </Accordion>

  <Accordion title="AI はトランザクションを実行できますか？">
    **現在はサポートされていません。** ChainStream MCP Server は読み取り操作のみ提供しています：

    * トークン価格と情報のクエリ
    * ウォレット残高と取引履歴のクエリ
    * KYT/KYA リスク評価の実行

    セキュリティ上の理由から、自動トランザクション実行、送金、その他の書き込み操作はサポートしていません。
  </Accordion>

  <Accordion title="MCP の呼び出しはどのように課金されますか？">
    MCP の呼び出しは直接 API 呼び出しと同様に課金され、実際に呼び出された API タイプに基づいて Units を消費します。
  </Accordion>
</AccordionGroup>

***

## お問い合わせ

<AccordionGroup>
  <Accordion title="テクニカルサポートの受け方は？">
    | チャネル                                                        | 用途                       | 応答時間       |
    | :---------------------------------------------------------- | :----------------------- | :--------- |
    | メール [support@chainstream.io](mailto:support@chainstream.io) | 一般的な質問                   | 24 時間以内    |
    | Discord コミュニティ                                              | 技術的な議論、使用方法の質問           | コミュニティサポート |
    | 専任アカウントマネージャー                                               | Enterprise / Custom のお客様 | 4 時間以内     |

    **お問い合わせの際には以下をご提供ください：**

    * Client ID
    * エラーメッセージと再現手順
  </Accordion>

  <Accordion title="ドキュメントの誤りを報告するには？">
    * **GitHub Issues：** ドキュメントの問題を報告
    * **メール：** [docs@chainstream.io](mailto:docs@chainstream.io)

    ドキュメントの改善にご協力いただきありがとうございます！
  </Accordion>
</AccordionGroup>

***

## 回答が見つかりませんか？

<Card title="お問い合わせ" icon="headset" href="mailto:support@chainstream.io">
  上記の FAQ で解決しない場合は、テクニカルサポートチームまでお問い合わせください。
</Card>