Skip to main content

getFeeStats

Statistics for charged inclusion fees. The inclusion fee statistics are calculated from the inclusion fees that were paid for the transactions to be included onto the ledger. For Soroban transactions and Stellar transactions, they each have their own inclusion fees and own surge pricing. Inclusion fees are used to prevent spam and prioritize transactions during network traffic surge.

Params

(0)

Result

(getFeeStatsResult)
sorobanInclusionFee
object

Inclusion fee distribution statistics for Soroban transactions

max
string

Maximum fee

min
string

Minimum fee

mode
string

Fee value which occurs the most often

p10
string

10th nearest-rank fee percentile

p20
string

20th nearest-rank fee percentile

p30
string

30th nearest-rank fee percentile

p40
string

40th nearest-rank fee percentile

p50
string

50th nearest-rank fee percentile

p60
string

60th nearest-rank fee percentile

p70
string

70th nearest-rank fee percentile

p80
string

80th nearest-rank fee percentile

p90
string

90th nearest-rank fee percentile.

p95
string

95th nearest-rank fee percentile.

p99
string

99th nearest-rank fee percentile

transactionCount
number

How many transactions are part of the distribution

ledgerCount
number

How many consecutive ledgers form the distribution

inclusionFee
object

Fee distribution statistics for Stellar (i.e. non-Soroban) transactions. Statistics are normalized per operation.

max
string

Maximum fee

min
string

Minimum fee

mode
string

Fee value which occurs the most often

p10
string

10th nearest-rank fee percentile

p20
string

20th nearest-rank fee percentile

p30
string

30th nearest-rank fee percentile

p40
string

40th nearest-rank fee percentile

p50
string

50th nearest-rank fee percentile

p60
string

60th nearest-rank fee percentile

p70
string

70th nearest-rank fee percentile

p80
string

80th nearest-rank fee percentile

p90
string

90th nearest-rank fee percentile.

p95
string

95th nearest-rank fee percentile.

p99
string

99th nearest-rank fee percentile

transactionCount
number

How many transactions are part of the distribution

ledgerCount
number

How many consecutive ledgers form the distribution

latestLedger
number

The sequence number of the latest ledger known to Soroban RPC at the time it handled the request.

Example

Example request to the getFeeStats method

Request

curl -X POST \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc": "2.0",
"id": 8675309,
"method": "getFeeStats"
}' \
https://soroban-testnet.stellar.org | jq

Result

{
"jsonrpc": "2.0",
"id": 8675309,
"result": {
"sorobanInclusionFee": {
"max": "210",
"min": "100",
"mode": "100",
"p10": "100",
"p20": "100",
"p30": "100",
"p40": "100",
"p50": "100",
"p60": "100",
"p70": "100",
"p80": "100",
"p90": "120",
"p95": "190",
"p99": "200",
"transactionCount": "10",
"ledgerCount": 50
},
"inclusionFee": {
"max": "100",
"min": "100",
"mode": "100",
"p10": "100",
"p20": "100",
"p30": "100",
"p40": "100",
"p50": "100",
"p60": "100",
"p70": "100",
"p80": "100",
"p90": "100",
"p95": "100",
"p99": "100",
"transactionCount": "7",
"ledgerCount": 10
},
"latestLedger": 4519945
}
}