跳转到主要内容
REST API 是从 ChainStream 拿数据最简单的方式。每个 数据产品 都以 JSON 端点形式暴露，共享同一套鉴权与错误信封。

​
Base URL

https://api.chainstream.io

​
鉴权

使用以下任意一种： 
-H "Authorization: Bearer $CHAINSTREAM_API_KEY"
-H "Authorization: Bearer $OAUTH_TOKEN"
-H "X-PAYMENT: <signed payload>"
完整矩阵见 鉴权。

​
第一次请求

curl -H "Authorization: Bearer $CHAINSTREAM_API_KEY" \
  "https://api.chainstream.io/v2/token/search?chain=sol&keyword=USDC&limit=5"

​
什么时候用

  • 单次查询、快照、服务端渲染页面
  • 亚秒级延迟不是关键的场景
  • 与 WebSocket 搭配（REST 查历史、WS 跑实时）
  • Agent 工具调用——每次调用对应一个端点
不建议用 的场景：高频流式（用 WebSocket 或 Kafka）、跨产品 JOIN（用 GraphQL）。

​
约定

  • 分页：列表端点使用 limit + cursor（基于游标）
  • 限流：按套餐；响应头 X-RateLimit-Remaining、X-RateLimit-Reset
  • 错误：RFC 7807 风格 JSON，包含 code、message、requestId

​
下一步

API Reference

所有 REST 端点，带请求 / 响应示例。

SDK

TS / Py / Go / Rust 的类型化封装。

限流

各套餐吞吐上限与规划方法。

鉴权

API Key、OAuth、钱包登录、x402。