Summary
A record is either a transaction (
txs), log (logs) or internal transactions (txsInternal) in the webhook response.Records is the base for usage of Streams
Records are only counted towards your usage for webhooks with
confirmed:trueso webhooks withconfirmed:falseare freeDecoded logs are also free they do NOT count as
Records.
What is the record?
A record is either a transaction (txs in response), log (logs in response) or internal transaction (txsInternal in response). The number of records in a webhook is the sum of txs + logs + txsInternal.
In the header of a webhook, you can find the total number of records in that webhook in the header x-records-charged.
In this example, the x-records-charged is 20 so the webhook contains 20 records.
headers: {
'x-region': 'us-west-2',
'x-queue-size': '0',
'x-records-charged': ‘20’
'x-signature': '0xdf49163b5273b50a8da48e82b7254b45d81aeee9a02f1909a45d7aaea240e9c2',
}Only confirmed blocks will be charged, unconfirmed blocks will have 'x-records-charged': ‘0’
Records Pricing
For each record you consume, your account will be charged 15 compute units. Each Moralis plan has a certain number of included compute units.
For each transaction, you will get two webhooks:
One once the transaction is added to a block
One once the transaction is confirmed
Records are only counted towards your usage for webhooks with the field confirmed:true. Webhooks set to with confirmed:false and decoded logs are both free of charge.
You can read the article Webhooks Transactions to understand more.
Check your total consumed record for a period
By using /status (see API reference) you will get a summary of totalLogsProcessed,totalTxsProcessed, and totalTxsInternalProcessed for your current billing period.
Example:
{ "totalWebhooksDelivered": 1288, "totalWebhooksFailed": 17, "totalLogsProcessed": 4257, "totalTxsProcessed": 0, "totalTxsInternalProcessed": 0 }
Where your total consumed records for the current billing period would be "totalLogsProcessed": 4257+"totalTxsProcessed": 0+"totalTxsInternalProcessed": 0. In this case total consumption is 4257.
Check the total records consumed by one stream for a period.
By using /stats/{streamId} (see API reference) you will get a summary of totalLogsProcessed,totalTxsProcessed, and totalTxsInternalProcessed for that specific stream.
Example:
{ "totalWebhooksDelivered": 0, "totalWebhooksFailed": 0, "totalLogsProcessed": 0, "totalTxsProcessed": 0, "totalTxsInternalProcessed": 0, "createdAt": "2022-10-25T08:21:00.877Z", "updatedAt": "2022-10-25T08:21:00.877Z" }
Where your total consumed records for the current billing period would betotalLogsProcessed+totalTxsProcessed+totalTxsInternalProcessed.
Records per transaction type
It depends on the selected address activity how many records will be charged
Contract Interactions (logs)
Native Transactions (txs)
Internal Transactions (txsInternal)
Description | Number of records* |
Stream with txs, logs and a erc20 transfer event is emitted | 2 |
Stream with txs, logs and 10 NFT Tokens (ERC721) were transferred in one transaction | 11 |
Stream with txs, logs and 30 NFT Tokens (ERC1155 Batch) were transferred in one transaction | 2 |
Stream with logs and a ERC721 NFT is minted with 100 Tokens | 100 |
Stream with txs and a native transfer takes place | 1 |
*The number of records for logs depends on the contract emitting the events, more complex contracts could emit more records
Decoded logs
Moralis will decode and enrich standardized contracts (ERC20/ERC721/ERC1155), for each log that matches one of those contracts, a decoded log will be generated, currently, the decoded logs are:
erc20Transfers
erc20Approvals
nftTransfers
Decoded logs are free they do NOT count as Records.