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 is a measure of the requests needed to query computationally expensive API endpoints. Each request has both price and rate limit cost that are measured in terms of compute units. 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.

Price

Request price refers to the amount of compute units that will be calculated towards your API usage billing.

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 1 CU. If we wanted to fetch the balances of 5 addresses at once, then the CU cost for that particular call would be 5 CU.

Rate limit Cost

On the other hand, request rate limit cost refers to the amount of compute units that an API request cost in terms of rate limits.

Name	Path	Price		Rate Limit Cost
		Base	Additional
getBlock	/block/{block_number_or_hash}	100	0	20
getContractEvents	/{address}/events	20	0	20
getTransaction	/transaction/{transaction_hash}	10	0	10
getTransactions	/{address}	30	0	20
getTransactionVerbose	/transaction/{transaction_hash}/verbose	20	0	10
getMultipleNFTs	/nft/getMultipleNFTs	150	0	20
getTransactionsVerbose	/{address}/verbose	50	0	20
getInternalTransactions	/transaction/{transaction_hash}/internal-transactions	20	0	10
getNativeBalance	/{address}/balance	10	0	10
getNativeBalancesForAddresses	/wallets/balances	10	+10 CUs per wallet addresses	10
getWalletTokenBalances	/{address}/erc20	100	0	20
getWalletTokenBalancesPrice	/{address}/tokens	100	0	20
getDefiSummary	/wallets/{address}/defi/summary	50	0	20
getDefiPositionsByProtocol	/wallets/:address/defi/:protocol/positions	15	0	10
getDefiPositionsSummary	/wallets/{address}/defi/positions	50	0	20
getWalletProfitabilitySummary	/wallets/{address}/profitability/summary	30	0	20
getWalletProfitability	/wallets/{address}/profitability	50	0	20
getWalletApprovals	/wallets/{address}/approvals	100	0	20
searchEntities	/entities/search	50	0	20
getEntity	/entities/{entityId}	50	0	20
getEntityCategories	/entities/categories	10	0	20
getEntitiesByCategory	/entities/categories/{categoryId}	50	0	20
getTokenTransfers	/{address}/erc20/transfers	50	0	20
getTokenAddressTransfers	/erc20/{address}/transfers	50	0	20
getTopProfitableWalletPerToken	/erc20/{address}/top-gainers	50	0	50
getNFTs	/{address}/nft	50	0	20
getNFTTransfers	/{address}/nft/transfers	50	0	20
getNftTransfersByBlock	/block/{block_number_or_hash}/nft/transfers	20	0	20
getTokenMetadata	/erc20/metadata	10	0	20
web3ApiVersion	/web3/version	1	0	1
getTokenMetadataBySymbol	/erc20/metadata/symbols	10	0	10
getTokenPrice	/erc20/{address}/price	50	0	20
getMultipleTokenPrices	/erc20/prices	100	0	20
getTokenAllowance	/erc20/{address}/allowance	10	0	20
getAllTokenIds	/nft/{address}	50	0	20
getContractNFTTransfers	/nft/{address}/transfers	50	0	20
getWalletNFTCollections	/nft/{address}/collections	50	0	20
getNFTOwners	/nft/{address}/owners	50	0	20
getNFTMetadata	/nft/{address}/metadata	50	0	20
syncNFTContract	/nft/{address}/sync	50	0	50
reSyncMetadata	/nft/{address}/{token_id}/metadata/resync	50	0	50
getTokenIdMetadata	/nft/{address}/{token_id}	20	0	20
getTokenIdOwners	/nft/{address}/{token_id}/owners	50	0	20
getWalletTokenIdTransfers	/nft/{address}/{token_id}/transfers	20	0	20
getNFTTraitsByCollection	/nft/{address}/traits	50	0	20
getNFTTraitsByCollectionPaginate	/nft/{address}/nfts-by-traits	10	0	10
resyncNFTRarity	/nft/{address}/traits/resync	10	0	10
getNFTByContractTraits	/nft/{address}/nfts-by-traits	50	0	20
resolveDomain	/resolve/{domain}	10	0	10
resolveAddressToDomain	/resolve/{address}/domain	10	0	10
resolveENSDomain	/resolve/ens/{domain}	10	0	10
resolveAddress	/resolve/{address}/reverse	10	0	10
getPairReserves	/{pair_address}/reserves	10	0	10
getLogsByAddress	/{address}/logs	20	0	20
getNftTransfersFromToBlock	/nft/transfers	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
getNFTLowestPrice	/nft/{address}/lowestprice	40	0	20
getNFTContractSalePrices	/nft/{address}/price	30	0	30
getNFTSalePrices	/nft/{address}/{token_id}/price	30	0	30
getWalletActiveChains	/wallets/{address}/chains	50	+50 CUs per chains	50
getTopERC20TokensByMarketCap	/market-data/erc20s/top-tokens	200	0	20
getTopERC20TokensByPriceMovers	/market-data/erc20s/top-movers	200	0	20
getTopNFTCollectionsByMarketCap	/market-data/nfts/top-collections	200	0	20
getHottestNFTCollectionsByTradingVolume	/market-data/nfts/hottest-collections	200	0	20
contractsReview	/contracts-review	1	0	10
endpointWeights	/info/endpointWeights	1	0	10
getWalletStats	/wallets/{address}/stats	50	0	50
getNFTCollectionStats	/nft/{address}/stats	50	0	50
getNFTTokenStats	/nft/{address}/{token_id}/stats	50	0	50
getTokenOwners	/erc20/{token_address}/owners	50	0	20
getTokenStats	/erc20/{address}/stats	50	0	50
getBlockStats	/block/{block_number_or_hash}/stats	50	0	50
getLatestBlockNumber	/latestBlockNumber/{chain}	10	0	10
getWalletNetWorth	/wallets/{address}/net-worth	500	+500 CUs per chains	50
getWalletHistory	/wallets/{address}/history	150	0	30

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}	5
include=internal_transactions on /transaction/{transaction_hash}	3
include=internal_transactions on /block/{block_number_or_hash}	10
media_items=true	2
include=percent_change on /erc20/prices	5

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": 5,
    "rateLimitCost": 5
  },
  {
    "endpoint": "getContractEvents",
    "path": "/{address}/events",
    "price": 2,
    "rateLimitCost": 2
  },
  {
    "endpoint": "getTransactions",
    "path": "/transaction/{transaction_hash}",
    "price": 1,
    "rateLimitCost": 3
  }
]

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.