Skip to main content

The Account Object

When Horizon returns information about an account, it uses the following format:

  • ATTRIBUTEDATA TYPE

    DESCRIPTION

  • idstring

    A unique identifier for this account.

  • account_idstring

    This account's public key encoded in a base32 string representation.

  • sequencenumber

    This account's current sequence number. For use when submitting this account's next transaction.

  • sequence_ledgernumber

    The unsigned 32-bit ledger number of the sequence number's age.

  • sequence_timestring

    The unsigned 64-bit UNIX timestamp of the sequence number's age.

  • subentry_countnumber

    The number of subentries on this account.

  • home_domainstring

    The domain that hosts this account's stellar.toml file.

  • last_modified_ledgernumber

    The ID of the last ledger that included changes to this account.

  • num_sponsoringnumber

    The number of reserves sponsored by this account.

  • num_sponsorednumber

    The number of reserves sponsored for this account.

  • sponsorstring (optional)

    The account ID of the sponsor who is paying the reserves for this account.

  • thresholdsobject

    Operations have varying levels of access. This field specifies thresholds for different access levels, as well as the weight of the master key.

    Show child attributes
  • low_thresholdnumber

    The weight required for a valid transaction including the Allow Trust and Bump Sequence operations.

  • med_thresholdnumber

    The weight required for a valid transaction including the Create Account, Payment, Path Payment, Manage Buy Offer, Manage Sell Offer, Create Passive Sell Offer, Change Trust, Inflation, and Manage Data operations.

  • high_thresholdnumber

    The weight required for a valid transaction including the Account Merge and Set Options operations.

  • flagsobject

    Flags denote the enabling/disabling of certain asset issuer privileges.

    Show child attributes
  • auth_immutableboolean

    If set to true, none of the following flags can be changed.

  • auth_requiredboolean

    If set to true, anyone who wants to hold an asset issued by this account must first be approved by this account.

  • auth_revocableboolean

    If set to true, this account can freeze the balance of a holder of an asset issued by this account.

  • auth_clawback_enabledboolean

    If set to true, trustlines created for assets issued by this account have clawbacks enabled.

  • balancesobject

    The assets this account holds.

    Show child attributes
  • balancestring

    The number of units of an asset held by this account.

  • buying_liabilitiesstring (optional)

    The sum of all buy offers owned by this account for this asset.

  • selling_liabilitiesstring (optional)

    The sum of all sell offers owned by this account for this asset.

  • limitnumber (optional)

    The maximum amount of this asset that this account is willing to accept. Specified when opening a trustline.

  • asset_typestring

    Either native, credit_alphanum4, credit_alphanum12, or liquidity_pool_shares.

  • asset_codestring (optional)

    The code for this asset.

  • asset_issuerstring (optional)

    The Stellar address of this asset's issuer.

  • sponsorstring (optional)

    The account ID of the sponsor who is paying the reserves for this trustline.

  • signersarray of objects

    The public keys and associated weights that can be used to authorize transactions for this account. Used for multi-sig.

    Show child attributes
  • public_keystring

    REMOVED in 0.17.0: USE key INSTEAD.

  • weightnumber

    The numerical weight of a signer. Used to determine if a transaction meets the threshold requirements.

  • sponsorstring (optional)

    The account ID of the sponsor who is paying the reserves for this signer.

  • keystring

    A hash of characters dependent on the signer type.

  • typestring

    The type of hash for this signer.

    Show child attributes
  • ed25519_public_key

    A normal Stellar public key.

  • sha256_hash

    The SHA256 hash of some arbitrary x. Adding a signature of this type allows anyone who knows x to sign a transaction from this account. Note: Once this transaction is broadcast, x will be known publicly.

  • preauth_tx

    The hash of a pre-authorized transaction. This signer is automatically removed from the account when a matching transaction is properly applied.

  • dataobject

    An array of account data fields.

  • The latest ledger known to Horizon is included as an HTTP header in the response.

    Example
    {
    "_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": "24739097524306468",
    "subentry_count": 3,
    "inflation_destination": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
    "home_domain": "tempo.eu.com",
    "last_modified_ledger": 23569316,
    "num_sponsoring": 0,
    "num_sponsored": 0,
    "thresholds": {
    "low_threshold": 5,
    "med_threshold": 0,
    "high_threshold": 0
    },
    "flags": {
    "auth_required": false,
    "auth_revocable": true,
    "auth_immutable": false,
    "auth_clawback_enabled": true
    },
    "balances": [
    {
    "balance": "1.0000005",
    "limit": "922337203685.4775807",
    "buying_liabilities": "0.0000000",
    "selling_liabilities": "0.0000000",
    "last_modified_ledger": 22651481,
    "is_authorized": true,
    "is_clawback_enabled": false,
    "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": 7877447,
    "is_authorized": false,
    "is_clawback_enabled": false,
    "asset_type": "credit_alphanum4",
    "asset_code": "PHP",
    "asset_issuer": "GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP"
    },
    {
    "balance": "0.0000000",
    "limit": "922337203685.4775807",
    "buying_liabilities": "0.0000000",
    "selling_liabilities": "0.0000000",
    "last_modified_ledger": 20213845,
    "is_authorized": true,
    "is_clawback_enabled": false,
    "asset_type": "credit_alphanum4",
    "asset_code": "NGN",
    "asset_issuer": "GCC4YLCR7DDWFCIPTROQM7EB2QMFD35XRWEQVIQYJQHVW6VE5MJZXIGW"
    },
    {
    "balance": "198.8944970",
    "buying_liabilities": "0.0000000",
    "selling_liabilities": "0.0000000",
    "asset_type": "native"
    }
    ],
    "signers": [
    {
    "weight": 10,
    "key": "GDI73WJ4SX7LOG3XZDJC3KCK6ED6E5NBYK2JUBQSPBCNNWEG3ZN7T75U",
    "type": "ed25519_public_key"
    }
    ],
    "data": {},
    "paging_token": ""
    }