stellarHorizonListAccountTransactions — Stellar REST API

List transactions involving one account.

GEThttps://triport.io/rpc/stellar/horizon/accounts/$STELLAR_ACCOUNT/transactions?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/accounts/$STELLAR_ACCOUNT/transactions?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/accounts/${process.env.STELLAR_ACCOUNT}/transactions?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(
    f"https://triport.io/rpc/stellar/horizon/accounts/{os.environ['STELLAR_ACCOUNT']}/transactions?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

{
  "_links": {
    "next": {
      "href": "$next_page_url"
    },
    "self": {
      "href": "$request_url"
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "$resource_url"
          }
        },
        "id": "$transaction_id",
        "paging_token": "$paging_token"
      }
    ]
  }
}

Returns a cursor-paginated HAL page of transactions involving one account.

Use it for account-scoped transaction history. Use stellarHorizonGetAccount for current balances or the global transaction collection when no account filter is needed.

Only retained Horizon history is available. The route currently has one measured operator and is best-effort without an SLA.

Parameters

accountstringrequired

Stellar account ID in the path.

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 transaction HAL resources.

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.
`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}/transactions?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.
Transaction submission is not in this read-only catalog.
Related: stellarHorizonListTransactions and stellarHorizonGetAccount.
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.