List all Accounts

GET 
/accounts

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

Request

Query Parameters

sponser string

Account ID of the sponsor. Every account in the response will either be sponsored by the given account ID or have a subentry (trustline, offer, or data entry) which is sponsored by the given account ID.

asset any

An issued asset represented as “Code:IssuerAccountID”. Every account in the response will have a trustline for the given asset.

signer string

Account ID of the signer. Every account in the response will have the given account ID as a signer.

liqudity_pool any

With this parameter, the results will include only accounts which have trustlines to the specified liquidity pool.

cursor integer

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

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

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.

Responses

200

Returns accounts based on provided filter: signer , asset, sponser or liquidity pool

application/json

Schema

Schema

_links

object

self

object

href linkrequired

templated boolean

next

object

href linkrequired

templated boolean

prev

object

href linkrequired

templated boolean

_embedded

object

records

object[]

Array [

_links

object

self

object

required

href linkrequired

templated boolean

transactions

object

required

href linkrequired

templated boolean

operations

object

required

href linkrequired

templated boolean

payments

object

required

href linkrequired

templated boolean

effects

object

required

href linkrequired

templated boolean

offers

object

required

href linkrequired

templated boolean

trades

object

required

href linkrequired

templated boolean

data

object

required

href linkrequired

templated boolean

id id (string)required

account_id address (string)required

Possible values: Value must match regular expression G[A-Z0-9]{55}

sequence sequence (string)required

Possible values: Value must match regular expression [0-9]+

sequence_ledger uint32

sequence_time string

subentry_count int32required

inflation_destination address (string)

Possible values: Value must match regular expression G[A-Z0-9]{55}

home_domain string

last_modified_ledger uint32required

last_modified_time stringrequired

thresholds

object

required

low_threshold integer

med_threshold integer

high_threshold integer

flags

object

required

auth_required boolean

auth_revocable boolean

auth_immutable boolean

auth_clawback_enabled boolean

balances

object[]

required

Array [

anyOf

BalanceLineNative

balance currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

liquidity_pool_id string

limit currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

buying_liabilites currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

selling_liabilites currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

sponser string

last_modified_ledger uint32required

is_authorized booleanrequired

is_authorized_to_maintain_liabilites booleanrequired

is_clawback_enabled booleanrequired

asset_type stringrequired

Possible values: [native]

BalanceLineAsset

balance currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

limit currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

buying_liabilites currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

selling_liabilites currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

sponser address (string)

Possible values: Value must match regular expression G[A-Z0-9]{55}

last_modified_ledger uint32required

is_authorized booleanrequired

is_authorized_to_maintain_liabilites booleanrequired

is_clawback_enabled booleanrequired

asset_type stringrequired

Possible values: [native, credit_alphanum4, credit_alphanum12]

asset_code stringrequired

asset_issuer address (string)required

Possible values: Value must match regular expression G[A-Z0-9]{55}

BalanceLineLiquidityPool

liquidity_pool_id stringrequired

asset_type stringrequired

Possible values: [liquidity_pool_shares]

balance currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

limit currency (string)required

Possible values: Value must match regular expression [0-9]+\.[0-9]{7}

last_modified_ledger uint32required

sponser address (string)

Possible values: Value must match regular expression G[A-Z0-9]{55}

is_authorized booleanrequired

is_authorized_to_maintain_liabilites booleanrequired

is_clawback_enabled booleanrequired

]

signers

object[]

required

Array [

key address (string)required

Possible values: Value must match regular expression G[A-Z0-9]{55}

weight int32required

type stringrequired

Possible values: [ed25519_public_key, sha256_hash, preauth_tx]

sponser address (string)

Possible values: Value must match regular expression G[A-Z0-9]{55}

]

data objectrequired

num_sponsoring integerrequired

num_sponsered integerrequired

sponser address (string)

Possible values: Value must match regular expression G[A-Z0-9]{55}

paging_token stringrequired

]

Example (from schema)

{
  "_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"
      }
    ]
  }
}

ListAllAccounts

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/accounts?cursor=&limit=10&order=asc&signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
    },
    "next": {
      "href": "https://horizon-testnet.stellar.org/accounts?cursor=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U&limit=10&order=asc&signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
    },
    "prev": {
      "href": "https://horizon-testnet.stellar.org/accounts?cursor=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U&limit=10&order=desc&signer=GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/operations{?cursor,limit,order}",
            "templated": true
          },
          "payments": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/payments{?cursor,limit,order}",
            "templated": true
          },
          "effects": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/effects{?cursor,limit,order}",
            "templated": true
          },
          "offers": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/offers{?cursor,limit,order}",
            "templated": true
          },
          "trades": {
            "href": "https://horizon-testnet.stellar.org/accounts/GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U/trades{?cursor,limit,order}",
            "templated": true
          },
          "data": {
            "href": "https://horizon-testnet.stellar.org/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": 40074676,
        "last_modified_time": "2022-03-17T23:13:54Z",
        "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.8944518",
            "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"
      }
    ]
  }
}

Loading...