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 NameEndpointBase CU CostexpMax Batch Size
Token Multi Price/defi/multi_price30.8100
Account Detail Multiple/blockchain/v1/account/detail/multiple50.5100

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

API NameEndpointBase CU costn_max (Max Tokens per Batch)
Price (Multiple) GET & POST/defi/multi_price3100
Price - Volume (Multiple)/defi/price_volume/multi850
Token - Meta Data (Multiple)/defi/v3/token/meta-data/multiple550
Token - Trade Data (Multiple)/defi/v3/token/trade-data/multiple1220
Token - Market Data (Multiple)/defi/v3/token/market-data/multiple1020
Pair - Overview (Multiple)/defi/v3/pair/overview/multiple1520
All time - Trades (Multiple)/defi/v3/all-time/trades/multiple2520
Exit liquidity (Multiple)/defi/v3/token/exit-liquidity/multiple1550
Price stats (Multiple)/defi/v3/price/stats/multiple820
Wallet - PnL/wallet/v2/pnl/multiple1050
Wallet - Tokens Balance/wallet/v2/token-balance1050
Token - Latest liquidity/defi/v3/liquidity/latest/token5100
Wallet - PNL summary (multiple)/wallet/v2/net-worth-summary/multiple50100
Token - Holder List (Batch)/token/v1/holder/batch50500
Wallet - First Tx Funded/wallet/v2/tx/first-funded5050

n_max Table for Blockchain API

API NameEndpointBase CU costn_max (Max Tokens per Batch)
Account Detail Decoded/blockchain/v1/account/detail/multiple5100
Token Meta Data/blockchain/v1/token/metadata/multiple5100


Did this page help you?