> ## Documentation Index > Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt > Use this file to discover all available pages before exploring further. # 计费与配额 > 了解 ChainStream 的计费模型和配额管理 ## 概述 ChainStream 采用 **Unit 计费模型**。不同 API 消耗不同数量的 Unit，你可以选择适合业务需求的套餐。 *** ## 计费模型 ### 套餐类型 **\$0 / 月** * 30K Units/月 * 无超量 * 适用于开发、POC **\$199 / 月** * 10M Units/月 * 超量：\$12.9/百万 * 适用于小型项目、MVP **\$699 / 月** * 50M Units/月 * 超量：\$9.9/百万 * 适用于生产环境、中等流量 **\$1,699 / 月** * 200M Units/月 * 超量：\$6.9/百万 * 适用于大型企业、高并发 **定制价格** * 自定义 Units 配额 * 自定义超量费率 * 私有部署、专属 SLA 所有套餐在配额耗尽时将被阻止（返回 403 错误）。付费套餐用户可在 Dashboard 购买额外配额以恢复服务。 ### 套餐选择指南 **使用场景：** * 本地开发与调试 * 功能验证与演示 * 学习和评估 ChainStream API **典型用量估算：** * 每天 300 次价格查询 → 约 9,000 Units/月 **限制：** * 数据可能有 1-2 秒延迟 * 无 SLA 保证 * 配额耗尽后无法继续调用 **使用场景：** * 个人开发者的小型 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 套餐。 **使用场景：** * 中小型交易所或钱包的数据需求 * 专业交易工具 * 需要 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 报价。 **使用场景：** * 大型交易所 * 机构量化交易 * 私有部署或定制 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](https://www.chainstream.io/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 协议](https://www.x402.org/) 实现 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 | ### 工作原理 1. Agent 调用任意 ChainStream API 2. 服务器返回 402（无有效订阅） 3. Agent 从 `/x402/pricing` 获取可用套餐 4. Agent 通过 x402 或 MPP 购买套餐 5. 服务器返回 **API Key** — Agent 保存用于后续所有调用 x402 和 MPP 支付流程的完整详情 *** ## 常见问题 建议先使用 Free 套餐评估实际用量，然后根据月消耗选择： * \< 30K Units：Free * 30K - 10M Units：Starter * 10M - 50M Units：Pro * \> 50M Units：Enterprise 可以。升级立即生效，按比例收费。降级在下个计费周期生效。 不会。月度配额在每月底重置，不会累积到下月。 在 Dashboard → 计费 → 发票中下载历史发票。Enterprise 客户可联系销售获取定制发票。 *** ## 下一步 常见问题解答 了解 API 安全配置 开始调用 API