stellarHorizonRoot — Stellar REST API
Get Horizon root metadata and resource links.
GET
https://triport.io/rpc/stellar/horizon- 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.
Returns Horizon service metadata and HAL links to the available resource collections.
Use it for discovery and compatibility diagnostics. It does not report Soroban RPC health; use the JSON-RPC getHealth method for that layer.
This Horizon surface currently has one measured working operator and is best-effort without an SLA.
Parameters
——optionalThis operation defines no path or query parameters.
Response
horizon_versionstringHorizon software version.
core_versionstringConnected Stellar Core version.
history_latest_ledgerintegerLatest ledger ingested by Horizon.
_linksobjectHAL links to resource collections.
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)
const response = await fetch("https://triport.io/rpc/stellar/horizon", {
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
- HAL links are passed through as returned by Horizon.
- The root is metadata, not a transaction-submission endpoint.
- Related:
stellarHorizonGetFeeStatsand SorobangetHealth. - 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.