| Endpoint | Type | Compute Units | Default Chains (no chain_ids) |
|---|---|---|---|
| Balances (EVM & SVM) | Chain-dependent | N compute units, where N is the number of chains processed in the chain_ids query parameter after tag expansion | |
| Balances (single token sub-path) | Fixed | 1 compute unit per request. Accepts exactly one chain_ids value (single chain only) | - |
| Collectibles | Chain-dependent | N compute units, where N is the number of chains processed in the chain_ids query parameter after tag expansion | |
| Activity | Fixed | 3 compute units per request | — |
| Transactions (EVM & SVM) | Fixed | 1 compute unit per request | — |
| Token Info | Fixed | 2 compute units per request, even though chain_ids is required | — |
| Token Holders | Fixed | 2 compute units per request | — |
How CUs work
For chain-dependent endpoints, CU equals the number of distinct chains the request processes. If you pass tags (likedefault, mainnet, or testnet) via chain_ids, we expand them to specific chains before computing CU. If you omit chain_ids in the Collectibles or Balances endpoints, the endpoint uses its default chain set. CU equals the size of that set at request time, currently for Balances and for Collectibles, and may change as Sim adds more chains.
For fixed endpoints, each request consumes exactly specified number of compute units regardless of how many chains you query or what parameters you provide.
Chain selection and tags
Chain count is computed after we expand any tags you pass. To keep CU predictable over time, specify explicitchain_ids (EVM). If you use tags like default or mainnet, we expand them to specific chains at request time. Tags can grow as we add more networks. Pin chains explicitly to keep CU stable. See Supported Chains.
Examples
Balances: explicit chains
Use
?chain_ids=1,8453,137 to process three chains. This consumes three CUs.Balances: default set
Omitting
chain_ids uses the endpoint’s chains tagged default. CU equals the size of that set at request time ( as of now, and subject to change). See Supported Chains.Balances: mainnet tag
Passing
?chain_ids=mainnet expands to all supported mainnet chains for the endpoint. CU equals the expanded chain count.Balances (single token sub-path): fixed cost
Each request consumes 1 CU and must specify exactly one chain via
chain_ids.Collectibles: default set
Omitting
chain_ids uses the endpoint’s chains tagged default. CU equals the size of that set at request time ( as of now, and subject to change).Activity: fixed cost
Activity uses a fixed-cost model. Each request consumes the same CU regardless of chains queried.
Token Info: fixed cost
Token Info is fixed-cost per request, even though
chain_ids is required. CU does not scale with the number of chains.FAQs
How do I estimate CU before making a request?
How do I estimate CU before making a request?
For chain-dependent endpoints, count the chains you include (after any tag expansion). For fixed-CU endpoints, see the table at the top of the page.
Does token filtering impact CU usage?
Does token filtering impact CU usage?
No. CU is based on chain count or a fixed per-request cost, not on token filtering. See Token Filtering.
Why did my CU change when I didn't pass chain_ids?
Why did my CU change when I didn't pass chain_ids?
If you omit
chain_ids for endpoints where it can be passed, we use the endpoint’s default chain set, which may grow as new chains are added. Pin explicit chains to keep CU stable.Where do I view my CU usage?
Where do I view my CU usage?
Visit your Sim Dashboard.