Skip to main content

Credit costs

The following tables outline the credit costs associated with various RPC methods across different networks. The credit calculation logic is designed to ensure accurate and fair pricing based on the specific network and method being used.

important

Requests for archive data (older than 128 blocks) currently cost the same as non-archive data, but this might change in the near future.

The process used to determine the credit cost for each request is as follows:

  1. Initial check for a specific credit value - When you make a request, the system first checks if there is a specific credit value assigned for the network and method used. This ensures that any unique resource requirements or costs associated with a particular network are accurately reflected.

  2. Fallback to the Ethereum method's credit value - If no specific credit value is found for the network, the system applies the Ethereum method's credit value. Ethereum serves as the baseline for pricing core RPC methods.

  3. Fallback to the default credit value - If the method is not found in the Ethereum table either, the system applies a default credit value. Initially set to 80 credits, this default value ensures all requests are accounted for, even if specific pricing information is not available.

Error code costs

When making requests that return status code errors, some errors count towards your credit usage.

  • 429 errors: These are not charged and can occur for the following reasons:

    • Key settings credit limit caps: These are limits set per API key.
    • Credit quota limit caps: These are overall credit usage limits.
    • Credit throughput limit caps: These are limits on the rate or throughput of requests.
  • 4xx errors: These are errors caused by human input, and consume 5 credits.

  • 5xx errors: These are server errors, and do not consume any credit charges.

Ethereum

The Ethereum methods serve as a baseline for pricing RPC methods. If a credit cost is not available for a specific network, then use the default Ethereum method's credit cost.

Standard Ethereum-compliant JSON-RPC methods

RPC methodCredit cost
eth_accounts80
eth_blobBaseFee300
eth_blockNumber80
eth_call80
eth_chainId5
eth_createAccessList80
eth_estimateGas300
eth_feeHistory80
eth_gasPrice80
eth_getBalance80
eth_getBlockByHash80
eth_getBlockByNumber80
eth_getBlockReceipts1000
eth_getBlockTransactionCountByHash150
eth_getBlockTransactionCountByNumber150
eth_getCode80
eth_getLogs255
eth_getProof150
eth_getStorageAt80
eth_getTransactionByBlockHashAndIndex150
eth_getTransactionByBlockNumberAndIndex150
eth_getTransactionByHash80
eth_getTransactionCount80
eth_getTransactionReceipt80
eth_getUncleByBlockHashAndIndex150
eth_getUncleByBlockNumberAndIndex150
eth_getUncleCountByBlockHash150
eth_getUncleCountByBlockNumber150
eth_getWork80
eth_hashrate5
eth_maxPriorityFeePerGas80
eth_mining5
eth_protocolVersion5
eth_sendRawTransaction80
eth_sign80
eth_submitWork80
eth_subscribe5
eth_syncing5
eth_unsubscribe10
net_listening5
net_peerCount80
net_version5
web3_clientVersion80

Trace methods

RPC methodCredit cost
trace_block300
trace_call300
trace_callMany300
trace_filter300
trace_transaction300

Filter methods

RPC methodCredit cost
eth_getFilterChanges140
eth_getFilterLogs255
eth_newBlockFilter80
eth_newFilter80
eth_uninstallFilter80

Debug methods

RPC methodCredit cost
debug_storageRangeAt1000
debug_traceBlock1000
debug_traceBlockByHash1000
debug_traceBlockByNumber1000
debug_traceCall1000
debug_traceTransaction1000

Subscription events

You can subscribe and unsubscribe to events using eth_subscribe and eth_unsubscribe.

The credit costs for the logs and newHeads events are charged per block, whereas newPendingTransaction events are charged at approximately one second intervals.

Subscription eventsCredit cost
logs300
newHeads50
newPendingTransaction200

Linea

RPC methodCredit cost
linea_estimateGas100

Polygon

RPC methodCredit cost
bor_getAuthor80
bor_getCurrentProposer80
bor_getCurrentValidators80
bor_getRootHash80
bor_getSignersAtHash80

Starknet

RPC MethodCredit cost
starknet_addDeclareTransaction700
starknet_addDeployAccountTransaction700
starknet_addInvokeTransaction700
starknet_blockHashAndNumber80
starknet_blockNumber80
starknet_call80
starknet_chainId5
starknet_estimateFee240
starknet_getBlockTransactionCount80
starknet_getBlockWithTxHashes80
starknet_getBlockWithTxs80
starknet_getClass80
starknet_getClassAt80
starknet_getClassHashAt80
starknet_getEvents200
starknet_getNonce80
starknet_getStateUpdate80
starknet_getStorageAt80
starknet_getTransactionByBlockIdAndIndex80
starknet_getTransactionByHash80
starknet_getTransactionReceipt80
starknet_pendingTransactions160
starknet_simulateTransactions160
starknet_specVersion5
starknet_syncing5

ZKsync Era

RPC methodCredit cost
zks_estimateFee80
zks_estimateGasL1ToL280
zks_getAllAccountBalances80
zks_getBlockDetails80
zks_getBridgeContracts80
zks_getBytecodeByHash80
zks_getL1BatchBlockRange80
zks_getL1BatchDetails80
zks_getL2ToL1LogProof80
zks_getL2ToL1MsgProof80
zks_getMainContract80
zks_getProof80
zks_getRawBlockTransactions80
zks_getTestnetPaymaster80
zks_getTransactionDetails80
zks_L1BatchNumber80
zks_L1ChainId80

Gas API

API endpointCredit cost
baseFeeHistory80
baseFeePercentile80
busyThreshold80
suggestedGasFees80