计费与配额 - ChainStream

概述

ChainStream 采用 Unit 计费模型。不同 API 消耗不同数量的 Unit，你可以选择适合业务需求的套餐。

计费模型

套餐类型

Free

$0 / 月

30K Units/月
无超量
适用于开发、POC

Starter

$199 / 月

10M Units/月
超量：$12.9/百万
适用于小型项目、MVP

Pro

$699 / 月

50M Units/月
超量：$9.9/百万
适用于生产环境、中等流量

Enterprise

$1,699 / 月

200M Units/月
超量：$6.9/百万
适用于大型企业、高并发

Custom

定制价格

自定义 Units 配额
自定义超量费率
私有部署、专属 SLA

所有套餐在配额耗尽时将被阻止（返回 403 错误）。付费套餐用户可在 Dashboard 购买额外配额以恢复服务。

套餐选择指南

Free — 适用于开发与测试

使用场景：

本地开发与调试
功能验证与演示
学习和评估 ChainStream API

典型用量估算：

每天 300 次价格查询 → 约 9,000 Units/月

限制：

数据可能有 1-2 秒延迟
无 SLA 保证
配额耗尽后无法继续调用

Starter — 适用于小型项目

使用场景：

个人开发者的小型 dApp
交易机器人原型
小型行情展示网站

典型用量估算：

行情看板（10 个代币，每分钟刷新）→ 约 43,200 Units/月
小型交易机器人（每秒 1 次查询）→ 约 86,400 Units/月（单代币）

示例场景： 构建一个 Solana 代币行情网站，展示 20 个热门代币，每 30 秒刷新：

20 代币 × 2 次/分 × 60 分 × 24 小时 × 30 天 = 1,728,000 请求
按 1 Unit/请求 = 1,728,000 Units/月

此场景推荐 Pro 套餐。

Pro — 适用于生产环境

使用场景：

中小型交易所或钱包的数据需求
专业交易工具
需要 KYT/KYA 风控的业务

典型用量估算：

中型行情平台（100 个代币，实时 WebSocket）→ 约 500,000 Units/月
充值风控（每天 1000 次 KYT 检查）→ 约 150,000 Units/月

示例场景： 运营一个小型交易所，需要：

行情数据：50 个交易对，WebSocket 实时推送
充值风控：每天 500 笔充值，每笔做 KYT 检查

WebSocket: 50 × 0.1 Unit/消息 × 86400 秒 × 30 天 ≈ 12,960,000 消息 = 1,296,000 Units
KYT: 500 × 5 Units × 30 天 = 75,000 Units
合计：约 1,371,000 Units/月

此场景推荐 Pro 套餐 + 超量预算，或联系销售获取 Enterprise 报价。

Enterprise — 适用于大型企业

使用场景：

大型交易所
机构量化交易
私有部署或定制 SLA 需求

包含：

无限 API 调用
专属技术支持
定制 SLA（99.99%+）
可选私有部署

联系销售获取报价。

Unit 计算

什么是 Unit

Unit 是 ChainStream 的计费单位。不同 API 消耗不同数量的 Unit — 越复杂的 API 消耗越多。

Data API 消耗

Unit 成本按计算复杂度分层。简单查询成本较低；聚合密集型和链上执行端点成本较高。

API	CU	端点
代币搜索	0.25	`GET /v2/token/search`
代币详情	1.00	`GET /v2/token/{chain}/{tokenAddress}`
批量详情	0.75	`GET /v2/token/{chain}/multi`
代币元数据	0.05	`GET /v2/token/{chain}/{tokenAddress}/metadata`
批量元数据	0.05	`GET /v2/token/{chain}/metadata/multi`
代币价格	0.10	`GET /v2/token/{chain}/{tokenAddress}/price`
历史价格	0.10	`GET /v2/token/{chain}/{tokenAddress}/prices`
市场数据	0.10	`GET /v2/token/{chain}/{tokenAddress}/marketData`
批量市场数据	0.10	`GET /v2/token/{chain}/marketData/multi`
代币统计	2.50	`GET /v2/token/{chain}/{tokenAddress}/stats`
批量统计	2.50	`GET /v2/token/{chain}/stats/multi`
K 线 (OHLCV)	0.25	`GET /v2/token/{chain}/{tokenAddress}/candles`
交易对 K 线	0.25	`GET /v2/token/{chain}/pair/{pair}/candles`
池子 K 线	0.25	`GET /v2/token/{chain}/pool/{poolAddress}/candles`
持有者	0.50	`GET /v2/token/{chain}/{tokenAddress}/holders`
批量持有者	0.50	`GET /v2/token/{chain}/{tokenAddress}/holders/multi`
Top 持有者	0.50	`GET /v2/token/{chain}/{tokenAddress}/topHolders`
流动性池	2.50	`GET /v2/token/{chain}/{tokenAddress}/pools`
安全审计	0.50	`GET /v2/token/{chain}/{tokenAddress}/security`
创建信息	0.10	`GET /v2/token/{chain}/{tokenAddress}/creation`
铸造/销毁	0.50	`GET /v2/token/{chain}/{tokenAddress}/mintAndBurn`
按标签交易者	0.50	`GET /v2/token/{chain}/{tokenAddress}/traders/{tag}`
流动性快照	0.50	`GET /v2/token/{chain}/{tokenAddress}/liquiditySnapshots`
代币列表	0.05	`GET /v2/token/{chain}/list`
开发者代币	0.50	`GET /v2/token/{chain}/dev/{devAddress}/tokens`
转账总计	0.25	`GET /v2/token/{chain}/{tokenAddress}/transfer-total`
转账记录	0.25	`GET /v2/token/{chain}/{tokenAddress}/transfers`

API	CU	端点
代币余额	1.00	`GET /v2/wallet/{chain}/{walletAddress}/tokens-balance`
余额变动	0.50	`GET /v2/wallet/{chain}/{walletAddress}/balance-updates`
盈亏 (PnL)	1.00	`GET /v2/wallet/{chain}/{walletAddress}/pnl`
按代币盈亏	1.00	`GET /v2/wallet/{chain}/{walletAddress}/pnl-by-token`
盈亏详情	1.50	`GET /v2/wallet/{chain}/{walletAddress}/pnl-details`
计算盈亏	1.50	`POST /v2/wallet/{chain}/{walletAddress}/calculate-pnl`
净值	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth`
净值图表	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth-chart`
净值详情	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth-details`
净值代币	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth/tokens`
转账记录	0.25	`GET /v2/wallet/{chain}/{walletAddress}/transfers`
转账总计	0.25	`GET /v2/wallet/{chain}/{walletAddress}/transfer-total`
首笔交易	0.10	`GET /v2/wallet/{chain}/first-tx`
净值汇总	1.00	`GET /v2/wallet/{chain}/net-worth-summary`
按钱包盈亏	1.00	`GET /v2/wallet/{chain}/pnl-by-wallet`
添加关注	0.05	`POST /v2/watchlist/{chain}/{walletAddress}`

API	CU	端点
交易记录	0.25	`GET /v2/trade/{chain}`
交易活动	0.25	`GET /v2/trade/{chain}/activities`
Top 交易者	0.50	`GET /v2/trade/{chain}/top-traders`
盈亏排行	0.50	`GET /v2/trade/{chain}/trader-gainers-losers`

API	CU	端点
池子信息	0.50	`GET /v2/dexpools/{chain}/{poolAddress}`
池子快照	0.50	`GET /v2/dexpools/{chain}/{poolAddress}/snapshots`

API	CU	端点
热门代币	0.25	`GET /v2/ranking/{chain}/hotTokens/{duration}`
新代币	0.25	`GET /v2/ranking/{chain}/newTokens`
已迁移代币	0.25	`GET /v2/ranking/{chain}/migrated`
即将毕业	0.25	`GET /v2/ranking/{chain}/finalStretch`
股票代币	0.25	`GET /v2/ranking/{chain}/stocks`

API	CU	端点
支持的 DEX	0.05	`GET /v2/dex`
报价	0.25	`GET /v2/dex/{chain}/quote`
路由	0.25	`POST /v2/dex/{chain}/route`
创建代币	5.00	`POST /v2/dex/{chain}/create`
执行兑换	5.00	`POST /v2/dex/{chain}/swap`
任务状态	0.05	`GET /v2/job/{id}`
任务流式	0.05	`GET /v2/job/{id}/streaming`

API	CU	端点
支持的链	0.05	`GET /v2/blockchain`
最新区块	0.05	`GET /v2/blockchain/{chain}/latest_block`
Gas 价格	0.10	`GET /v2/transaction/{chain}/gas-price`
Gas 估算	0.25	`POST /v2/transaction/{chain}/estimate-gas-limit`
发送交易	5.00	`POST /v2/transaction/{chain}/send`

API	CU	端点
列出端点	0.05	`GET /v2/webhook/endpoint`
创建端点	0.05	`POST /v2/webhook/endpoint`
获取端点	0.05	`GET /v2/webhook/endpoint/{id}`
更新端点	0.05	`PATCH /v2/webhook/endpoint`
删除端点	0.05	`DELETE /v2/webhook/endpoint/{id}`
获取密钥	0.05	`GET /v2/webhook/endpoint/{id}/secret`
轮换密钥	0.10	`POST /v2/webhook/endpoint/{id}/secret/rotate`

API	CU	端点
列出红包	0.05	`GET /v2/redpacket`
获取红包	0.05	`GET /v2/redpacket/{id}`
领取记录	0.05	`GET /v2/redpacket/{id}/claims`
钱包领取	0.05	`GET /v2/redpacket/wallet/{address}/claims`
钱包红包	0.05	`GET /v2/redpacket/wallet/{address}/redpackets`
创建红包	5.00	`POST /v2/redpacket/{chain}/create`
领取红包	5.00	`POST /v2/redpacket/{chain}/claim`
发送红包	5.00	`POST /v2/redpacket/{chain}/send`

CU 定价层级

层级	CU 成本	说明	示例
Tier 1	0.05	元数据、列表、简单查询	代币列表、链信息、Webhook CRUD、任务状态
Tier 2	0.10	单字段查询	价格、市场数据、创建信息、Gas 价格
Tier 3	0.25	搜索、交易、排行、K 线	代币搜索、OHLCV、交易活动、排行榜
Tier 4	0.50	持有者、安全、快照	持有者、安全审计、池子快照、Top 交易者
Tier 5	1.00	完整画像、盈亏、净值	代币详情、钱包盈亏、净值
Tier 6	1.50	计算密集型分析	盈亏详情、计算盈亏
Tier 7	2.50	聚合密集型	代币统计、流动性池（多源聚合）
Tier 8	5.00	链上执行	兑换、创建代币、发送交易

WebSocket 实时订阅计费

WebSocket 实时数据订阅单独计费，按数据字节收费：

项目	费率	说明
WebSocket 数据	0.005 Unit/字节	按推送数据字节收费
WebSocket 连接	免费	建立连接不收费
心跳消息	免费	心跳包不收费

支持的订阅频道

频道	说明
`dex-candle:{chain}_{tokenAddress}_{resolution}`	实时 K 线数据

频道	说明
`dex-token-stats:{chain}_{tokenAddress}`	代币统计
`dex-token-holding:{chain}_{tokenAddress}`	持有者统计
`dex-token-supply:{chain}_{tokenAddress}`	供应量与市值
`dex-token-general-stat-num:{chain}_{tokenAddress}`	流动性统计
`dex-new-token:{chain}`	新代币信息
`dex-new-tokens-metadata:{chain}`	新代币元数据

频道	说明
`dex-ranking-list:{chain}_{ranking_type}`	排行代币列表
`dex-ranking-token-stats-list:{chain}_{channelType}`	排行代币统计
`dex-ranking-token-holding-list:{chain}_{channelType}`	排行持有者统计
`dex-ranking-token-supply-list:{chain}_{channelType}`	排行供应量

频道	说明
`dex-wallet-balance:{chain}_{walletAddress}`	钱包余额
`dex-wallet-token-pnl:{chain}_{walletAddress}`	代币级盈亏
`dex-wallet-pnl-list:{chain}_{walletAddress}`	钱包级盈亏

频道	说明
`dex-trade:{chain}_{tokenAddress}`	代币交易
`dex-wallet-trade:{chain}_{walletAddress}`	钱包交易

频道	说明
`dex-pool-balance:{chain}_{poolAddress}`	池子余额

WebSocket 用量估算示例

场景：监控 10 个代币的实时 K 线（1 分钟分辨率）

计算：
- 每条 K 线消息约 200 字节
- 每个代币每分钟约 1 条 K 线消息
- 10 代币 × 1 条/分 × 60 分 × 24 小时 × 30 天 = 432,000 条消息
- 总数据量：432,000 × 200 = 86,400,000 字节
- 月费：86,400,000 × 0.005 = 432,000 Units

场景：监控 50 个代币的统计数据（实时，约每秒 1 次更新）

计算：
- 代币统计消息约 500 字节
- 50 代币 × 1 条/秒 × 86,400 秒 × 30 天 = 129,600,000 条消息
- 总数据量：129,600,000 × 500 = 64,800,000,000 字节（约 64.8 GB）
- 月费：64,800,000,000 × 0.005 = 324,000,000 Units（约 324M）

批量 API 通常有折扣。具体消耗请参考 API 参考文档。WebSocket 消息频率取决于市场活跃度；高波动时期消息量会增加。

KYT/KYA 服务计费

KYT/KYA API 不消耗套餐 Unit。它们从独立的 KYT 账户余额（美元）中扣费。请在 Dashboard → KYT 服务中充值。

API	费用	端点
注册转账	$0.25/次	`POST /v2/kyt/transfer`
注册提现	$0.25/次	`POST /v2/kyt/withdrawal`
注册地址	$1.25/次	`POST /v2/kyt/address`
查询风险/告警/暴露	已包含	`GET /v2/kyt/addresses//risk`、`GET /v2/kyt/transfers//summary` 等

费用估算示例

行情展示应用
交易机器人
交易所风控

场景： 一个 DeFi 行情网站展示 50 个代币价格，每 10 秒刷新

计算：
- 请求频率：50 代币 × 6 次/分 = 300 请求/分
- 月请求量：300 × 60 × 24 × 30 = 12,960,000 请求
- 每次请求 CU：0.10（代币价格端点）
- 月 CU：12,960,000 × 0.10 = 1,296,000 CU

推荐：Starter 套餐（10M CU）

场景： 一个套利机器人监控 5 个交易对，每秒查询价格

REST 方式：
- 5 × 1/秒 × 86,400 × 30 = 12,960,000 请求
- CU：12,960,000 × 0.10 = 1,296,000 CU

WebSocket 方式（推荐）：
- 5 对 × 约 200 字节/消息 × 1 条/秒 × 86,400 × 30
- = 2,592,000,000 字节 × 0.005 CU/字节 = 12,960,000 CU

推荐：REST 用 Pro 套餐；WebSocket 用 Starter

场景： 小型交易所，每天 1000 笔充值需要 KYT 检查

计算：
- 每天：1,000 次 KYT 转账注册
- 每月：1,000 × 30 = 30,000 次调用
- 费用：30,000 × $0.25 = $7,500/月（KYT 单独以美元计费）

注意：KYT 不消耗套餐 CU。请单独充值 KYT 余额。

配额管理

在 Dashboard 查看用量

访问 ChainStream Dashboard

查看用量

在用量页面查看当月使用量、剩余配额和历史趋势

配额告警设置

你可以设置配额告警，在用量达到阈值时收到通知：

告警级别	触发条件	通知方式
提醒	使用 50%	邮件
警告	使用 80%	邮件 + Dashboard 告警
严重	使用 100%	邮件 + Dashboard 告警

建议至少开启 80% 告警，避免意外的服务中断。

配额耗尽处理

配额用完会怎样

当月配额耗尽时，API 将返回 403 错误，无法继续调用。付费套餐用户可手动购买额外配额以恢复服务。

套餐	处理方式
Free	API 返回 403 错误，等待下月配额重置
Starter / Pro / Enterprise	API 返回 403 错误，可购买额外配额恢复服务
Custom	按合同条款

购买额外配额

付费套餐用户可在 Dashboard 购买额外配额，按套餐的超量费率定价：

套餐	额外配额价格
Starter	$12.9 / 百万 Units
Pro	$9.9 / 百万 Units
Enterprise	$6.9 / 百万 Units

配额耗尽时服务立即中断（返回 403 错误）。建议设置 80% 用量告警并提前购买额外配额，避免影响业务。

支付方式

支持的支付方式

方式	说明	适用套餐
信用卡	Visa、MasterCard、AMEX	所有套餐
加密货币	USDT、USDC（ERC-20 / TRC-20）	Starter 及以上
银行转账	联系销售	Enterprise

计费周期

月付套餐： 每月 1 日生成上月账单
年付套餐： 免 2 个月（相当于 16.7% 折扣）

AI Agent 支付（x402 / MPP）

对于需要编程访问而无需 Dashboard 注册的 AI Agent，ChainStream 支持两种链上支付协议：

x402（Base / Solana USDC）

x402 协议实现 HTTP 原生微支付。当 API 调用返回 402 时，Agent 的钱包签名 USDC 转账并重试 — 无需注册账号。

属性	值
网络	Base（链 ID 8453）、Solana
货币	USDC
标准	EIP-3009（Base）、原生转账（Solana）
Gas 费	免费 — ChainStream 的 facilitator 代付所有 gas 费用

你只需支付 USDC 订阅费用。ChainStream 运营自有的 x402 facilitator，负责提交链上交易并代付 gas 费 — Agent 钱包无需持有 ETH 或 SOL 来支付 gas。

MPP（Tempo USDC.e）

MPP 使用 Tempo 网络进行支付。Gas 直接用 USDC.e 支付 — 无需 ETH。

属性	值
网络	Tempo（链 ID 4217）
货币	USDC.e

工作原理

Agent 调用任意 ChainStream API
服务器返回 402（无有效订阅）
Agent 从 /x402/pricing 获取可用套餐
Agent 通过 x402 或 MPP 购买套餐
服务器返回 API Key — Agent 保存用于后续所有调用

x402 支付指南

x402 和 MPP 支付流程的完整详情

常见问题

如何选择合适的套餐？

建议先使用 Free 套餐评估实际用量，然后根据月消耗选择：

< 30K Units：Free
30K - 10M Units：Starter
10M - 50M Units：Pro
> 50M Units：Enterprise

可以随时升级/降级吗？

可以。升级立即生效，按比例收费。降级在下个计费周期生效。

未使用的配额会累积吗？

不会。月度配额在每月底重置，不会累积到下月。

如何获取发票？

在 Dashboard → 计费 → 发票中下载历史发票。Enterprise 客户可联系销售获取定制发票。

下一步

常见问题

常见问题解答

API 安全

了解 API 安全配置

API 参考

开始调用 API

​概述

​计费模型

​套餐类型

Free

Starter

Pro

Enterprise

Custom

​套餐选择指南

​Unit 计算

​什么是 Unit

​Data API 消耗

​CU 定价层级

​WebSocket 实时订阅计费

​支持的订阅频道

​WebSocket 用量估算示例

​KYT/KYA 服务计费

​费用估算示例

​配额管理

​在 Dashboard 查看用量

​配额告警设置

​配额耗尽处理

​配额用完会怎样

​购买额外配额

​支付方式

​支持的支付方式

​计费周期

​AI Agent 支付（x402 / MPP）

​x402（Base / Solana USDC）

​MPP（Tempo USDC.e）

​工作原理

x402 支付指南

​常见问题

​下一步

常见问题

API 安全

API 参考

概述

计费模型

套餐类型

套餐选择指南

Unit 计算

什么是 Unit

Data API 消耗

CU 定价层级

WebSocket 实时订阅计费

支持的订阅频道

WebSocket 用量估算示例

KYT/KYA 服务计费

费用估算示例

配额管理

在 Dashboard 查看用量

配额告警设置

配额耗尽处理

配额用完会怎样

购买额外配额

支付方式

支持的支付方式

计费周期

AI Agent 支付（x402 / MPP）

x402（Base / Solana USDC）

MPP（Tempo USDC.e）

工作原理

常见问题

下一步