stellarHorizonListAccountPayments — Stellar REST API

List payment-like operations for one account.

GEThttps://triport.io/rpc/stellar/horizon/accounts/$STELLAR_ACCOUNT/payments?limit=1&order=desc

Network: Stellar mainnet
Scope: stellar:rpc
Auth: x-token: $TRIPORT_API_KEY (or Authorization: Bearer)
Rate limit: stellar_read_rpc_heavy — 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/payments?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}/payments?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']}/payments?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": "$payment_id",
        "paging_token": "$paging_token"
      }
    ]
  }
}

Returns a cursor-paginated HAL page of payment-like operations involving one account.

Use it for account-specific payment ingestion. Use the global payments endpoint when no account filter is needed, or the account transaction endpoint for transaction-level records.

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 payment-like operation 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_heavy` 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}/payments?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.
Continue from the cursor in _links.next.href.
Related: stellarHorizonListPayments 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.
Empty _embedded.records? See why a Stellar Horizon page has no records for cursor, order and limit behavior.