EVM Compute Units

All Moralis plans have generous limits on the number of requests you can make per month. How many included requests you have depends on the plan you have, check the pricing page for more details.

Some requests are more expensive than others. By giving some heavy requests higher weight, we ensure that you only pay for what you use and not a cent more.

This allows you to get cheaper requests for most use cases while protecting our systems from abuse by weighing the computationally expensive endpoints.

What is a Compute Unit (CU)?

A Compute Unit (CU) measures the computational complexity of a specific API request. Each API request carries a corresponding CU weight. For instance, simple endpoints like getNativeBalance have a low computational load, whereas more complex ones like getWalletNetworth, which fetches native balance, ERC20 balances, and prices across various chains, are more resource-intensive and therefore carry a higher CU.

Each request has both price and rate limit cost that are measured in terms of compute units. The rate limit cost of an API request is what contributes towards your CU/s throughput.

It is also important to note that some API will have dynamic pricing that will cost more CU the more inputs you add for the request.

CU Price

Request price denotes the number of compute units (CUs) counted towards your monthly or daily API usage billing. This means that the CU cost of an API endpoint will be subtracted from the limits defined by your plan. For instance, the free plan offers 40,000 CUs per day, while paid plans provide 100,000,000 CUs per month or more. If usage exceeds the allocated CUs on a paid plan, overage charges apply, determined by the excess CUs consumed.

CU Rate Limit Cost

CUs also play a crucial role in regulating the frequency of API requests through rate limits. Rate limit costs help manage your "API health" by preventing system overload caused by an excessive number of requests within a short timeframe.

Each API request is assigned two weights:

1. CU price, which contributes to billing as discussed earlier
2. Rate Limit CU Cost, which determines the frequency of calls to an endpoint and contributes to the CU/second throughput of your plan

tip

When you're setting up a function call, remember to factor in the query parameters as well! These can sometimes add to the CU cost. To stay on top of it, always check the individual query parameter costs in the query parameters table to have a clear picture of the total CU cost your call will incur. This way, you can make well-informed decisions and prevent any unexpected surprises in your CU usage.

By taking a moment to consult the table before making a call, you can avoid unexpected CU charges and keep your API interactions smooth and efficient.

Compute Units and Rate Limit prices

Name	Path	Price		Rate Limit Cost
		Base	Additional
endpointWeights	/info/endpointWeights	1	0	10
getAggregatedTokenPairStats	/pairs/{address}/stats	50	0	20
getBlock	/block/{block_number_or_hash}	100	0	20
getBondingTokensByExchange	/token/{exchange}/bonding	1	0	20
getCandleSticks	/pairs/:address/ohlcv	150	0	50
getContractNFTs	/nft/{address}	50	0	20
getDateToBlock	/block/dateToBlock	1	0	20
getDefiPositionsByProtocol	/wallets/:address/defi/:protocol/positions	15	0	10
getDefiPositionsSummary	/wallets/{address}/defi/positions	50	0	20
getDefiSummary	/wallets/{address}/defi/summary	50	0	20
getDiscoveryToken	/discovery/token	50	0	50
getEntitiesByCategory	/entities/categories/{categoryId}	50	0	20
getEntity	/entities/{entityId}	50	0	20
getEntityCategories	/entities/categories	10	0	20
getFilteredTokens	/discovery/tokens	250	0	50
getGraduatedTokensByExchange	/token/{exchange}/graduated	1	0	20
getHistoricalTokenHolders	/erc20/:tokenAddress/holders/historical	50	0	20
getLatestBlockNumber	/latestBlockNumber/{chain}	10	0	10
getMultipleNFTs	/nft/getMultipleNFTs	150	0	20
getMultipleTokenAnalytics	/tokens/analytics	150	0	50
getMultipleTokenPrices	/erc20/prices	100	0	20
getNativeBalance	/{address}/balance	10	0	10
getNativeBalancesForAddresses	/wallets/balances	10	+10 CUs per wallet addresses	10
getNewTokensByExchange	/token/{exchange}/new	1	0	20
getNFTBulkContractMetadata	/nft/metadata	5	0	20
getNFTByContractTraits	/nft/{address}/nfts-by-traits	50	0	20
getNFTCollectionStats	/nft/{address}/stats	50	0	50
getNFTContractMetadata	/nft/{address}/metadata	50	0	20
getNFTContractSalePrices	/nft/{address}/price	1	0	30
getNFTContractTransfers	/nft/{address}/transfers	50	0	20
getNFTFloorPriceByContract	/nft/{address}/floor-price	30	0	20
getNFTFloorPriceByToken	/nft/{address}/{token_id}/floor-price	30	0	20
getNFTHistoricalFloorPriceByContract	/nft/{address}/floor-price/historical	50	0	20
getNFTMetadata	/nft/{address}/metadata	20	0	20
getNFTs	/{address}/nft	10	0	20
getNFTSalePrices	/nft/{address}/{token_id}/price	30	0	30
getNFTTokenIdOwners	/nft/{address}/{token_id}/owners	50	0	20
getNFTTrades	/nft/{address}/trades	40	0	20
getNFTTradesByToken	/nft/{address}/{token_id}/trades	40	0	20
getNFTTradesByWallet	/wallets/{address}/nfts/trades	40	0	20
getNFTTraitsByCollection	/nft/{address}/traits	50	0	20
getNFTTraitsByCollectionPaginate	/nft/{address}/nfts-by-traits	10	0	10
getNFTTransfers	/{address}/nft/transfers	20	0	20
getPairAddress	/pairs/{address}/address	1	0	20
getPairCandlesticks	/pairs/{address}/ohlcv	150	0	20
getPairReserves	/{pair_address}/reserves	10	0	10
getPairStats	/pairs/:address/stats	100	0	20
getSnipersByPairAddress	/pair/:address/snipers	50	0	20
getSwapsByPairAddress	/pair/:address/swaps	50	0	20
getSwapsByTokenAddress	/erc20/:address/swaps	50	0	20
getSwapsByWalletAddress	/wallets/:address/swaps	50	0	20
getTimeSeriesTokenAnalytics	/tokens/analytics/timeseries	200	0	20
getTimeSeriesVolume	/volume/timeseries	150	0	20
getTimeSeriesVolumeByCategory	/volume/timeseries/{category}	150	0	20
getTokenAnalytics	/tokens/:tokenAddress/analytics	80	0	50
getTokenBondingStatus	/token/{address}/bonding-status	1	0	20
getTokenHolders	/erc20/:token_address/owners	50	0	20
getTokenMetadata	/erc20/metadata	10	0	20
getTokenMetadataBySymbol	/erc20/metadata/symbols	10	0	10
getTokenOwners	/erc20/{address}/owners	50	0	20
getTokenPairs	/erc20/{address}/pairs	50	0	20
getTokenPrice	/erc20/{address}/price	50	0	20
getTokenStats	/erc20/{address}/stats	50	0	50
getTokenTransfers	/{address}/erc20/transfers	50	0	20
getTopGainersTokens	/discovery/tokens/top-gainers	250	0	250
getTopLosersTokens	/discovery/tokens/top-losers	250	0	250
getTopProfitableWalletPerToken	/erc20/{address}/top-gainers	50	0	50
getTransaction	/transaction/{transaction_hash}	10	0	10
getTransactionVerbose	/transaction/{transaction_hash}/verbose	20	0	10
getTrendingTokens	/discovery/tokens/trending	150	0	250
getUniqueOwnersByCollection	/nft/{address}/owners	50	0	20
getVolumeStatsByCategory	/volume/categories	150	0	20
getVolumeStatsByChain	/volume/chains	150	0	20
getWalletActiveChains	/wallets/{address}/chains	50	+50 CUs per chains	50
getWalletHistory	/wallets/{address}/history	150	0	30
getWalletNetWorth	/wallets/{address}/net-worth	250	+250 CUs per chains	50
getWalletNFTCollections	/nft/{address}/collections	50	0	20
getWalletNFTs	/{address}/nft	50	0	20
getWalletNFTTransfers	/{address}/nft/transfers	50	0	20
getWalletProfitability	/wallets/{address}/profitability	50	0	20
getWalletProfitabilitySummary	/wallets/{address}/profitability/summary	30	0	20
getWalletStats	/wallets/{address}/stats	50	0	50
getWalletTokenApprovals	/wallets/{address}/approvals	100	0	20
getWalletTokenBalances	/{address}/erc20	100	0	20
getWalletTokenBalancesPrice	/{address}/tokens	100	0	20
getWalletTokenTransfers	/{address}/erc20/transfers	50	0	20
getWalletTransactions	/{address}	30	0	20
getWalletTransactionsVerbose	/{address}/verbose	50	0	20
resolveAddress	/resolve/{address}/reverse	10	0	10
resolveAddressToDomain	/resolve/{address}/domain	10	0	10
resolveDomain	/resolve/{domain}	10	0	10
resolveENSDomain	/resolve/ens/{domain}	10	0	10
reSyncMetadata	/nft/{address}/{token_id}/metadata/resync	50	0	50
resyncNFTTrait	/nft/{address}/traits/resync	10	0	10
searchEntities	/entities/search	50	0	20
searchTokens	/tokens/search	150	0	50
syncNFTContract	/nft/{address}/sync	50	0	50
web3ApiVersion	/web3/version	10	0	1

Dynamic Prices

Some endpoints have a dynamically priced CU cost based on the number of resources being requested. The more resources being requested, the higher the CU cost for that particular request. Taking getNativeBalancesForAddresses as an example; the base CU cost of this endpoint when fetching the balance of a single address is 10 CU. If we wanted to fetch the balances of 5 addresses at once, then the CU cost for that particular call would be 50 CU.

Query Parameters

In addition to having compute units charged on each API request, there are additional query parameters that cost additional compute units when added to an API request.

Query parameter	CU Cost
include=internal_transactions on /{address}	50
include=internal_transactions on /transaction/{transaction_hash}	30
include=internal_transactions on /block/{block_number_or_hash}	100

How to Check Compute Units?

To check the latest compute units of our API offerings, you can use endpointWeights to do so.

index.js (JavaScript)

const Moralis = require("moralis").default;

await Moralis.start({
  apiKey: "YOUR_API_KEY",
  // ...and any other configuration
});

const response = await Moralis.EvmApi.utils.endpointWeights();

console.log(response?.toJSON());

index.ts (TypeScript)

import Moralis from "moralis";

await Moralis.start({
  apiKey: "YOUR_API_KEY",
  // ...and any other configuration
});

const response = await Moralis.EvmApi.utils.web3ApiVersion();

console.log(response?.toJSON());

Your output for the API request will be as follows:

[
  {
    "endpoint": "getBlock",
    "path": "/block/{block_number_or_hash}",
    "price": 100,
    "rateLimitCost": 20
  },
  {
    "endpoint": "getContractEvents",
    "path": "/{address}/events",
    "price": 20,
    "rateLimitCost": 20
  },
  {
    "endpoint": "getTransaction",
    "path": "/transaction/{transaction_hash}",
    "price": 10,
    "rateLimitCost": 10
  }
]

where price refers to how much CU does the API request cost in terms of billing and rateLimitCost refers to how much CU does the API request cost in terms of rate limits.

Streams and Compute Units

For Moralis Streams, it is important to note that each record has a fixed cost of 10 Compute Units.

tip

You can read the article Records and Pricing to understand how records play a crucial role in the Streams API, allowing you to make the right decisions regarding usage and pricing.