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