stellarHorizonGetAccount
GET
https://triport.io/rpc/stellar/horizon/accounts/$STELLAR_ACCOUNTGet current Horizon account state.
Stellar mainnetstellar:rpcstellar_read_rpc — 15 / 20 / 100 / 250 RPS (free / basic / pro / business) (default, unmeasured)
Returns the latest account balances, sequence, signers, sponsorship data, and HAL links for one Stellar account.
Use it for current account state. It is not a historical snapshot API; account history is available through the account-scoped payment and transaction collections.
The account route is latest-only. The available Horizon path is backed by one measured operator and is best-effort without an SLA.
Parameters
accountstringrequiredStellar account ID in the path.
Response
This schema-shaped example uses placeholders where the contract does not provide a measured value:
_linksobjectHAL links related to the account.
account_idstringCanonical account ID.
sequencestringCurrent account sequence.
balancesarrayCurrent native and trustline balances.
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. |
404 | Not found | A requested account or resource does not exist. |
429 | Rate limited | The stellar_read_rpc RPS budget is exceeded. |
Examples
JavaScript (fetch)
const account = process.env.STELLAR_ACCOUNT;
const response = await fetch(`https://triport.io/rpc/stellar/horizon/accounts/${account}`, {
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
- Account state is latest-only.
- A missing account returns
404, not an empty synthetic account. - Related:
stellarHorizonListAccountPaymentsandstellarHorizonListAccountTransactions. - 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.