クイックスタート

学べること

このチュートリアルを完了すると、以下ができるようになります：

API Key または OAuth トークンで ChainStream に認証する
API を呼び出してトークンメタデータを取得する
CLI と SDK で同じクエリを実行する
API レスポンスの構造を理解する

推定所要時間: 5 分

前提条件

ChainStream アカウントの登録（こちらから登録）

ステップ 1: API Key の取得

ChainStream Dashboard にログイン
Applications に移動
Create New App をクリック
API Key（cs_live_... で始まるもの）をコピー

API Key は最も簡単な認証方法です。OAuth 2.0 JWT フローについては、認証を参照してください。

ステップ 2: 最初のリクエスト

Solana 上の SOL トークンメタデータをクエリします。お好みの方法を選択してください：

cURL
CLI
SDK (TypeScript)
MCP (AI Agent)
OAuth 2.0 (JWT)

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

# npx でワンライナー実行（インストール不要）
npx @chainstream-io/cli token info --chain sol \
  --address So11111111111111111111111111111111111111112

CLI は初回実行時に認証を求めます。事前にキーを設定することもできます：

npx @chainstream-io/cli config set --key apiKey --value 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);

AI エージェントを ChainStream データに接続します — コード不要：

CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp

その後、AI に尋ねてみましょう：「Solana の SOL トークンは何ですか？」Claude/Cursor の設定については、MCP Server セットアップを参照してください。

OAuth 2.0 Client Credentials フローを使用するアプリ向け：

# ステップ 1: アクセストークンの取得
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"
  }'

# ステップ 2: トークンを使用
curl "https://api.chainstream.io/v2/token/sol/So11111111111111111111111111111111111111112" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

YOUR_ACCESS_TOKEN をステップ 2 で生成したトークンに置き換えてください。

レスポンス例

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

ステップ 4: レスポンスの理解

フィールド	型	説明
`chain`	string	ブロックチェーンネットワーク識別子
`decimals`	integer	トークンの小数桁数
`name`	string	トークン名
`symbol`	string	トークンシンボル
`address`	string	トークンのコントラクトアドレス
`imageUrl`	string	トークンロゴの URL
`tokenCreatedAt`	integer	トークン作成タイムスタンプ（ミリ秒）

完全なフィールド説明については、Token Metadata API リファレンスを参照してください。

ステップ 5: その他の API を試す

最初の呼び出しが成功しました。次にこれらの API を試してみましょう：

トークン価格の取得

リアルタイムのトークン価格を取得GET /v1/token/{chain}/{tokenAddress}/price

ウォレット残高の取得

ウォレットのトークン保有状況をクエリGET /v1/wallet/{chain}/{walletAddress}/balance

よくある問題

401 Unauthorized エラー

以下を確認してください：

Access Token は正しく、期限切れではありませんか？
ヘッダー形式は Authorization: Bearer YOUR_ACCESS_TOKEN ですか？
Client ID と Client Secret を使用して新しいトークンを生成してみてください

429 Too Many Requests エラー

リクエストのレート制限に達しました。フリープランは 10 リクエスト/秒に制限されています。プランをアップグレードすることで制限を引き上げられます。詳細は API セキュリティを参照してください。

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

URL のチェーンパラメータを変更します：GET /v1/token/eth/{address}/metadata ← Ethereum の場合GET /v1/token/bsc/{address}/metadata ← BSC の場合完全なリストはリアルタイムストリーミングを参照してください。

次のステップ

ユースケースに基づいて次の学習パスを選択してください：

データ開発者

データコンセプトでデータモデルを理解する

GraphQL API

柔軟なオンチェーンクエリのための OLAP 分析 GraphQL API を探索

コンプライアンスユーザー

セキュリティコンプライアンスで KYT/KYA を学ぶ

AI 開発者

AI インフラストラクチャで MCP と Agent Skills を学ぶ

CLI

スクリプティング、CI/CD、AI エージェントワークフローに CLI を使用

問題がありますか？FAQ を確認するか、テクニカルサポートにお問い合わせください。

はじめに

データコンセプト

AIインフラストラクチャ

CLI

セキュリティとコンプライアンス

インテグレーション

リソース

法務・ポリシー

クイックスタート

学べること

前提条件

ステップ 1: API Key の取得

ステップ 2: 最初のリクエスト

レスポンス例

ステップ 4: レスポンスの理解

ステップ 5: その他の API を試す

トークン価格の取得

ウォレット残高の取得

よくある問題

次のステップ

データ開発者

GraphQL API

コンプライアンスユーザー

AI 開発者

CLI

はじめに

データコンセプト

AIインフラストラクチャ

CLI

セキュリティとコンプライアンス

インテグレーション

リソース

法務・ポリシー

​学べること

​前提条件

​ステップ 1: API Key の取得

​ステップ 2: 最初のリクエスト

​レスポンス例

​ステップ 4: レスポンスの理解

​ステップ 5: その他の API を試す

トークン価格の取得

ウォレット残高の取得

​よくある問題

​次のステップ

データ開発者

GraphQL API

コンプライアンスユーザー

AI 開発者

CLI

学べること

前提条件

ステップ 1: API Key の取得

ステップ 2: 最初のリクエスト

レスポンス例

ステップ 4: レスポンスの理解

ステップ 5: その他の API を試す

よくある問題

次のステップ