Skip to main content

Get statistics for mempool transactions

Queries for transactions counts, age (by block height), fees (simple average), and size. All results broken down by transaction type and percentiles (p25, p50, p75, p95).

Responses
200

Statistics for mempool transactions

Schema OPTIONAL
tx_type_counts object

Number of tranasction in the mempool, broken down by transaction type.

token_transfer number
smart_contract number
contract_call number
poison_microblock number
tx_simple_fee_averages object

The simple mean (average) transaction fee, broken down by transaction type. Note that this does not factor in actual execution costs. The average fee is not a reliable metric for calculating a fee for a new transaction.

token_transfer object
p25 number
p50 number
p75 number
p95 number
smart_contract object
p25 number
p50 number
p75 number
p95 number
contract_call object
p25 number
p50 number
p75 number
p95 number
poison_microblock object
p25 number
p50 number
p75 number
p95 number
tx_ages object

The average time (in blocks) that transactions have lived in the mempool. The start block height is simply the current chain-tip of when the attached Stacks node receives the transaction. This timing can be different across Stacks nodes / API instances due to propagation timing differences in the p2p network.

token_transfer object
p25 number
p50 number
p75 number
p95 number
smart_contract object
p25 number
p50 number
p75 number
p95 number
contract_call object
p25 number
p50 number
p75 number
p95 number
poison_microblock object
p25 number
p50 number
p75 number
p95 number
tx_byte_sizes object

The average byte size of transactions in the mempool, broken down by transaction type.

token_transfer object
p25 number
p50 number
p75 number
p95 number
smart_contract object
p25 number
p50 number
p75 number
p95 number
contract_call object
p25 number
p50 number
p75 number
p95 number
poison_microblock object
p25 number
p50 number
p75 number
p95 number