> ## 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. # Billing and Units > Understanding ChainStream's billing model and quota management ## 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 **\$0 / month** * 30K Units/month * No overage * For development, POC **\$199 / month** * 10M Units/month * Overage: \$12.9/M * For small projects, MVP **\$699 / month** * 50M Units/month * Overage: \$9.9/M * For production, medium traffic **\$1,699 / month** * 200M Units/month * Overage: \$6.9/M * For large enterprises, high concurrency **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 **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 **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. **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. **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 **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](https://www.chainstream.io/dashboard) 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](https://www.x402.org/) 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 1. Agent calls any ChainStream API 2. Server returns 402 (no active subscription) 3. Agent fetches available plans from `/x402/pricing` 4. Agent purchases a plan via x402 or MPP 5. Server returns an **API Key** — agent saves it for all future calls Full details on x402 and MPP payment flows *** ## FAQ 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 Yes. Upgrades take effect immediately with prorated charges. Downgrades take effect in the next billing cycle. No. Monthly quotas reset at the end of each month and do not roll over. Download historical invoices from Dashboard → Billing → Invoices. Enterprise customers can contact sales for custom invoices. *** ## Next Steps Common questions Understand API security configuration Start calling APIs