クイックスタート

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

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 エージェント構築

データプロダクト

接続方法

AI Agents

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

チュートリアル

レシピ

プラットフォーム

エコシステム

リファレンス

​前提条件

​1. API キーの取得

​2. 最初のリクエスト

​レスポンス

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

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

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

​次のステップ

データカタログを見る

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

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

AI エージェント構築

前提条件

1. API キーの取得

2. 最初のリクエスト

レスポンス

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

トラブルシューティング

次のステップ