Billing and Units - ChainStream

Overview

ChainStream uses a Unit-based billing model. Different APIs consume different amounts of Units, and you can choose a plan that fits your business needs.

Billing Model

Plan Types

Free

$0 / month

30K Units/month
No overage
For development, POC

Starter

$199 / month

10M Units/month
Overage: $12.9/M
For small projects, MVP

Pro

$699 / month

50M Units/month
Overage: $9.9/M
For production, medium traffic

Enterprise

$1,699 / month

200M Units/month
Overage: $6.9/M
For large enterprises, high concurrency

Custom

Custom pricing

Custom Units quota
Custom overage rate
Private deployment, dedicated SLA

All plans will be blocked (return 403 error) when quota is exhausted. Paid plans can purchase additional quota in Dashboard to restore service.

Plan Selection Guide

Free — For Development & Testing

Use cases:

Local development and debugging
Feature validation and demos
Learning and evaluating ChainStream API

Typical usage estimate:

300 price queries per day → ~9,000 Units/month

Limitations:

Data may have 1-2 second delay
No SLA guarantee
Cannot continue calling after quota exhaustion

Starter — For Small Projects

Use cases:

Individual developer’s small dApps
Trading bot prototypes
Small market display websites

Typical usage estimate:

Market dashboard (10 tokens, refresh every minute) → ~43,200 Units/month
Small trading bot (1 query/second) → ~86,400 Units/month (single token)

Example scenario: Building a Solana token market website showing 20 popular tokens, refreshing every 30 seconds:

20 tokens × 2 times/min × 60 min × 24 hours × 30 days = 1,728,000 requests
At 1 Unit/request = 1,728,000 Units/month

This scenario recommends Pro plan.

Pro — For Production Environment

Use cases:

Small/medium exchange or wallet data needs
Professional trading tools
Businesses requiring KYT/KYA risk control

Typical usage estimate:

Medium market platform (100 tokens, real-time WebSocket) → ~500,000 Units/month
Deposit risk control (1000 KYT checks/day) → ~150,000 Units/month

Example scenario: Running a small exchange that needs:

Market data: 50 trading pairs, WebSocket real-time push
Deposit risk control: 500 deposits/day, each with KYT check

WebSocket: 50 × 0.1 Unit/message × 86400 sec × 30 days ≈ 12,960,000 messages = 1,296,000 Units
KYT: 500 × 5 Units × 30 days = 75,000 Units
Total: ~1,371,000 Units/month

This scenario recommends Pro plan + overage budget, or contact sales for Enterprise quote.

Enterprise — For Large Enterprises

Use cases:

Large exchanges
Institutional quantitative trading
Private deployment or custom SLA requirements

Includes:

Unlimited API calls
Dedicated technical support
Custom SLA (99.99%+)
Optional private deployment

Contact sales for pricing.

Units Calculation

What is a Unit

Unit is ChainStream’s billing unit. Different APIs consume different amounts of Units - more complex APIs consume more.

Data API Consumption

Unit costs are tiered by computational complexity. Simple lookups cost less; aggregation-heavy and on-chain execution endpoints cost more.

API	CU	Endpoint
Token Search	0.25	`GET /v2/token/search`
Token Detail	1.00	`GET /v2/token/{chain}/{tokenAddress}`
Batch Detail	0.75	`GET /v2/token/{chain}/multi`
Token Metadata	0.05	`GET /v2/token/{chain}/{tokenAddress}/metadata`
Batch Metadata	0.05	`GET /v2/token/{chain}/metadata/multi`
Token Price	0.10	`GET /v2/token/{chain}/{tokenAddress}/price`
Price History	0.10	`GET /v2/token/{chain}/{tokenAddress}/prices`
Market Data	0.10	`GET /v2/token/{chain}/{tokenAddress}/marketData`
Batch Market Data	0.10	`GET /v2/token/{chain}/marketData/multi`
Token Stats	2.50	`GET /v2/token/{chain}/{tokenAddress}/stats`
Batch Stats	2.50	`GET /v2/token/{chain}/stats/multi`
Candles (OHLCV)	0.25	`GET /v2/token/{chain}/{tokenAddress}/candles`
Pair Candles	0.25	`GET /v2/token/{chain}/pair/{pair}/candles`
Pool Candles	0.25	`GET /v2/token/{chain}/pool/{poolAddress}/candles`
Holders	0.50	`GET /v2/token/{chain}/{tokenAddress}/holders`
Batch Holders	0.50	`GET /v2/token/{chain}/{tokenAddress}/holders/multi`
Top Holders	0.50	`GET /v2/token/{chain}/{tokenAddress}/topHolders`
Pools	2.50	`GET /v2/token/{chain}/{tokenAddress}/pools`
Security	0.50	`GET /v2/token/{chain}/{tokenAddress}/security`
Creation Info	0.10	`GET /v2/token/{chain}/{tokenAddress}/creation`
Mint/Burn	0.50	`GET /v2/token/{chain}/{tokenAddress}/mintAndBurn`
Traders by Tag	0.50	`GET /v2/token/{chain}/{tokenAddress}/traders/{tag}`
Liquidity Snapshots	0.50	`GET /v2/token/{chain}/{tokenAddress}/liquiditySnapshots`
Token List	0.05	`GET /v2/token/{chain}/list`
Dev Tokens	0.50	`GET /v2/token/{chain}/dev/{devAddress}/tokens`
Transfer Total	0.25	`GET /v2/token/{chain}/{tokenAddress}/transfer-total`
Transfers	0.25	`GET /v2/token/{chain}/{tokenAddress}/transfers`

API	CU	Endpoint
Token Balances	1.00	`GET /v2/wallet/{chain}/{walletAddress}/tokens-balance`
Balance Updates	0.50	`GET /v2/wallet/{chain}/{walletAddress}/balance-updates`
PnL	1.00	`GET /v2/wallet/{chain}/{walletAddress}/pnl`
PnL by Token	1.00	`GET /v2/wallet/{chain}/{walletAddress}/pnl-by-token`
PnL Details	1.50	`GET /v2/wallet/{chain}/{walletAddress}/pnl-details`
Calculate PnL	1.50	`POST /v2/wallet/{chain}/{walletAddress}/calculate-pnl`
Net Worth	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth`
Net Worth Chart	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth-chart`
Net Worth Details	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth-details`
Net Worth Tokens	1.00	`GET /v2/wallet/{chain}/{walletAddress}/net-worth/tokens`
Transfers	0.25	`GET /v2/wallet/{chain}/{walletAddress}/transfers`
Transfer Total	0.25	`GET /v2/wallet/{chain}/{walletAddress}/transfer-total`
First Transaction	0.10	`GET /v2/wallet/{chain}/first-tx`
Net Worth Summary	1.00	`GET /v2/wallet/{chain}/net-worth-summary`
PnL by Wallet	1.00	`GET /v2/wallet/{chain}/pnl-by-wallet`
Add to Watchlist	0.05	`POST /v2/watchlist/{chain}/{walletAddress}`

API	CU	Endpoint
Trades	0.25	`GET /v2/trade/{chain}`
Activities	0.25	`GET /v2/trade/{chain}/activities`
Top Traders	0.50	`GET /v2/trade/{chain}/top-traders`
Gainers/Losers	0.50	`GET /v2/trade/{chain}/trader-gainers-losers`

API	CU	Endpoint
Pool Info	0.50	`GET /v2/dexpools/{chain}/{poolAddress}`
Pool Snapshots	0.50	`GET /v2/dexpools/{chain}/{poolAddress}/snapshots`

API	CU	Endpoint
Hot Tokens	0.25	`GET /v2/ranking/{chain}/hotTokens/{duration}`
New Tokens	0.25	`GET /v2/ranking/{chain}/newTokens`
Migrated Tokens	0.25	`GET /v2/ranking/{chain}/migrated`
Final Stretch	0.25	`GET /v2/ranking/{chain}/finalStretch`
Stock Tokens	0.25	`GET /v2/ranking/{chain}/stocks`

API	CU	Endpoint
Supported DEXs	0.05	`GET /v2/dex`
Quote	0.25	`GET /v2/dex/{chain}/quote`
Route	0.25	`POST /v2/dex/{chain}/route`
Token Creation	5.00	`POST /v2/dex/{chain}/create`
Execute Swap	5.00	`POST /v2/dex/{chain}/swap`
Job Status	0.05	`GET /v2/job/{id}`
Job Streaming	0.05	`GET /v2/job/{id}/streaming`

API	CU	Endpoint
Supported Chains	0.05	`GET /v2/blockchain`
Latest Block	0.05	`GET /v2/blockchain/{chain}/latest_block`
Gas Price	0.10	`GET /v2/transaction/{chain}/gas-price`
Gas Estimate	0.25	`POST /v2/transaction/{chain}/estimate-gas-limit`
Send Transaction	5.00	`POST /v2/transaction/{chain}/send`

API	CU	Endpoint
List Endpoints	0.05	`GET /v2/webhook/endpoint`
Create Endpoint	0.05	`POST /v2/webhook/endpoint`
Get Endpoint	0.05	`GET /v2/webhook/endpoint/{id}`
Update Endpoint	0.05	`PATCH /v2/webhook/endpoint`
Delete Endpoint	0.05	`DELETE /v2/webhook/endpoint/{id}`
Get Secret	0.05	`GET /v2/webhook/endpoint/{id}/secret`
Rotate Secret	0.10	`POST /v2/webhook/endpoint/{id}/secret/rotate`

API	CU	Endpoint
List Red Packets	0.05	`GET /v2/redpacket`
Get Red Packet	0.05	`GET /v2/redpacket/{id}`
Get Claims	0.05	`GET /v2/redpacket/{id}/claims`
Wallet Claims	0.05	`GET /v2/redpacket/wallet/{address}/claims`
Wallet Red Packets	0.05	`GET /v2/redpacket/wallet/{address}/redpackets`
Create Red Packet	5.00	`POST /v2/redpacket/{chain}/create`
Claim Red Packet	5.00	`POST /v2/redpacket/{chain}/claim`
Send Red Packet	5.00	`POST /v2/redpacket/{chain}/send`

CU Pricing Tiers

Tier	CU Cost	Description	Examples
Tier 1	0.05	Metadata, list, simple lookups	Token list, blockchain info, webhook CRUD, job status
Tier 2	0.10	Single-field queries	Price, market data, creation info, gas price
Tier 3	0.25	Search, trades, rankings, candles	Token search, OHLCV, trade activities, rankings
Tier 4	0.50	Holders, security, snapshots	Holders, security audit, pool snapshots, top traders
Tier 5	1.00	Full profile, PnL, net worth	Token detail, wallet PnL, net worth
Tier 6	1.50	Compute-heavy analytics	PnL details, calculate PnL
Tier 7	2.50	Aggregation-heavy	Token stats, pools (multi-source aggregation)
Tier 8	5.00	On-chain execution	Swap, token creation, send transaction

WebSocket Real-time Subscription Billing

WebSocket real-time data subscriptions are billed separately, charged by data bytes:

Item	Rate	Description
WebSocket Data	0.005 Unit/byte	Charged by push data bytes
WebSocket Connection	Free	No charge for establishing connection
Heartbeat Messages	Free	Heartbeat packets not charged

Supported Subscription Channels

Channel	Description
`dex-candle:{chain}_{tokenAddress}_{resolution}`	Real-time candle data

Channel	Description
`dex-token-stats:{chain}_{tokenAddress}`	Token statistics
`dex-token-holding:{chain}_{tokenAddress}`	Holder statistics
`dex-token-supply:{chain}_{tokenAddress}`	Supply and market cap
`dex-token-general-stat-num:{chain}_{tokenAddress}`	Liquidity stats
`dex-new-token:{chain}`	New token info
`dex-new-tokens-metadata:{chain}`	New token metadata

Channel	Description
`dex-ranking-list:{chain}_{ranking_type}`	Ranking token list
`dex-ranking-token-stats-list:{chain}_{channelType}`	Ranking token stats
`dex-ranking-token-holding-list:{chain}_{channelType}`	Ranking holder stats
`dex-ranking-token-supply-list:{chain}_{channelType}`	Ranking supply

Channel	Description
`dex-wallet-balance:{chain}_{walletAddress}`	Wallet balance
`dex-wallet-token-pnl:{chain}_{walletAddress}`	Token-level PnL
`dex-wallet-pnl-list:{chain}_{walletAddress}`	Wallet-level PnL

Channel	Description
`dex-trade:{chain}_{tokenAddress}`	Token trades
`dex-wallet-trade:{chain}_{walletAddress}`	Wallet trades

Channel	Description
`dex-pool-balance:{chain}_{poolAddress}`	Pool balance

WebSocket Usage Estimation Examples

Scenario: Monitor 10 tokens' real-time candles (1-minute resolution)

Calculation:
- Candle message ~200 bytes each
- Each token ~1 candle message per minute
- 10 tokens × 1 msg/min × 60 min × 24 hrs × 30 days = 432,000 messages
- Total data: 432,000 × 200 = 86,400,000 bytes
- Monthly: 86,400,000 × 0.005 = 432,000 Units

Scenario: Monitor 50 tokens' stats (real-time, ~1 update/second)

Calculation:
- Token stats message ~500 bytes each
- 50 tokens × 1 msg/sec × 86,400 sec × 30 days = 129,600,000 messages
- Total data: 129,600,000 × 500 = 64,800,000,000 bytes (~64.8 GB)
- Monthly: 64,800,000,000 × 0.005 = 324,000,000 Units (~324M)

Batch APIs typically have discounts. Refer to API Reference for exact consumption. WebSocket message frequency depends on market activity; high volatility periods will increase message volume.

KYT/KYA Service Billing

KYT/KYA APIs do not consume plan Units. They are charged from a separate KYT account balance (in USD). Please top up at Dashboard → KYT Service.

API	Cost	Endpoint
Register Transfer	$0.25/call	`POST /v2/kyt/transfer`
Register Withdrawal	$0.25/call	`POST /v2/kyt/withdrawal`
Register Address	$1.25/call	`POST /v2/kyt/address`
Query Risk / Alerts / Exposures	Included	`GET /v2/kyt/addresses//risk`, `GET /v2/kyt/transfers//summary`, etc.

Cost Estimation Examples

Market Display App
Trading Bot
Exchange Risk Control

Scenario: A DeFi market website showing 50 token prices, refreshing every 10 seconds

Calculation:
- Request frequency: 50 tokens × 6 times/min = 300 requests/min
- Monthly requests: 300 × 60 × 24 × 30 = 12,960,000 requests
- CU per request: 0.10 (Token Price endpoint)
- Monthly CU: 12,960,000 × 0.10 = 1,296,000 CU

Recommended: Starter plan (10M CU)

Scenario: An arbitrage bot monitoring 5 trading pairs, querying price every second

REST approach:
- 5 × 1/sec × 86,400 × 30 = 12,960,000 requests
- CU: 12,960,000 × 0.10 = 1,296,000 CU

WebSocket approach (recommended):
- 5 pairs × ~200 bytes/msg × 1 msg/sec × 86,400 × 30
- = 2,592,000,000 bytes × 0.005 CU/byte = 12,960,000 CU

Recommended: Pro plan for REST; Starter for WebSocket

Scenario: Small exchange, 1000 deposits/day requiring KYT check

Calculation:
- Daily: 1,000 KYT transfer registrations
- Monthly: 1,000 × 30 = 30,000 calls
- Cost: 30,000 × $0.25 = $7,500/month (KYT billed separately in USD)

Note: KYT does not consume plan CU. Top up KYT balance separately.

Quota Management

View Usage in Dashboard

Visit ChainStream Dashboard

View Usage

Check current month usage, remaining quota, and historical trends on the Usage page

Quota Alert Settings

You can set quota alerts to receive notifications when usage reaches thresholds:

Alert Level	Trigger Condition	Notification Method
Reminder	50% usage	Email
Warning	80% usage	Email + Dashboard alert
Critical	100% usage	Email + Dashboard alert

We recommend enabling at least the 80% alert to avoid unexpected service interruption.

Quota Exhaustion Handling

What Happens When Quota Runs Out

When monthly quota is exhausted, API will return 403 error and cannot continue to be called. Paid plan users can manually purchase additional quota to restore service.

Plan	Handling Method
Free	API returns 403 error, wait for next month’s quota reset
Starter / Pro / Enterprise	API returns 403 error, can purchase additional quota to restore service
Custom	Per contract terms

Purchase Additional Quota

Paid plan users can purchase additional quota in Dashboard, priced according to the plan’s overage rate:

Plan	Additional Quota Price
Starter	$12.9 / 1M Units
Pro	$9.9 / 1M Units
Enterprise	$6.9 / 1M Units

Service is interrupted immediately when quota is exhausted (returns 403 error). We recommend setting 80% usage alerts and purchasing additional quota in advance to avoid business impact.

Payment Methods

Supported Payment Methods

Method	Description	Applicable Plans
Credit Card	Visa, MasterCard, AMEX	All plans
Cryptocurrency	USDT, USDC (ERC-20 / TRC-20)	Starter and above
Bank Transfer	Contact sales	Enterprise

Billing Cycle

Monthly plans: Invoice generated on the 1st for the previous month
Annual plans: Get 2 months free (equivalent to 16.7% discount)

AI Agent Payment (x402 / MPP)

For AI agents that need programmatic access without dashboard signup, ChainStream supports two on-chain payment protocols:

x402 (Base / Solana USDC)

The x402 protocol enables HTTP-native micropayments. When an API call returns 402, the agent’s wallet signs a USDC transfer and retries — no account registration required.

Property	Value
Networks	Base (chain ID 8453), Solana
Currency	USDC
Standard	EIP-3009 (Base), native transfer (Solana)
Gas Fee	Free — ChainStream’s facilitator covers all gas costs

You only pay the subscription price in USDC. ChainStream operates its own x402 facilitator that submits the on-chain transaction and pays the gas fee on your behalf — the agent wallet does not need ETH or SOL for gas.

MPP (Tempo USDC.e)

MPP uses the Tempo network for payments. Gas is paid in USDC.e directly — no ETH needed.

Property	Value
Network	Tempo (chain ID 4217)
Currency	USDC.e

How It Works

Agent calls any ChainStream API
Server returns 402 (no active subscription)
Agent fetches available plans from /x402/pricing
Agent purchases a plan via x402 or MPP
Server returns an API Key — agent saves it for all future calls

x402 Payment Guide

Full details on x402 and MPP payment flows

FAQ

How do I choose the right plan?

We recommend starting with the Free plan to evaluate actual usage, then choose based on monthly consumption:

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

Can I upgrade/downgrade anytime?

Yes. Upgrades take effect immediately with prorated charges. Downgrades take effect in the next billing cycle.

Do unused quotas roll over?

No. Monthly quotas reset at the end of each month and do not roll over.

How do I get invoices?

Download historical invoices from Dashboard → Billing → Invoices. Enterprise customers can contact sales for custom invoices.

Next Steps

FAQ

Common questions

API Security

Understand API security configuration

API Reference

Start calling APIs

​Overview

​Billing Model

​Plan Types

Free

Starter

Pro

Enterprise

Custom

​Plan Selection Guide

​Units Calculation

​What is a Unit

​Data API Consumption

​CU Pricing Tiers

​WebSocket Real-time Subscription Billing

​Supported Subscription Channels

​WebSocket Usage Estimation Examples

​KYT/KYA Service Billing

​Cost Estimation Examples

​Quota Management

​View Usage in Dashboard

​Quota Alert Settings

​Quota Exhaustion Handling

​What Happens When Quota Runs Out

​Purchase Additional Quota

​Payment Methods

​Supported Payment Methods

​Billing Cycle

​AI Agent Payment (x402 / MPP)

​x402 (Base / Solana USDC)

​MPP (Tempo USDC.e)

​How It Works

x402 Payment Guide

​FAQ

​Next Steps

FAQ

API Security

API Reference

Overview

Billing Model

Plan Types

Plan Selection Guide

Units Calculation

What is a Unit

Data API Consumption

CU Pricing Tiers

WebSocket Real-time Subscription Billing

Supported Subscription Channels

WebSocket Usage Estimation Examples

KYT/KYA Service Billing

Cost Estimation Examples

Quota Management

View Usage in Dashboard

Quota Alert Settings

Quota Exhaustion Handling

What Happens When Quota Runs Out

Purchase Additional Quota

Payment Methods

Supported Payment Methods

Billing Cycle

AI Agent Payment (x402 / MPP)

x402 (Base / Solana USDC)

MPP (Tempo USDC.e)

How It Works

FAQ

Next Steps