跳转到主要内容

账户与认证

  1. 登录 ChainStream Dashboard
  2. 进入 Apps 页面
  3. 点击 Create New App
  4. 获取 Client ID 和 Client Secret
  5. 使用 Client ID 和 Client Secret 向 Auth 服务请求 Access Token (JWT)
详细步骤见 认证文档

数据相关

目前支持以下公链:完整列表见 实时数据概念
延迟可能因网络状况和数据复杂度有所波动。
使用 WebSocket 可获得最实时的数据推送。

计费相关

Free 套餐限制:
  • 额度: 每月 30K Units
  • 请求频率: 10 请求/秒
  • 数据延迟: 可能有 1-2 秒延迟
  • SLA: 不保证
  • 超额: 额度用尽后返回 403 错误,下月重置
适合开发测试和功能验证,不建议用于生产环境。
  1. 登录 Dashboard
  2. Usage 页面查看当月使用量、剩余额度、历史趋势
加密货币支付支持 ERC-20 和 TRC-20 网络。
  • 升级: 立即生效,按比例补差价
  • 降级: 在下个账单周期生效
在 Dashboard → Billing → Subscription 页面操作。
不可以。每月额度在月底清零,不累积到下月。建议根据实际用量选择合适的套餐。

技术问题

  • 429 错误:请求频率超限
  • 403 错误:配额用尽
排查步骤:
  1. 429 - 检查是否超频
    • Free 套餐:10 请求/分钟
    • 付费套餐:见 API 安全
  2. 403 - 检查额度是否用尽
    • 在 Dashboard → Usage 查看剩余额度
    • 付费套餐可购买额外用量恢复服务
解决方案:
  • 429:实现请求节流或指数退避重试
  • 403:购买额外用量或升级套餐
  • 使用 WebSocket 替代轮询减少请求数
建议实现自动重连机制:
重连建议:
  • 使用指数退避策略(1s → 2s → 4s → … → 30s)
  • 设置最大重连延迟(如 30 秒)
  • 重连成功后重新订阅数据
所有 API 返回 JSON 格式。成功响应:
错误响应:
常见错误码见 Error Codes
方法 1:使用 API PlaygroundAPI Reference 页面使用 “Try It” 功能,无需编写代码即可测试。方法 2:使用 cURL添加 -v 参数查看详细请求信息:

KYT/KYA 相关

详见 Security Compliance 文档
地址验证返回以下字段:
Address Verification 返回以下风险等级:注意: 具体处理策略应根据你的业务合规要求设定,以上仅为参考建议。
Risk Exposures 显示地址与各类风险实体的关联情况,常见标签包括:高危标签(Severe):中性/低危标签:其他风险标签:每个标签会显示:
  • direct / indirect:直接关联或间接关联
  • 金额:关联的资金量
  • 百分比:占该地址总交易量的比例
示例:
  • sanctioned entity + direct:该地址直接向受制裁地址转账
  • sanctioned entity + indirect:该地址的关联地址曾与受制裁地址交互
即使是 indirect 关联,如果涉及 Severe 级别的标签(如制裁、恐怖融资),仍建议谨慎处理。
地址类型有助于理解资金流向和业务背景。
响应示例:
状态为 PENDING 时表示正在分析中,可稍后重试获取完整结果。
KYT/KYA API 不消耗套餐 Units,而是从独立的 KYT 账户余额扣费(美元计价)。请在 Dashboard → KYT Service 页面进行充值。

AI/MCP 相关

MCP(Model Context Protocol)是 Anthropic 提出的协议,让 AI 模型能够调用外部工具。ChainStream 提供 MCP Server,让 Claude 等 AI 可以直接查询链上数据。详见 MCP Server 文档
  1. 安装 ChainStream MCP Server
  2. 配置 Claude Desktop 的 MCP 设置
  3. 重启 Claude Desktop
  4. 开始对话,Claude 可以自动调用 ChainStream 查询数据
详细配置步骤见 Claude Integration 指南
目前不支持。 ChainStream MCP Server 仅提供读取操作,包括:
  • 查询代币价格和信息
  • 查询钱包持仓和交易记录
  • 执行 KYT/KYA 风险评估
不支持自动执行交易、转账等写入操作,这是出于安全考虑。
MCP 调用与直接 API 调用计费相同,按照实际调用的 API 类型消耗对应的 Units。

联系支持

联系时请提供:
  • Client ID
  • 错误信息和复现步骤
感谢帮助我们改进文档!

没找到答案?

联系我们

如果以上 FAQ 没有解答你的问题,请联系技术支持团队。