For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

Stellar — Accounts (1/3)

API reference for Stellar. All methods ->

Part 1 of 3: 1 · 2 · 3

Accounts​

Users interact with the Stellar network through accounts. Everything else in the ledger—assets, offers, trustlines, etc.—are owned by accounts, and accounts must authorize all changes to the ledger through signed transactions.

GET /accounts​

Retrieves all accounts matching a filter.

This endpoint lists accounts by one of four filters : signer, asset, liquidity pool or sponsor.

Parameters​

  • sponsor (string; query): account ID of the sponsor. Every account in the response will either be sponsored by the given account ID or have a subentry (trust line, offer, or data entry) which is sponsored by the given account ID.
  • asset (any; query): an issued asset represented as “Code:IssuerAccountID”. Every account in the response will have a trust line for the given asset.
  • signer (string; query): account ID of the signer. Every account in the response will have the given account ID as a signer.
  • liqudity_pool (any; query): with this parameter, the results will include only accounts which have trust lines to the specified liquidity pool.
  • cursor (integer; query): a number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.
  • order (string; query): possible values: [asc, desc]. A designation of the order in which records should appear. Options include asc (ascending) or desc (descending). If this argument isn’t set, it defaults to asc.
  • limit (integer; query): the maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.

Returns​

{
  "_links": {
    "self": {
      "href": "string",
      "templated": true
    },
    "next": {
      "href": "string",
      "templated": true
    },
    "prev": {
      "href": "string",
      "templated": true
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "string",
            "templated": true
          },
          "transactions": {
            "href": "string",
            "templated": true
          },
          "operations": {
            "href": "string",
            "templated": true
          },
          "payments": {
            "href": "string",
            "templated": true
          },
          "effects": {
            "href": "string",
            "templated": true
          },
          "offers": {
            "href": "string",
            "templated": true
          },
          "trades": {
            "href": "string",
            "templated": true
          },
          "data": {
            "href": "string",
            "templated": true
          }
        },
        "id": "string",
        "account_id": "string",
        "sequence": "string",
        "sequence_ledger": 0,
        "sequence_time": "string",
        "subentry_count": 0,
        "inflation_destination": "string",
        "home_domain": "string",
        "last_modified_ledger": 0,
        "last_modified_time": "string",
        "thresholds": {
          "low_threshold": 0,
          "med_threshold": 0,
          "high_threshold": 0
        },
        "flags": {
          "auth_required": true,
          "auth_revocable": true,
          "auth_immutable": true,
          "auth_clawback_enabled": true
        },
        "balances": [
          {
            "balance": "string",
            "liquidity_pool_id": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native"
          },
          {
            "balance": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native",
            "asset_code": "string",
            "asset_issuer": "string"
          },
          {
            "liquidity_pool_id": "string",
            "asset_type": "liquidity_pool_shares",
            "balance": "string",
            "limit": "string",
            "last_modified_ledger": 0,
            "sponser": "string",
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true
          }
        ],
        "signers": [
          {
            "key": "string",
            "weight": 0,
            "type": "ed25519_public_key",
            "sponser": "string"
          }
        ],
        "data": {},
        "num_sponsoring": 0,
        "num_sponsered": 0,
        "sponser": "string",
        "paging_token": "string"
      }
    ]
  }
}

Request example​

curl https://rpc.ankr.com/http/stellar_horizon/accounts{?signer,sponsor,asset,liquidity_pool,cursor,limit,order}

Response example​

{
    "_links": {
        "self": {
            "href": "https://rpc.ankr.com/accounts?cursor=\u0026limit=2\u0026order=desc\u0026signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
        },
        "next": {
            "href": "https://rpc.ankr.com/accounts?cursor=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U\u0026limit=2\u0026order=desc\u0026signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
        },
        "prev": {
            "href": "https://rpc.ankr.com/accounts?cursor=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U\u0026limit=2\u0026order=asc\u0026signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
        }
    },
    "_embedded": {
        "records": [
            {
                "_links": {
                    "self": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
                    },
                    "transactions": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/transactions{?cursor,limit,order}",
                        "templated": true
                    },
                    "operations": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/operations{?cursor,limit,order}",
                        "templated": true
                    },
                    "payments": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/payments{?cursor,limit,order}",
                        "templated": true
                    },
                    "effects": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/effects{?cursor,limit,order}",
                        "templated": true
                    },
                    "offers": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/offers{?cursor,limit,order}",
                        "templated": true
                    },
                    "trades": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/trades{?cursor,limit,order}",
                        "templated": true
                    },
                    "data": {
                        "href": "https://rpc.ankr.com/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/data/{key}",
                        "templated": true
                    }
                },
                "id": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
                "account_id": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
                "sequence": "24739097524306474",
                "subentry_count": 3,
                "inflation_destination": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
                "home_domain": "tempo.eu.com",
                "last_modified_ledger": 46469501,
                "last_modified_time": null,
                "thresholds": {
                    "low_threshold": 5,
                    "med_threshold": 0,
                    "high_threshold": 0
                },
                "flags": {
                    "auth_required": false,
                    "auth_revocable": true,
                    "auth_immutable": false,
                    "auth_clawback_enabled": false
                },
                "balances": [
                    {
                        "balance": "0.0000000",
                        "limit": "922337203685.4775807",
                        "buying_liabilities": "0.0000000",
                        "selling_liabilities": "0.0000000",
                        "last_modified_ledger": 40074670,
                        "is_authorized": true,
                        "is_authorized_to_maintain_liabilities": true,
                        "asset_type": "credit_alphanum4",
                        "asset_code": "EURT",
                        "asset_issuer": "GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
                    },
                    {
                        "balance": "0.0000000",
                        "limit": "922337203685.4775807",
                        "buying_liabilities": "0.0000000",
                        "selling_liabilities": "0.0000000",
                        "last_modified_ledger": 20213845,
                        "is_authorized": true,
                        "is_authorized_to_maintain_liabilities": true,
                        "asset_type": "credit_alphanum4",
                        "asset_code": "NGN",
                        "asset_issuer": "GCC4YLCR7DDWFCIPTROQM7EB2QMFD35XRWEQVIQYJQHVW6VE5MJZXIGW"
                    },
                    {
                        "balance": "0.0000000",
                        "limit": "922337203685.4775807",
                        "buying_liabilities": "0.0000000",
                        "selling_liabilities": "0.0000000",
                        "last_modified_ledger": 7877447,
                        "is_authorized": false,
                        "is_authorized_to_maintain_liabilities": false,
                        "asset_type": "credit_alphanum4",
                        "asset_code": "PHP",
                        "asset_issuer": "GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP"
                    },
                    {
                        "balance": "80.8945748",
                        "buying_liabilities": "0.0000000",
                        "selling_liabilities": "0.0000000",
                        "asset_type": "native"
                    }
                ],
                "signers": [
                    {
                        "weight": 10,
                        "key": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
                        "type": "ed25519_public_key"
                    }
                ],
                "data": {},
                "num_sponsoring": 0,
                "num_sponsored": 0,
                "paging_token": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
            }
        ]
    }
}

Accounts​

GET /accounts/{account_id}​

Retrieves account info by account ID.

The single account endpoint provides information on a specific account. The balances section in the response will also list all the trust lines this account has established, including trust lines that haven’t been authorized yet.

Parameters​

  • account_id (string; path; required): the account’s public key encoded in a base32 string representation.

Returns​

{
  "_links": {
    "self": {
      "href": "string",
      "templated": true
    },
    "next": {
      "href": "string",
      "templated": true
    },
    "prev": {
      "href": "string",
      "templated": true
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "string",
            "templated": true
          },
          "transactions": {
            "href": "string",
            "templated": true
          },
          "operations": {
            "href": "string",
            "templated": true
          },
          "payments": {
            "href": "string",
            "templated": true
          },
          "effects": {
            "href": "string",
            "templated": true
          },
          "offers": {
            "href": "string",
            "templated": true
          },
          "trades": {
            "href": "string",
            "templated": true
          },
          "data": {
            "href": "string",
            "templated": true
          }
        },
        "id": "string",
        "account_id": "string",
        "sequence": "string",
        "sequence_ledger": 0,
        "sequence_time": "string",
        "subentry_count": 0,
        "inflation_destination": "string",
        "home_domain": "string",
        "last_modified_ledger": 0,
        "last_modified_time": "string",
        "thresholds": {
          "low_threshold": 0,
          "med_threshold": 0,
          "high_threshold": 0
        },
        "flags": {
          "auth_required": true,
          "auth_revocable": true,
          "auth_immutable": true,
          "auth_clawback_enabled": true
        },
        "balances": [
          {
            "balance": "string",
            "liquidity_pool_id": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native"
          },
          {
            "balance": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native",
            "asset_code": "string",
            "asset_issuer": "string"
          },
          {
            "liquidity_pool_id": "string",
            "asset_type": "liquidity_pool_shares",
            "balance": "string",
            "limit": "string",
            "last_modified_ledger": 0,
            "sponser": "string",
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true
          }
        ],
        "signers": [
          {
            "key": "string",
            "weight": 0,
            "type": "ed25519_public_key",
            "sponser": "string"
          }
        ],
        "data": {},
        "num_sponsoring": 0,
        "num_sponsered": 0,
        "sponser": "string",
        "paging_token": "string"
      }
    ]
  }
}

Request example​

curl https://rpc.ankr.com/http/stellar_horizon/accounts/{account_id}

Response example​

{
    "_links": {
        "self": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA"
        },
        "transactions": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/transactions{?cursor,limit,order}",
            "templated": true
        },
        "operations": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/operations{?cursor,limit,order}",
            "templated": true
        },
        "payments": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/payments{?cursor,limit,order}",
            "templated": true
        },
        "effects": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/effects{?cursor,limit,order}",
            "templated": true
        },
        "offers": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/offers{?cursor,limit,order}",
            "templated": true
        },
        "trades": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/trades{?cursor,limit,order}",
            "templated": true
        },
        "data": {
            "href": "https://rpc.ankr.com/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/data/{key}",
            "templated": true
        }
    },
    "id": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
    "account_id": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
    "sequence": "120192344968520093",
    "subentry_count": 6,
    "last_modified_ledger": 48375369,
    "last_modified_time": null,
    "thresholds": {
        "low_threshold": 0,
        "med_threshold": 0,
        "high_threshold": 0
    },
    "flags": {
        "auth_required": false,
        "auth_revocable": false,
        "auth_immutable": false,
        "auth_clawback_enabled": false
    },
    "balances": [
        {
            "balance": "1.0000000",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 27984972,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "BB1",
            "asset_issuer": "GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN"
        },
        {
            "balance": "20.0000000",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 27984988,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "CNY",
            "asset_issuer": "GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX"
        },
        {
            "balance": "3.0000008",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 34781349,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "EURT",
            "asset_issuer": "GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
        },
        {
            "balance": "194.9999990",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 28524340,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "NGNT",
            "asset_issuer": "GAWODAROMJ33V5YDFY3NPYTHVYQG7MJXVJ2ND3AOGIHYRWINES6ACCPD"
        },
        {
            "balance": "2.5000000",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 29107236,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "USD",
            "asset_issuer": "GBNLJIYH34UWO5YZFA3A3HD3N76R6DOI33N4JONUOHEEYZYCAYTEJ5AK"
        },
        {
            "balance": "3.1200000",
            "limit": "922337203685.4775807",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "last_modified_ledger": 29882476,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilities": true,
            "asset_type": "credit_alphanum4",
            "asset_code": "USD",
            "asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX"
        },
        {
            "balance": "15.7298615",
            "buying_liabilities": "0.0000000",
            "selling_liabilities": "0.0000000",
            "asset_type": "native"
        }
    ],
    "signers": [
        {
            "weight": 1,
            "key": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
            "type": "ed25519_public_key"
        }
    ],
    "data": {},
    "num_sponsoring": 0,
    "num_sponsored": 0,
    "paging_token": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA"
}