stellarHorizonListPayments — Stellar REST API

List global payment-like operations.

GEThttps://triport.io/rpc/stellar/horizon/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/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/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(
    "https://triport.io/rpc/stellar/horizon/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 across the retained Horizon dataset.

Use it for global payment ingestion. Use the account-scoped variant to constrain results to one account, or operations for all operation types.

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

Parameters

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.
`429`	Rate limited	The `stellar_read_rpc_heavy` RPS budget is exceeded.

Examples

JavaScript (fetch)

JavaScript

const response = await fetch("https://triport.io/rpc/stellar/horizon/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 with opaque paging tokens rather than constructing cursors.
Related: stellarHorizonListAccountPayments and stellarHorizonListOperations.
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.
Payments to an M… address land on its underlying G… account; see why a Stellar M… address maps to a G… account.