快速開始

讀完本文後你將擁有：

一個 API Key（或 OAuth Token）
一次跑通的 REST API 呼叫
一次跑通的 SDK、CLI、MCP Server 呼叫
明確的下一步——REST / GraphQL / WebSocket / Kafka / SDK / CLI / MCP，哪個最適合你的場景

預計時間：5 分鐘。

前置條件

一個 ChainStream 賬號。如未註冊請到這裡。

1. 獲取 API Key

開啟 ChainStream Dashboard。
進入 Applications。
點選 Create New App。
複製生成的 API Key（cs_live_… 開頭）。

API Key 是最快的接入方式。服務間（M2M）請參考 OAuth 2.0 client-credentials——見 API Key 與 OAuth。

2. 發起首次請求

下例取 Solana 上 Wrapped SOL 的後設資料。選你要接入的方式：

cURL
SDK (TypeScript)
CLI
MCP (AI Agent)
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

首次執行會提示輸入 Key，也可顯式設定：

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

CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp

之後向你的 Agent 提問 “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	Logo URL（可能為空）。
`tokenCreatedAt`	integer	建立時間戳（ms）。

3. 選擇合適的接入方式

上面只是一次簡單的請求-響應呼叫，真實整合通常需要更多：

REST API

按需查詢——代幣、錢包、池子、交易、合規。

GraphQL

針對整個鏈上資料 cube 的靈活分析查詢。

WebSocket

面向實時 UI 與瀏覽器應用的亞秒級推送。

Kafka Streams

面向後端、索引器、交易引擎的 exactly-once 投遞。

SDK

TypeScript / Python / Go / Rust，內建鑑權的型別化客戶端。

CLI

指令碼、CI/CD，以及 AI Agent 的按次付費呼叫。

常見問題

401 Unauthorized

確認請求頭中 X-API-KEY 或 Authorization: Bearer … 拼寫正確。
Key 被輪換過請重新生成。
OAuth 模式下檢查 token 是否過期（預設 TTL 1 小時）。

429 Too Many Requests

達到套餐限速。免費套餐為 10 次/秒，請升級或按指數回退。詳見計費與額度。

如何查詢其他鏈的代幣？

替換 URL 中的鏈標識即可：solana、ethereum、bsc、base、polygon、 arbitrum、optimism、avalanche、zksync、tron。完整列表見支援的鏈。

下一步

瀏覽資料目錄

我們釋出的每個資料集與覆蓋範圍、重新整理頻率。

啟動實時流

訂閱實時交易、價格、轉賬、池子事件。

執行合規檢查

對轉賬、提現、對手方的 KYT / KYA。

構建 AI Agent

透過 MCP + Agent Skills 接入 Claude、Cursor、ChatGPT。

資料產品

接入方式

AI Agents

合規 (KYT/KYA)

教學

實戰範例

平台

生態

參考

前置條件

1. 獲取 API Key

2. 發起首次請求

響應

3. 選擇合適的接入方式

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

常見問題

下一步

瀏覽資料目錄

啟動實時流

執行合規檢查

構建 AI Agent

​前置條件

​1. 獲取 API Key

​2. 發起首次請求

​響應

​3. 選擇合適的接入方式

REST API

GraphQL

WebSocket

Kafka Streams

SDK

CLI

​常見問題

​下一步

瀏覽資料目錄

啟動實時流

執行合規檢查

構建 AI Agent

前置條件

1. 獲取 API Key

2. 發起首次請求

響應

3. 選擇合適的接入方式

常見問題

下一步