stellarHorizonGetAccount — Stellar REST API

Get current Horizon account state.

GEThttps://triport.io/rpc/stellar/horizon/accounts/$STELLAR_ACCOUNT

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/accounts/$STELLAR_ACCOUNT" \
  -H "Authorization: Bearer $TRIPORT_API_KEY" \
  -H "Accept: application/hal+json"

const res = await fetch(`https://triport.io/rpc/stellar/horizon/accounts/${process.env.STELLAR_ACCOUNT}`, {
  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(
    f"https://triport.io/rpc/stellar/horizon/accounts/{os.environ['STELLAR_ACCOUNT']}",
    headers={
        "Authorization": f"Bearer {os.environ['TRIPORT_API_KEY']}",
        "Accept": "application/hal+json",
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "_links": {
    "self": {
      "href": "$account_url"
    }
  },
  "account_id": "$stellar_account",
  "sequence": "$account_sequence",
  "balances": []
}

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

accountstringrequired

Stellar account ID in the path.

Response

_linksobject

HAL links related to the account.

account_idstring

Canonical account ID.

sequencestring

Current account sequence.

balancesarray

Current 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)

JavaScript

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: stellarHorizonListAccountPayments and stellarHorizonListAccountTransactions.
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.
The account's sequence decides the next transaction's sequence number; see how Stellar sequence numbers work.