Rate limiting is managed through a weighted scoring system, known as Compute Units (CUs). Each API request consumes a specified number of CUs, determined by the complexity of the request. This system is designed to accommodate basic requests while efficiently handling more computationally intensive operations.

Rate Limit Tiers

The maximum CUs (rate-limiting score) for a user depends on their subscription level and is delineated in the following table:

Subscription LevelPer Minute Limit (CUs)Per Day Limit (CUs)
Free8,0001,200,000

We are working on new subscription tiers with higher rate limits to support even greater request volumes.

Rate Limit Categories

The CUs for each category are defined in the following table:

WeightCU Value
Free1
Small20
Medium100
Large500
XL1000
XXL3000

Rate Limits for Metrics Endpoints

The CUs for each route are defined in the table below:

EndpointMethodWeightCU Value
/v2/health-checkGETFree1
/v2/chainsGETFree1
/v2/chains/{chainId}GETFree1
/v2/chains/{chainId}/metrics/{metric}GETMedium100
/v2/chains/{chainId}/teleporterMetrics/{metric}GETMedium100
/v2/chains/{chainId}/rollingWindowMetrics/{metric}GETMedium100
/v2/networks/{network}/metrics/{metric}GETMedium100
/v2/chains/{chainId}/contracts/{address}/nfts:listHoldersGETLarge500
/v2/chains/{chainId}/contracts/{address}/balancesGETXL1000
/v2/chains/43114/btcb/bridged:getAddressesGETLarge500
/v2/subnets/{subnetId}/validators:getAddressesGETLarge500
/v2/lookingGlass/compositeQueryPOSTXXL3000
All rate limits, weights, and CU values are subject to change.