# Stellar

> Read the Stellar network through Horizon, its public API: account balances and signers, payments with their memos, transactions, operations and ledgers, issued assets, the decentralized exchange's order books, trades and price history, payment path quotes, liquidity pools, claimable balances and fees. Triggers run on new payments to or from an account and on new trades for an asset pair. No account or API key required.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/stellar

## Actions

### Find payment paths

Quote a payment that pays in one asset and delivers another through Stellar's exchange: how much arrives for an amount sent, or how much must be sent for an amount to arrive, with the assets each path trades through, best quote first.

**Inputs**

- Pay with (`from_asset`, text, required): The asset the sender pays in: XLM, or an issued asset written CODE:ISSUER.
- Deliver (`to_asset`, text, required): The asset the receiver gets: XLM, or an issued asset written CODE:ISSUER.
- Amount (`amount`, number, required): How much is sent, or received, depending on the choice in Fixed amount. Up to 7 decimal places. From 1e-07 to 922337203685.4775.
- Fixed amount (`mode`, text): Whether the amount is what the sender pays (a strict send quote) or what the receiver gets (a strict receive quote). Defaults to what the sender pays. One of: `send` (I send exactly this amount), `receive` (They receive exactly this amount). Default: `send`.

**Outputs**

- `amount` (text): The fixed amount, as sent to Horizon.
- `best_destination_amount` (text): What the best path delivers.
- `best_source_amount` (text): What the best path costs the sender.
- `count` (number): How many paths were found.
- `from_asset` (text): The asset paid in.
- `mode` (text): send when the amount is what is paid, receive when it is what arrives.
- `paths` (list): Every path found, best quote first.
- `to_asset` (text): The asset delivered.

**Example output**

```json
{
  "amount": "100",
  "best_destination_amount": "18.1563000",
  "best_source_amount": "100.0000000",
  "count": 1,
  "from_asset": "XLM",
  "mode": "send",
  "paths": [
    {
      "destination_amount": "18.1563000",
      "destination_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "path": [],
      "source_amount": "100.0000000",
      "source_asset": "XLM"
    }
  ],
  "to_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
}
```

### Get account

Get a Stellar account: its XLM balance and every other balance, the keys that can sign for it with their weights and thresholds, its settings, home domain and data entries.

**Inputs**

- Account (`account`, text, required): The account ID: a key starting with G, 56 characters long.

**Outputs**

- `account_id` (text): The account ID (G...).
- `balances` (list): Every balance, XLM included.
- `data` (list): The account's data entries, decoded.
- `flags` (object): The issuer settings it has turned on.
- `home_domain` (text): The domain the account names as its home, e.g. circle.com.
- `last_modified_ledger` (number): The ledger in which it last changed.
- `last_modified_time` (text): When it last changed, ISO 8601 UTC.
- `num_sponsored` (number): How many of its reserves another account pays.
- `num_sponsoring` (number): How many reserves it pays for other accounts.
- `sequence` (text): The account's current sequence number.
- `signers` (list): The keys that can sign for it, with their weights.
- `sponsor` (text): The account that paid to create it, when it is sponsored.
- `subentry_count` (number): Trustlines, offers, signers and data entries it holds.
- `thresholds` (object): The signature weight each kind of operation needs.
- `xlm_balance` (text): The XLM (lumens) balance, as an exact decimal string.

**Example output**

```json
{
  "account_id": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "balances": [
    {
      "asset": "USDCAllow:GDIEKKIQWMIZ4LD3RP3ABPN7X5KEAEWYMR634BRHB7EULIMEVREWLF3G",
      "asset_code": "USDCAllow",
      "asset_issuer": "GDIEKKIQWMIZ4LD3RP3ABPN7X5KEAEWYMR634BRHB7EULIMEVREWLF3G",
      "asset_type": "credit_alphanum12",
      "balance": "12898524698.0240425",
      "buying_liabilities": "909438678987.4535382",
      "is_authorized": true,
      "limit": "922337203685.4775807",
      "liquidity_pool_id": null,
      "selling_liabilities": "0.0000000",
      "sponsor": null
    },
    {
      "asset": "XLM",
      "asset_code": "XLM",
      "asset_issuer": null,
      "asset_type": "native",
      "balance": "26180.7714479",
      "buying_liabilities": "0.0000000",
      "is_authorized": null,
      "limit": null,
      "liquidity_pool_id": null,
      "selling_liabilities": "0.0000000",
      "sponsor": null
    }
  ],
  "data": [],
  "flags": {
    "auth_clawback_enabled": false,
    "auth_immutable": false,
    "auth_required": false,
    "auth_revocable": true
  },
  "home_domain": "circle.com",
  "last_modified_ledger": 65049256,
  "last_modified_time": "2026-10-20T21:34:23Z",
  "num_sponsored": 0,
  "num_sponsoring": 0,
  "sequence": "144373126631784461",
  "signers": [
    {
      "key": "GAUKFO2NIYEFO773KJZKLPSPYNQ6M7INPEAIQIJCIH7EEVP2KSVQWGH4",
      "sponsor": null,
      "type": "ed25519_public_key",
      "weight": 1
    }
  ],
  "sponsor": null,
  "subentry_count": 6,
  "thresholds": {
    "high": 2,
    "low": 2,
    "medium": 2
  },
  "xlm_balance": "26180.7714479"
}
```

### Get fee stats

Get what Stellar transactions paid in fees over the last few ledgers (lowest, most common, percentiles and highest, in stroops), the base fee and how full ledgers are.

**Inputs**: None.

**Outputs**

- `base_fee` (text): The same base fee, in XLM.
- `base_fee_stroops` (number): The smallest fee per operation, in stroops.
- `fee_charged` (object): Fees transactions actually paid in recent ledgers.
- `last_ledger` (number): The latest ledger the figures cover.
- `ledger_capacity_usage` (number): How full recent ledgers were, from 0 to 1.
- `max_fee` (object): Fees transactions offered to pay at most.

**Example output**

```json
{
  "base_fee": "0.0000100",
  "base_fee_stroops": 100,
  "fee_charged": {
    "max": 119230,
    "min": 100,
    "mode": 100,
    "p10": 100,
    "p20": 100,
    "p30": 100,
    "p40": 100,
    "p50": 100,
    "p60": 100,
    "p70": 100,
    "p80": 100,
    "p90": 100,
    "p95": 46310,
    "p99": 66140
  },
  "last_ledger": 65055381,
  "ledger_capacity_usage": 0.47,
  "max_fee": {
    "max": 301202846,
    "min": 100,
    "mode": 21009,
    "p10": 101,
    "p20": 244,
    "p30": 1010,
    "p40": 20001,
    "p50": 21009,
    "p60": 21009,
    "p70": 72200,
    "p80": 250005,
    "p90": 855648,
    "p95": 1975760,
    "p99": 10000000
  }
}
```

### Get ledger

Get a Stellar ledger by its number, or the latest one: when it closed, how many transactions and operations it held, the base fee and reserve, and the XLM in existence.

**Inputs**

- Ledger number (`sequence`, number): The ledger's number. Leave empty for the latest ledger. At least 1.

**Outputs**

- `base_fee` (text): The smallest fee per operation then, in XLM.
- `base_reserve` (text): The reserve per account entry then, in XLM.
- `closed_at` (text): When it closed, ISO 8601 UTC.
- `failed_transaction_count` (number): Transactions in it that failed.
- `fee_pool` (text): XLM collected in fees so far.
- `hash` (text): The ledger's hash.
- `max_tx_set_size` (number): The most operations a ledger could hold.
- `operation_count` (number): Operations in its successful transactions.
- `previous_hash` (text): The hash of the ledger before it.
- `protocol_version` (number): The network protocol version.
- `sequence` (number): The ledger's number.
- `successful_transaction_count` (number): Transactions in it that succeeded.
- `total_coins` (text): XLM in existence when it closed.

**Example output**

```json
{
  "base_fee": "0.0000100",
  "base_reserve": "0.5000000",
  "closed_at": "2026-10-21T06:04:38Z",
  "failed_transaction_count": 47,
  "fee_pool": "10895677.1014122",
  "hash": "7f4e3922dc3b5519a2935191993aeaf5af5d16d6977b4c568be33c0c5dcad81c",
  "max_tx_set_size": 1000,
  "operation_count": 277,
  "previous_hash": "5ea178fdaf968ce8c19665d78e83d32b6e4492b9f1741f9e9455ef61668b393f",
  "protocol_version": 29,
  "sequence": 65055379,
  "successful_transaction_count": 136,
  "total_coins": "105443902087.3472865"
}
```

### Get liquidity pool

Get one Stellar liquidity pool by its ID: both reserves, the price they imply, total shares, the fee and how many accounts take part.

**Inputs**

- Liquidity pool ID (`liquidity_pool_id`, text, required): The pool's ID: 64 characters, from List liquidity pools.

**Outputs**

- `amount_a` (text): How much of the first asset it holds.
- `amount_b` (text): How much of the second asset it holds.
- `asset_a` (text): The first asset it holds.
- `asset_b` (text): The second asset it holds.
- `fee_bp` (number): The fee each trade pays, in basis points.
- `fee_percent` (text): The same fee as a percentage, e.g. 0.30.
- `id` (text): The liquidity pool's ID.
- `last_modified_ledger` (number): The ledger in which it last changed.
- `last_modified_time` (text): When it last changed, ISO 8601 UTC.
- `price` (text): Second asset per one unit of the first, from the reserves.
- `reserves` (list): Both reserves.
- `total_shares` (text): Pool shares in existence.
- `total_trustlines` (number): Accounts that hold its shares.
- `type` (text): The kind of pool; constant_product.

**Example output**

```json
{
  "amount_a": "13346424.3095804",
  "amount_b": "2421240.2211112",
  "asset_a": "XLM",
  "asset_b": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "fee_bp": 30,
  "fee_percent": "0.30",
  "id": "a468d41d8e9b8f3c7209651608b74b7db7ac9952dcae0cdf24871d1d9c7b0088",
  "last_modified_ledger": 65055116,
  "last_modified_time": "2026-10-21T05:42:43Z",
  "price": "0.1814149",
  "reserves": [
    {
      "amount": "13346424.3095804",
      "asset": "XLM"
    },
    {
      "amount": "2421240.2211112",
      "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
    }
  ],
  "total_shares": "4212580.7961050",
  "total_trustlines": 835,
  "type": "constant_product"
}
```

### Get operation

Get one Stellar operation by its ID, with a sentence saying what it did and all of its details.

**Inputs**

- Operation ID (`operation_id`, text, required): The operation's ID, a long number, from List payments or List operations.

**Outputs**

- `created_at` (text): When it happened, ISO 8601 UTC.
- `details` (object): Every other field Horizon gives for this kind of operation (amounts, accounts, prices), with assets written as XLM or CODE:ISSUER.
- `id` (text): The operation's ID.
- `source_account` (text): The account it acted for.
- `successful` (true/false): Whether its transaction succeeded.
- `summary` (text): One sentence saying what it did.
- `transaction_hash` (text): The hash of the transaction it was in.
- `type` (text): Horizon's name for it, e.g. payment.
- `type_label` (text): Its kind in words, e.g. Manage sell offer.

**Example output**

```json
{
  "created_at": "2026-10-20T21:34:23Z",
  "details": {
    "amount": "0.0000001",
    "asset": "XLM",
    "from": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
    "to": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
  },
  "id": "279384427149545483",
  "source_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
  "successful": true,
  "summary": "GCEQUY...DSJG paid 0.0000001 XLM to GA5ZSE...KZVN",
  "transaction_hash": "d32b9173ed5e0dd34c2192bb9d8515d604e357a476b401f0773837f684f3ecd9",
  "type": "payment",
  "type_label": "Payment"
}
```

### Get order book

Get the order book for an asset pair on Stellar's decentralized exchange: the best bid and ask, the spread, and each price level with the amount in both assets.

**Inputs**

- Base asset (`base_asset`, text, required): The asset being priced: XLM, or an issued asset written CODE:ISSUER.
- Counter asset (`counter_asset`, text, required): The asset prices are quoted in: XLM, or an issued asset written CODE:ISSUER.
- Price levels (`limit`, number): How many bids and asks to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `asks` (list): Offers to sell the base asset, best price first.
- `base_asset` (text): The asset being priced.
- `best_ask` (text): The lowest price someone will sell the base asset at.
- `best_bid` (text): The highest price someone will pay for the base asset.
- `bids` (list): Offers to buy the base asset, best price first.
- `counter_asset` (text): The asset prices are in.
- `spread` (text): Best ask minus best bid.

**Example output**

```json
{
  "asks": [
    {
      "base_amount": "19.7021525",
      "counter_amount": "3.5811223",
      "price": "0.1817630"
    }
  ],
  "base_asset": "XLM",
  "best_ask": "0.1817630",
  "best_bid": "0.1815630",
  "bids": [
    {
      "base_amount": "1920.0000000",
      "counter_amount": "348.6009600",
      "price": "0.1815630"
    }
  ],
  "counter_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "spread": "0.0002000"
}
```

### Get price history

Get an asset pair's price history on Stellar's decentralized exchange as candles (Horizon's trade aggregations): open, high, low, close and average price, volume in both assets and number of trades, from 1 minute to 1 week each, oldest first.

**Inputs**

- Base asset (`base_asset`, text, required): The asset being priced: XLM, or an issued asset written CODE:ISSUER.
- Counter asset (`counter_asset`, text, required): The asset prices are quoted in: XLM, or an issued asset written CODE:ISSUER.
- Candle size (`resolution`, text): How long each candle covers. Defaults to 1 hour. One of: `1m` (1 minute), `5m` (5 minutes), `15m` (15 minutes), `1h` (1 hour), `1d` (1 day), `1w` (1 week). Default: `1h`.
- From (`start_time`, date and time): The first candle covers this moment. Leave empty for the latest candles.
- Until (`end_time`, date and time): The last candle covers this moment. Leave empty for up to now.
- Number of candles (`limit`, number): How many candles to return, 1 to 200. Defaults to 24. From 1 to 200.

**Outputs**

- `base_asset` (text): The asset being priced.
- `candles` (list): The candles, oldest first. Periods with no trades are left out.
- `count` (number): How many candles came back.
- `counter_asset` (text): The asset prices are in.
- `resolution` (text): The candle size: 1m, 5m, 15m, 1h, 1d or 1w.

**Example output**

```json
{
  "base_asset": "XLM",
  "candles": [
    {
      "average": "0.1810307",
      "base_volume": "961855.1184731",
      "close": "0.1818390",
      "counter_volume": "174125.3321325",
      "high": "0.1822222",
      "low": "0.1802002",
      "open": "0.1814621",
      "start": "2026-10-21T04:00:00Z",
      "timestamp_ms": 1792555200000,
      "trade_count": 1809
    }
  ],
  "count": 1,
  "counter_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "resolution": "1h"
}
```

### Get transaction

Get a Stellar transaction by its hash, with every operation in it: who sent it, the fee in XLM, the memo, the ledger it closed in and whether it succeeded.

**Inputs**

- Transaction hash (`transaction_hash`, text, required): The transaction's hash: 64 characters, from List payments, List transactions or a block explorer.

**Outputs**

- `created_at` (text): When it closed, ISO 8601 UTC.
- `fee_account` (text): The account that paid the fee.
- `fee_charged` (text): The fee paid, in XLM.
- `hash` (text): The transaction's hash (its ID).
- `is_fee_bump` (true/false): True when another account paid its fee (a fee bump).
- `ledger` (number): The ledger it closed in.
- `max_fee` (text): The most it offered to pay, in XLM.
- `memo` (text): Its memo, if it has one.
- `memo_type` (text): text, id, hash, return or none.
- `operation_count` (number): How many operations it held.
- `operations` (list): Every operation in it, in order.
- `source_account` (text): The account that submitted it.
- `successful` (true/false): Whether it succeeded.

**Example output**

```json
{
  "created_at": "2026-10-20T21:34:23Z",
  "fee_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
  "fee_charged": "0.0010000",
  "hash": "d32b9173ed5e0dd34c2192bb9d8515d604e357a476b401f0773837f684f3ecd9",
  "is_fee_bump": false,
  "ledger": 65049256,
  "max_fee": "0.0010000",
  "memo": "LMNS Mining & XLM Rewards",
  "memo_type": "text",
  "operation_count": 100,
  "operations": [
    {
      "created_at": "2026-10-20T21:34:23Z",
      "details": {
        "amount": "0.0000001",
        "asset": "XLM",
        "from": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
        "to": "GAGMYHSFTWO35UMIBTKG4DICR5OX32ERKDXTHGFICXVGZVBMUBMCTJJ6"
      },
      "id": "279384427149545473",
      "source_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
      "successful": true,
      "summary": "GCEQUY...DSJG paid 0.0000001 XLM to GAGMYH...TJJ6",
      "transaction_hash": "d32b9173ed5e0dd34c2192bb9d8515d604e357a476b401f0773837f684f3ecd9",
      "type": "payment",
      "type_label": "Payment"
    }
  ],
  "source_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
  "successful": true
}
```

### List accounts

Find Stellar accounts by one thing they share: an issued asset they hold, a key that can sign for them, the sponsor paying their reserves, or a liquidity pool they are in. Each comes with its balances and signers.

**Inputs**

- Find (`filter_by`, text): How to find the accounts. Horizon searches by one of these at a time. One of: `asset` (Accounts holding an asset), `signer` (Accounts a key can sign for), `sponsor` (Accounts a sponsor pays reserves for), `liquidity_pool` (Accounts in a liquidity pool). Default: `asset`.
- Asset (`asset`, text): Accounts that hold this issued asset, written CODE:ISSUER. Only when Find is Accounts holding an asset.
- Signer (`signer`, text): Accounts this key (an ID starting with G) can sign for. Only when Find is Accounts a key can sign for.
- Sponsor (`sponsor`, text): Accounts whose reserves this account (an ID starting with G) pays. Only when Find is Accounts a sponsor pays reserves for.
- Liquidity pool ID (`liquidity_pool_id`, text): Accounts that hold shares of this pool (its 64 character ID). Only when Find is Accounts in a liquidity pool.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `accounts` (list): The accounts.
- `count` (number): How many accounts came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.

**Example output**

```json
{
  "accounts": [
    {
      "account_id": "GDZZVIJNVFZAPXLXCR4BSEIFGPXJSLMPZIDAIERU5SIAMVLVFOIUVLIV",
      "balances": [
        {
          "asset": "EURC:GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2",
          "asset_code": "EURC",
          "asset_issuer": "GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2",
          "asset_type": "credit_alphanum4",
          "balance": "0.0000000",
          "buying_liabilities": "0.0000000",
          "is_authorized": true,
          "limit": "922337203685.4775807",
          "liquidity_pool_id": null,
          "selling_liabilities": "0.0000000",
          "sponsor": null
        },
        {
          "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
          "asset_code": "USDC",
          "asset_issuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
          "asset_type": "credit_alphanum4",
          "balance": "0.0000000",
          "buying_liabilities": "0.0000000",
          "is_authorized": true,
          "limit": "922337203685.4775807",
          "liquidity_pool_id": null,
          "selling_liabilities": "0.0000000",
          "sponsor": null
        },
        {
          "asset": "XLM",
          "asset_code": "XLM",
          "asset_issuer": null,
          "asset_type": "native",
          "balance": "2.9995301",
          "buying_liabilities": "0.0000000",
          "is_authorized": null,
          "limit": null,
          "liquidity_pool_id": null,
          "selling_liabilities": "0.0000000",
          "sponsor": null
        }
      ],
      "data": [],
      "flags": {
        "auth_clawback_enabled": false,
        "auth_immutable": false,
        "auth_required": false,
        "auth_revocable": false
      },
      "home_domain": null,
      "last_modified_ledger": 56014982,
      "last_modified_time": null,
      "num_sponsored": 0,
      "num_sponsoring": 0,
      "sequence": "239921898266296336",
      "signers": [
        {
          "key": "GDZZVIJNVFZAPXLXCR4BSEIFGPXJSLMPZIDAIERU5SIAMVLVFOIUVLIV",
          "sponsor": null,
          "type": "ed25519_public_key",
          "weight": 1
        }
      ],
      "sponsor": null,
      "subentry_count": 2,
      "thresholds": {
        "high": 0,
        "low": 0,
        "medium": 0
      },
      "xlm_balance": "2.9995301"
    }
  ],
  "count": 1,
  "next_cursor": "GDZZIGVQ7AQ3PY2HLQ5VUCFYKBI7M3FN6X7GX734RXLL45A63HQQ6W4R"
}
```

### List assets

Find assets issued on Stellar by code (such as USDC) and/or by issuer, with how many accounts hold each, how much is held, in pools and in contracts, the issuer's home domain and settings.

**Inputs**

- Asset code (`asset_code`, text): Only assets with this code, e.g. USDC. Many issuers can use one code.
- Issuer (`asset_issuer`, text): Only assets this account (an ID starting with G) issues.
- Order (`order`, text): Alphabetical by code, A to Z or Z to A. Defaults to A to Z. One of: `asc` (A to Z by code), `desc` (Z to A by code). Default: `asc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `assets` (list): The assets.
- `count` (number): How many assets came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.

**Example output**

```json
{
  "assets": [
    {
      "amount_held": "316675147.3264316",
      "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "asset_code": "USDC",
      "asset_issuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "asset_type": "credit_alphanum4",
      "claimable_balances_amount": "26947.8908426",
      "contract_id": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
      "contracts_amount": "120050097.2235987",
      "flags": {
        "auth_clawback_enabled": false,
        "auth_immutable": false,
        "auth_required": false,
        "auth_revocable": true
      },
      "holders": 2491401,
      "holders_maintaining_liabilities": 0,
      "home_domain": "circle.com",
      "liquidity_pools_amount": "2680845.4325596",
      "num_claimable_balances": 1800,
      "num_contracts": 50425,
      "num_liquidity_pools": 886,
      "toml_url": "https://circle.com/.well-known/stellar.toml",
      "unauthorized_holders": 0
    }
  ],
  "count": 1,
  "next_cursor": "USDC_GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN_credit_alphanum4"
}
```

### List claimable balances

List Stellar claimable balances (amounts set aside for an account to claim, such as airdrops or payments to accounts without a trustline) by claimant, sponsor or asset, with who may claim each and when.

**Inputs**

- Claimant (`claimant`, text): Only balances this account (an ID starting with G) may claim.
- Sponsor (`sponsor`, text): Only balances whose reserve this account pays.
- Asset (`asset`, text): Only balances of this asset: XLM, or an issued asset written CODE:ISSUER.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `claimable_balances` (list): The claimable balances.
- `count` (number): How many claimable balances came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.

**Example output**

```json
{
  "claimable_balances": [
    {
      "amount": "24.4099696",
      "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "claimants": [
        {
          "condition": "at any time",
          "destination": "GDOQQHJJ3GX7XSTGVBY7BCKG636VBLXKQFUW6CJAQRZMV3X2NT6D224F",
          "predicate": {
            "unconditional": true
          }
        }
      ],
      "clawback_enabled": false,
      "id": "000000005c973db22f3e58953b5358ad94a5f475cb55c978749e19d050c6ff818bed9ac7",
      "last_modified_ledger": 65053140,
      "last_modified_time": "2026-10-21T02:58:03Z",
      "sponsor": "GCN3QSQK3WTMYQXLRUXV5YUT3442QXFGGKJEM4NWXZ4SYWGPGHXW4QKL"
    }
  ],
  "count": 1,
  "next_cursor": "65047651-00000000fd39b8b0db4d81e58af63fc8ee65d61dba32baf221e836b663852922165a6d53"
}
```

### List effects

List what happened to a Stellar account, or in one ledger: balances credited and debited, trades filled, trustlines and signers added or removed, and the rest of Horizon's effects.

**Inputs**

- Account (`account`, text): Only this account's (an ID starting with G). Leave empty, with no ledger, for the whole network's latest.
- Ledger (`ledger`, number): Only those in this ledger, by its number. Use instead of an account. At least 1.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `count` (number): How many effects came back.
- `effects` (list): The effects.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.

**Example output**

```json
{
  "count": 1,
  "effects": [
    {
      "account": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "amount": null,
      "asset": null,
      "created_at": "2026-10-21T03:43:13Z",
      "details": {
        "bought_amount": "1057611.6000000",
        "bought_asset": "USDCAllow:GDIEKKIQWMIZ4LD3RP3ABPN7X5KEAEWYMR634BRHB7EULIMEVREWLF3G",
        "offer_id": "426903336",
        "seller": "GDEWOLMOPAVRTGNJVWOE6U6LHZVAWIJZVWM6PDLCFTUTJJEKSU32TO5W",
        "sold_amount": "1057611.6000000",
        "sold_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
      },
      "id": "0279403436675072001-0000000004",
      "operation_id": "279403436675072001",
      "type": "trade",
      "type_label": "Trade"
    }
  ],
  "next_cursor": "279397101598253057-4"
}
```

### List liquidity pools

List Stellar's liquidity pools holding an asset or an asset pair, or those an account has shares in: both reserves, the price they imply, the fee and how many accounts take part.

**Inputs**

- Asset (`asset`, text): Only pools holding this asset: XLM, or an issued asset written CODE:ISSUER.
- Other asset (`other_asset`, text): With Asset, only the pool of this pair.
- Account (`account`, text): Only pools this account (an ID starting with G) holds shares of.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `count` (number): How many liquidity pools came back.
- `liquidity_pools` (list): The liquidity pools.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.

**Example output**

```json
{
  "count": 1,
  "liquidity_pools": [
    {
      "amount_a": "13346424.3095804",
      "amount_b": "2421240.2211112",
      "asset_a": "XLM",
      "asset_b": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "fee_bp": 30,
      "fee_percent": "0.30",
      "id": "a468d41d8e9b8f3c7209651608b74b7db7ac9952dcae0cdf24871d1d9c7b0088",
      "last_modified_ledger": 65055116,
      "last_modified_time": "2026-10-21T05:42:43Z",
      "price": "0.1814149",
      "reserves": [
        {
          "amount": "13346424.3095804",
          "asset": "XLM"
        },
        {
          "amount": "2421240.2211112",
          "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
        }
      ],
      "total_shares": "4212580.7961050",
      "total_trustlines": 835,
      "type": "constant_product"
    }
  ],
  "next_cursor": "a468d41d8e9b8f3c7209651608b74b7db7ac9952dcae0cdf24871d1d9c7b0088"
}
```

### List offers

List open offers on Stellar's decentralized exchange by seller and/or by the assets sold and bought, with the amount, price and when each last changed.

**Inputs**

- Seller (`seller`, text): Only this account's offers (an ID starting with G).
- Selling (`selling_asset`, text): Only offers selling this asset: XLM, or an issued asset written CODE:ISSUER.
- Buying (`buying_asset`, text): Only offers buying this asset: XLM, or an issued asset written CODE:ISSUER.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `count` (number): How many offers came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.
- `offers` (list): The offers.

**Example output**

```json
{
  "count": 1,
  "next_cursor": "1862412286",
  "offers": [
    {
      "amount": "59312.2902515",
      "buying": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "id": "1862412534",
      "last_modified_ledger": 65055374,
      "last_modified_time": "2026-10-21T06:04:13Z",
      "price": "0.1820624",
      "seller": "GBZA2XWTTBO7DF7J2X3AEATUFX44PPBHGORJRJEQTLT4BWAYPPGYPS7N",
      "selling": "XLM",
      "sponsor": null
    }
  ]
}
```

### List operations

List the operations (payments, offers, trustline changes, account settings, contract calls and every other kind) of a Stellar account or of one ledger, or the network's latest, each with a sentence saying what it did.

**Inputs**

- Account (`account`, text): Only this account's (an ID starting with G). Leave empty, with no ledger, for the whole network's latest.
- Ledger (`ledger`, number): Only those in this ledger, by its number. Use instead of an account. At least 1.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.
- Include failed transactions (`include_failed`, true/false): Also include those from transactions that failed. Default: `false`.

**Outputs**

- `count` (number): How many operations came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.
- `operations` (list): The operations.

**Example output**

```json
{
  "count": 1,
  "next_cursor": "279381936068558849",
  "operations": [
    {
      "created_at": "2026-10-20T20:49:03Z",
      "details": {
        "amount": "10041582.8000000",
        "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
        "from": "GAFK7XFZHMLSNV7OJTBO7BAIZA66X6QIBV5RMZZYXK4Q7ZSO52J5C3WQ",
        "to": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
      },
      "id": "279382090687025153",
      "source_account": "GAFK7XFZHMLSNV7OJTBO7BAIZA66X6QIBV5RMZZYXK4Q7ZSO52J5C3WQ",
      "successful": true,
      "summary": "GAFK7X...C3WQ paid 10041582.8000000 USDC to GA5ZSE...KZVN",
      "transaction_hash": "c8266018ff46ed273821d3476799a52fd9c70dbc459b9a633a6e4cca43678ec7",
      "type": "payment",
      "type_label": "Payment"
    }
  ]
}
```

### List payments

List payments to and from a Stellar account, newest first, or the whole network's latest: who paid whom, how much of which asset, the memo, and whether it was received or sent. Includes accounts being opened, path payments, merges and smart contract transfers.

**Inputs**

- Account (`account`, text): Only payments to or from this account (an ID starting with G). Leave empty for the whole network's latest.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.
- Include failed transactions (`include_failed`, true/false): Also include those from transactions that failed. Default: `false`.

**Outputs**

- `account` (text): The account asked about, if any.
- `count` (number): How many payments came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.
- `payments` (list): The payments.

**Example output**

```json
{
  "account": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
  "count": 1,
  "next_cursor": "279381180154208257",
  "payments": [
    {
      "amount": "10041582.8000000",
      "asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "asset_code": "USDC",
      "created_at": "2026-10-20T20:49:03Z",
      "direction": "received",
      "from": "GAFK7XFZHMLSNV7OJTBO7BAIZA66X6QIBV5RMZZYXK4Q7ZSO52J5C3WQ",
      "id": "279382090687025153",
      "ledger": 65048712,
      "memo": "internal",
      "memo_type": "text",
      "source_amount": null,
      "source_asset": null,
      "successful": true,
      "to": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "transaction_hash": "c8266018ff46ed273821d3476799a52fd9c70dbc459b9a633a6e4cca43678ec7",
      "type": "payment",
      "type_label": "Payment"
    }
  ]
}
```

### List trades

List trades on Stellar's decentralized exchange, newest first: for an asset pair, an account or a liquidity pool, or the latest of all. Each has both amounts, the price and both sides.

**Inputs**

- Account (`account`, text): Only this account's trades (an ID starting with G).
- Base asset (`base_asset`, text): With a counter asset, only trades of this pair: XLM, or an issued asset written CODE:ISSUER.
- Counter asset (`counter_asset`, text): The pair's other asset, in which prices are quoted: XLM, or an issued asset written CODE:ISSUER.
- Liquidity pool ID (`liquidity_pool_id`, text): Only trades against this liquidity pool. Use instead of an account.
- Trade type (`trade_type`, text): Order book trades, liquidity pool trades, or both. Defaults to both. One of: `all` (All trades), `orderbook` (Order book trades only), `liquidity_pool` (Liquidity pool trades only). Default: `all`.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.

**Outputs**

- `count` (number): How many trades came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.
- `trades` (list): The trades.

**Example output**

```json
{
  "count": 1,
  "next_cursor": "279410716644163585-5",
  "trades": [
    {
      "base_account": "GAHVUQF7SFZNBFIIOHQAESLUXSNOQPXIOHV34UBCIL2UUFIMERWVKJKO",
      "base_amount": "0.0021892",
      "base_asset": "XLM",
      "base_is_seller": false,
      "base_offer_id": "4891096739366379521",
      "closed_at": "2026-10-21T06:04:33Z",
      "counter_account": "GDAVYIICLHJIQACEC3FQFQAZDMIR4IRUJMURN446DD6SLILZS2FPUSDC",
      "counter_amount": "0.0003974",
      "counter_asset": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "counter_offer_id": "1862412552",
      "id": "279410720938991617-5",
      "liquidity_pool_fee_bp": null,
      "liquidity_pool_id": null,
      "price": "0.1815311",
      "trade_type": "orderbook"
    }
  ]
}
```

### List transactions

List the transactions of a Stellar account or of one ledger, or the network's latest: hash, time, fee in XLM, number of operations, memo and whether each succeeded.

**Inputs**

- Account (`account`, text): Only this account's (an ID starting with G). Leave empty, with no ledger, for the whole network's latest.
- Ledger (`ledger`, number): Only those in this ledger, by its number. Use instead of an account. At least 1.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.
- Cursor (`cursor`, text): The next_cursor from an earlier page, to get the page after it. Leave empty for the first page.
- Include failed transactions (`include_failed`, true/false): Also include those from transactions that failed. Default: `false`.

**Outputs**

- `count` (number): How many transactions came back.
- `next_cursor` (text): Give this as Cursor to get the next page; empty when nothing came back.
- `transactions` (list): The transactions.

**Example output**

```json
{
  "count": 1,
  "next_cursor": "279381936068558848",
  "transactions": [
    {
      "created_at": "2026-10-20T21:34:23Z",
      "fee_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
      "fee_charged": "0.0010000",
      "hash": "d32b9173ed5e0dd34c2192bb9d8515d604e357a476b401f0773837f684f3ecd9",
      "is_fee_bump": false,
      "ledger": 65049256,
      "max_fee": "0.0010000",
      "memo": "LMNS Mining & XLM Rewards",
      "memo_type": "text",
      "operation_count": 100,
      "source_account": "GCEQUY45QRSYUYHHFM5IAXLINJQ2PCWQ7CRMRO4RCOLTOGHUIRVDDSJG",
      "successful": true
    }
  ]
}
```
