recommendation
Tiered priority-fee recommendations.
Suggested compute-unit price, fee, and limit across six urgency tiers, each with expected landing rank and inclusion probability. Built on the fast sub-minute windows for real-time fee setting.
Try it
Sign in to run live
- Change wallet
Parameters
Aggregation window. One of: 1s, 10s, 30s, 1m, 3m, 5m, 15m.
Maximum data points (1-1000, default 1). Query only; ignored when streaming.
Request
curl -X POST https://rpc.raptor.trade \
-H "Authorization: Bearer $RAPTOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "solana::priorityfee::recommendation",
"params": {
"window": "1m"
}
}'Response
Responses are always a JSON array - one entry per request - and each entry's result holds the array of data. The shape is identical over HTTP and WebSocket.
[
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"id": 1024,
"timestamp": "2026-06-01T02:16:22.000000000Z",
"window_duration": "PT1M",
"window_start": "2026-06-01T02:16:22.000000000Z",
"window_end": "2026-06-01T02:16:22.000000000Z",
"tx_count": "37",
"no_priority_tx_count": "37",
"total_tx_count": "37",
"data_points": "37",
"is_valid": true,
"min_price": "37",
"min_fee": "37",
"min_cu_limit": "37",
"min_landing_rank_pct": "0.00001942",
"min_landing_inclusion_pct": "0.00001942",
"low_price": "37",
"low_fee": "37",
"low_cu_limit": "37",
"low_landing_rank_pct": "0.00001942",
"low_landing_inclusion_pct": "0.00001942",
"medium_price": "37",
"medium_fee": "37",
"medium_cu_limit": "37",
"medium_landing_rank_pct": "0.00001942",
"medium_landing_inclusion_pct": "0.00001942",
"high_price": "37",
"high_fee": "37",
"high_cu_limit": "37",
"high_landing_rank_pct": "0.00001942",
"high_landing_inclusion_pct": "0.00001942",
"very_high_price": "37",
"very_high_fee": "37",
"very_high_cu_limit": "37",
"very_high_landing_rank_pct": "0.00001942",
"very_high_landing_inclusion_pct": "0.00001942",
"max_price": "37",
"max_fee": "37",
"max_cu_limit": "37",
"max_landing_rank_pct": "0.00001942",
"max_landing_inclusion_pct": "0.00001942",
"median_block_fill_pct": "0.62",
"saturated_block_share_pct": "0.18",
"fee_volatility": "0.34",
"avg_cu_per_tx": "37"
}
]
}
]Fields
Numbers come back as strings and timestamps as ISO-8601 strings; every data point carries a stable id. See Data model.
Last update time.
Window length, e.g. 5m.
Window start (inclusive).
Window end (exclusive).
Priority-fee-paying txs in the window.
Txs that paid no priority fee.
All txs in the window.
Samples folded in.
Window met the minimum sample count.
Minimum tier: compute-unit price (micro-lamports per CU).
Minimum tier: total priority fee (lamports).
Minimum tier: suggested compute-unit limit.
Minimum tier: expected within-block rank percentile.
Minimum tier: expected inclusion probability.
Low tier: compute-unit price (micro-lamports per CU).
Low tier: total priority fee (lamports).
Low tier: suggested compute-unit limit.
Low tier: expected within-block rank percentile.
Low tier: expected inclusion probability.
Medium tier: compute-unit price (micro-lamports per CU).
Medium tier: total priority fee (lamports).
Medium tier: suggested compute-unit limit.
Medium tier: expected within-block rank percentile.
Medium tier: expected inclusion probability.
High tier: compute-unit price (micro-lamports per CU).
High tier: total priority fee (lamports).
High tier: suggested compute-unit limit.
High tier: expected within-block rank percentile.
High tier: expected inclusion probability.
Very high tier: compute-unit price (micro-lamports per CU).
Very high tier: total priority fee (lamports).
Very high tier: suggested compute-unit limit.
Very high tier: expected within-block rank percentile.
Very high tier: expected inclusion probability.
Maximum tier: compute-unit price (micro-lamports per CU).
Maximum tier: total priority fee (lamports).
Maximum tier: suggested compute-unit limit.
Maximum tier: expected within-block rank percentile.
Maximum tier: expected inclusion probability.
Median block fill across the window.
Share of blocks that were saturated.
Fee volatility over the window.
Mean compute units per tx.
Errors
Invalid parameters return -32602; an unknown method returns -32601. See Errors for the full table.