クイックスタート

このガイドを終えた時点で、あなたは以下を手にしています：

API キー（または OAuth トークン）
ChainStream REST API への動作確認済みの呼び出し
SDK・CLI・MCP Server への動作確認済みの呼び出し
次のステップ — REST / GraphQL / WebSocket / Kafka / SDK / CLI / MCP のうち、どれがあなたのワークロードに合うか

所要時間：5 分。

前提条件

ChainStream アカウント。未登録の場合はこちらからサインアップしてください。

1. API キーの取得

ChainStream Dashboard を開く。
Applications へ移動。
Create New App をクリック。
生成された API Key（cs_live_… で始まる）をコピー。

API キーは最速の認証方法です。Machine-to-Machine (M2M) のシナリオでは OAuth 2.0 client-credentials を使用してください。詳細は API キー & OAuth。

2. 最初のリクエスト

この例では Solana 上の Wrapped SOL のメタデータを取得します。使うインターフェースを選んでください：

cURL
SDK (TypeScript)
CLI
MCP (AI エージェント)
OAuth 2.0 (JWT)

curl "https://api.chainstream.io/v2/token/solana/So11111111111111111111111111111111111111112/metadata" \
  -H "X-API-KEY: your_api_key"

import { ChainStreamClient } from "@chainstream-io/sdk";

const cs = new ChainStreamClient({ apiKey: "your_api_key" });

const token = await cs.token.getToken(
  "So11111111111111111111111111111111111111112",
  "solana",
);

console.log(token.name, token.symbol, token.decimals);

Python、Go、Rust は SDK 一覧を参照。

# インストール不要。npx が最新 CLI を取得します。
npx @chainstream-io/cli token info \
  --chain solana \
  --address So11111111111111111111111111111111111111112

初回実行時にキーの入力を求められます。明示的に設定することも可能です：

npx @chainstream-io/cli config set --key apiKey --value your_api_key

CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp

あとは AI エージェントに “What is the SOL token on Solana?” と尋ねるだけ — 正しいツールが呼び出されます。Claude / Cursor / ChatGPT の具体的な設定は MCP Server セットアップを参照。

OAuth 2.0 Client Credentials フロー：

curl -X POST "https://dex.asia.auth.chainstream.io/oauth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "audience": "https://api.dex.chainstream.io",
    "grant_type": "client_credentials"
  }'

curl "https://api.chainstream.io/v2/token/solana/So11111111111111111111111111111111111111112/metadata" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

レスポンス

{
  "chain": "solana",
  "address": "So11111111111111111111111111111111111111112",
  "name": "Wrapped SOL",
  "symbol": "SOL",
  "decimals": 9,
  "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
  "tokenCreatedAt": 1710417600000
}

フィールド	型	説明
`chain`	string	チェーン識別子（小文字）。
`address`	string	トークンのコントラクトアドレス。
`name`	string	トークンの名前。
`symbol`	string	ティッカーシンボル。
`decimals`	integer	小数点以下桁数。
`imageUrl`	string	ロゴ URL（null の可能性あり）。
`tokenCreatedAt`	integer	作成タイムスタンプ（ms）。

3. 最適な接続方法を選ぶ

たった今、単一のリクエスト/レスポンス呼び出しを行いました。実際の統合ではもっと多くのことが必要です：

REST API

オンデマンドのルックアップ — トークン、ウォレット、プール、トレード、コンプライアンス。

GraphQL

チェーンデータ cube 全体に対する柔軟な分析クエリ。

WebSocket

ライブ UI やブラウザアプリ向けのサブ秒プッシュ。

Kafka Streams

バックエンド、インデクサ、トレーディングエンジンへの exactly-once 配信。

SDK

TypeScript / Python / Go / Rust、認証内蔵の型付きクライアント。

CLI

スクリプト、CI/CD、AI エージェント用のペイパーコール。

トラブルシューティング

401 Unauthorized

X-API-KEY または Authorization: Bearer … ヘッダーが正しく綴られていることを確認。
キーがローテーションされた場合は再生成。
OAuth モードではトークンが期限切れでないか確認（デフォルト TTL は 1 時間）。

429 Too Many Requests

プランのレート制限に達しました。無料プランは 10 req/s から。プランをアップグレードするか指数バックオフを実装してください。詳細はプランとユニット。

他のチェーンのトークンをクエリするには？

URL のチェーン識別子を置き換えるだけです：solana、ethereum、bsc、base、 polygon、arbitrum、optimism、avalanche、zksync、tron。全リストはサポートチェーン。

次のステップ

データカタログを見る

公開している全データセットとカバレッジ・更新頻度。

リアルタイムストリームを開始

ライブのトレード、価格、転送、プールイベントを購読。

コンプライアンスチェック

転送、出金、カウンターパーティに対する KYT / KYA。

AI エージェント構築

MCP + Agent Skills で Claude、Cursor、ChatGPT に接続。

データプロダクト

接続方法

AI Agents

コンプライアンス (KYT/KYA)

チュートリアル

レシピ

プラットフォーム

エコシステム

リファレンス

クイックスタート

前提条件

1. API キーの取得

2. 最初のリクエスト

レスポンス

3. 最適な接続方法を選ぶ

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

トラブルシューティング

次のステップ

データカタログを見る

リアルタイムストリームを開始

コンプライアンスチェック

AI エージェント構築

​前提条件

​1. API キーの取得

​2. 最初のリクエスト

​レスポンス

​3. 最適な接続方法を選ぶ

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

​トラブルシューティング

​次のステップ

データカタログを見る

リアルタイムストリームを開始

コンプライアンスチェック

AI エージェント構築

前提条件

1. API キーの取得

2. 最初のリクエスト

レスポンス

3. 最適な接続方法を選ぶ

トラブルシューティング

次のステップ