你將學到
完成本教程後，你將能夠：
- 使用 API Key 或 OAuth Token 認證 ChainStream
- 呼叫 API 獲取代幣後設資料
- 使用 CLI 和 SDK 完成相同的查詢
- 理解 API 響應結構
前提條件
第一步：獲取 API Key
- 登入 ChainStream Dashboard
- 進入 Applications
- 點選 Create New App
- 複製你的 API Key（以
cs_live_... 開頭）
API Key 是最快的認證方式。如需 OAuth 2.0 JWT 流程，參見認證。
第二步：發起第一個請求
查詢 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
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 Agent 連線到 ChainStream 資料 — 無需編碼：CHAINSTREAM_API_KEY=your_api_key npx @chainstream-io/mcp
適用於使用 OAuth 2.0 Client Credentials 流程的應用：# 第一步：获取 access token
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"
}'
# 第二步：使用 token
curl "https://api.chainstream.io/v2/token/sol/So11111111111111111111111111111111111111112" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
將 YOUR_ACCESS_TOKEN 替換為你生成的 token。
響應示例
{
"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
}
第三步：理解響應
| 欄位 | 型別 | 說明 |
|---|
chain | string | 區塊鏈網路標識 |
decimals | integer | 代幣小數位數 |
name | string | 代幣名稱 |
symbol | string | 代幣符號 |
address | string | 代幣合約地址 |
imageUrl | string | 代幣 Logo URL |
tokenCreatedAt | integer | 代幣建立時間戳（毫秒） |
第四步：嘗試更多 API
成功完成第一次呼叫後，試試這些 API：
獲取代幣價格
獲取實時代幣價格GET /v2/token/{chain}/{tokenAddress}/price
獲取錢包餘額
查詢錢包代幣持倉GET /v2/wallet/{chain}/{walletAddress}/tokens-balance
常見問題
請檢查：
- Access Token 是否正確且未過期？
- Header 格式是否為
Authorization: Bearer YOUR_ACCESS_TOKEN 或 X-API-KEY: your_key？
- 嘗試使用 Client ID 和 Client Secret 重新生成 token
你已達到請求速率限制。免費版限制為每秒 10 次請求。你可以升級套餐以提高限制。詳見 API 安全。
修改 URL 中的 chain 引數，例如：GET /v2/token/ethereum/{address} 查詢以太坊GET /v2/token/bsc/{address} 查詢 BSC參見支援的鏈獲取完整列表。
下一步
根據你的使用場景選擇學習路徑：
GraphQL API
探索 OLAP 分析型 GraphQL API，靈活查詢鏈上資料
AI 開發者
前往 AI 基礎設施瞭解 MCP 和 Agent Skills
CLI
使用 CLI 進行指令碼、CI/CD 和 AI Agent 工作流
