你将学到
完成本教程后，你将能够：
- 使用 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 工作流
