Batch Token CU Cost
Batch CU Cost
Formula:
Batch CU Cost = N^exp × Base CU Cost
Where:
- N: Batch number.
- exp: Batch multiplier exponent.
- 0.5 for Blockchain API endpoints.
- 0.8 for all other API groups.
- Base CU Cost: The CU cost of requesting a single token using the corresponding multiple-token endpoint (different from the CU cost of the single-token endpoint).
- The Batch CU Cost is rounded up to the nearest whole number (0 decimal places).
Examples
| API Name | Endpoint | Base CU Cost | exp | Max Batch Size |
|---|---|---|---|---|
| Token Multi Price | /defi/multi_price | 3 | 0.8 | 100 |
| Account Detail Multiple | /blockchain/v1/account/detail/multiple | 5 | 0.5 | 100 |
Example 1: DeFi API
Request N = 10 tokens using /defi/multi_price:
Batch CU Cost = 10^0.8 × 3 = 18.93 → 19 CU
Example 2: Blockchain API
Request N = 100 accounts using /blockchain/v1/account/detail/multiple:
Batch CU Cost = 100^0.5 × 5 = 10 × 5 = 50 CU
Notes
- Using a batch endpoint is always more cost-efficient than making the equivalent number of single-endpoint requests.
- Users should consider purchasing a Business plan to access batch endpoints.
- The larger the batch size (N), the greater the effective discount. However, each endpoint has a maximum supported batch size (
n_max), which must not be exceeded.
n_max Table for Each API
n_max Table for Each API| API Name | Endpoint | Base CU cost | n_max (Max Tokens per Batch) |
|---|---|---|---|
| Price (Multiple) GET & POST | /defi/multi_price | 3 | 100 |
| Price - Volume (Multiple) | /defi/price_volume/multi | 8 | 50 |
| Token - Meta Data (Multiple) | /defi/v3/token/meta-data/multiple | 5 | 50 |
| Token - Trade Data (Multiple) | /defi/v3/token/trade-data/multiple | 12 | 20 |
| Token - Market Data (Multiple) | /defi/v3/token/market-data/multiple | 10 | 20 |
| Pair - Overview (Multiple) | /defi/v3/pair/overview/multiple | 15 | 20 |
| All time - Trades (Multiple) | /defi/v3/all-time/trades/multiple | 25 | 20 |
| Exit liquidity (Multiple) | /defi/v3/token/exit-liquidity/multiple | 15 | 50 |
| Price stats (Multiple) | /defi/v3/price/stats/multiple | 8 | 20 |
| Wallet - PnL | /wallet/v2/pnl/multiple | 10 | 50 |
| Wallet - Tokens Balance | /wallet/v2/token-balance | 10 | 50 |
| Token - Latest liquidity | /defi/v3/liquidity/latest/token | 5 | 100 |
| Wallet - PNL summary (multiple) | /wallet/v2/net-worth-summary/multiple | 50 | 100 |
| Token - Holder List (Batch) | /token/v1/holder/batch | 50 | 500 |
| Wallet - First Tx Funded | /wallet/v2/tx/first-funded | 50 | 50 |
n_max Table for Blockchain API
n_max Table for Blockchain API| API Name | Endpoint | Base CU cost | n_max (Max Tokens per Batch) |
|---|---|---|---|
| Account Detail Decoded | /blockchain/v1/account/detail/multiple | 5 | 100 |
| Token Meta Data | /blockchain/v1/token/metadata/multiple | 5 | 100 |
Updated about 6 hours ago
Did this page help you?
