TriportRPC
DashboardDocs

stellarHorizonGetLedger

GEThttps://triport.io/rpc/stellar/horizon/ledgers/$LEDGER

Get one retained Horizon ledger.

Stellar mainnetstellar:rpcstellar_read_rpc — 15 / 20 / 100 / 250 RPS (free / basic / pro / business) (default, unmeasured)

Returns one ledger identified by sequence number or ledger hash when it remains inside the selected node's window.

Use it for a known ledger. Use stellarHorizonListLedgers to discover or paginate sequences.

The measured Horizon node retained 6,307,191 ledgers. Deeper reads return 410 Gone; there is no history-archive fallback.

Parameters

ledgerstringrequired
Ledger sequence number or hash in the path.

Response

This schema-shaped example uses placeholders where the contract does not provide a measured value:

_linksobject
HAL links for this ledger.
idstring
Ledger resource identifier.
paging_tokenstring
Opaque paging token.
sequenceinteger
Ledger sequence.
closed_atstring
Ledger close timestamp.

Errors

See Stellar errors and the shared error reference.

StatusMeaningWhen it happens
401UnauthorizedThe API key is missing or invalid.
403ForbiddenThe key lacks the required scope or tier.
404Not foundA requested account or resource does not exist.
429Rate limitedThe stellar_read_rpc RPS budget is exceeded.
410GoneThe requested ledger is older than the selected node's current retention window.

Examples

JavaScript (fetch)

const ledger = process.env.LEDGER;
const response = await fetch(`https://triport.io/rpc/stellar/horizon/ledgers/${ledger}`, {
  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

  • Retention is per selected node and may change as ledgers close.
  • A 410 response is a measured boundary, not an internal failure.
  • Related: stellarHorizonListLedgers and Stellar errors.
  • 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.