stellarHorizonListLedgers — Stellar REST API

List retained Horizon ledgers.

GEThttps://triport.io/rpc/stellar/horizon/ledgers?limit=1&order=desc

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/ledgers?limit=1&order=desc' \
  -H "Authorization: Bearer $TRIPORT_API_KEY" \
  -H "Accept: application/hal+json"

const res = await fetch("https://triport.io/rpc/stellar/horizon/ledgers?limit=1&order=desc", {
  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/ledgers?limit=1&order=desc",
    headers={
        "Authorization": f"Bearer {os.environ['TRIPORT_API_KEY']}",
        "Accept": "application/hal+json",
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "_embedded": {
    "records": [
      {
        "sequence": 64317187,
        "paging_token": "276240214735716352",
        "closed_at": "2026-09-07T14:01:44Z",
        "successful_transaction_count": 317,
        "failed_transaction_count": 24,
        "operation_count": 863
      }
    ]
  },
  "_links": {
    "next": {
      "href": "https://triport.io/rpc/stellar/horizon/ledgers?cursor=276240214735716352&limit=1&order=desc"
    }
  }
}

Returns a cursor-paginated HAL page of ledgers inside the selected Horizon node's retention window.

Use it for recent ledger-header ingestion or close-time tracking. Use stellarHorizonGetLedger when one known sequence is required, or Soroban getLedgers when JSON-RPC/XDR is preferred.

The measured Horizon node retained 6,307,191 ledgers. This is a per-operator observation, not a network-wide archive guarantee.

Parameters

cursorstringoptional

Opaque Horizon paging token from a returned link.

orderstringoptional

Sort direction: asc or desc.

limitintegeroptional

Maximum page size from 1 through 200; 201 was rejected in measurement.

Response

_linksobject

HAL navigation links; additional link relations may be present.

_links.next.hrefstring

URL carrying the cursor for the next page.

_embeddedobject

Container for the returned collection.

_embedded.recordsarray

Page of ledger HAL resources.

_embedded.records[].sequenceinteger

Ledger sequence.

_embedded.records[].paging_tokenstring

Opaque cursor; keep it as a string.

_embedded.records[].closed_atstring

Ledger close timestamp.

Errors

See Stellar errors and the shared error reference.

Status	Meaning	When it happens
`400`	Bad request	A query parameter is malformed or `limit` exceeds 200.
`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/ledgers?limit=1&order=desc", {
  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

limit is at most 200.
Keep paging tokens as strings to avoid integer precision loss.
Related: stellarHorizonGetLedger and Soroban getLedgers.
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.