stellarHorizonGetFeeStats — Stellar REST API

Get the current Horizon fee snapshot.

GEThttps://triport.io/rpc/stellar/horizon/fee_stats

Network: Stellar mainnet
Scope: stellar:rpc
Auth: x-token: $TRIPORT_API_KEY (or Authorization: Bearer)
Rate limit: stellar_read_rpc — 15 / 20 / 100 / 250 RPS sustained · short burst 30 / 40 / 200 / 500 (free / basic / pro / business) (plan policy); Burst capacity

Endpoint and plans: Stellar RPC endpoint.

Request

cURLJavaScriptPython

curl 'https://triport.io/rpc/stellar/horizon/fee_stats' \
  -H "Authorization: Bearer $TRIPORT_API_KEY" \
  -H "Accept: application/hal+json"

const res = await fetch("https://triport.io/rpc/stellar/horizon/fee_stats", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Accept": "application/hal+json",
  },
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.get(
    "https://triport.io/rpc/stellar/horizon/fee_stats",
    headers={
        "Authorization": f"Bearer {os.environ['TRIPORT_API_KEY']}",
        "Accept": "application/hal+json",
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "last_ledger": "$last_ledger",
  "last_ledger_base_fee": "$base_fee",
  "fee_charged": {
    "p50": "$fee_p50"
  },
  "max_fee": {
    "p50": "$max_fee_p50"
  }
}

Returns current Horizon fee percentiles and the latest ledger used for the snapshot.

Use it to estimate classic Stellar transaction fees. Use Soroban getFeeStats for the RPC layer's separate classic and Soroban inclusion-fee distributions.

This is a current snapshot from one measured Horizon operator, not an SLA or a transaction-submission quote.

Parameters

——optional

This operation defines no path or query parameters.

Response

last_ledgerstring

Latest ledger used for the snapshot.

last_ledger_base_feestring

Base fee for that ledger.

fee_chargedobject

Observed charged-fee percentiles.

max_feeobject

Declared maximum-fee percentiles when present.

Errors

See Stellar errors and the shared error reference.

Status	Meaning	When it happens
`401`	Unauthorized	The API key is missing or invalid.
`403`	Forbidden	The key lacks the required scope or tier.
`429`	Rate limited	The `stellar_read_rpc` RPS budget is exceeded.

Examples

JavaScript (fetch)

JavaScript

const response = await fetch("https://triport.io/rpc/stellar/horizon/fee_stats", {
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Accept": "application/hal+json",
  },
});
if (!response.ok) throw new Error(`Horizon returned ${response.status}`);
const payload = await response.json();
console.log(payload);

Notes

Fee values are string encoded.
The snapshot changes as ledgers close.
Related: Soroban getFeeStats and simulateTransaction.
Horizon is currently served by one measured operator on a best-effort basis without an SLA.
This product surface is read-only; transaction submission is unavailable.