The Asset Object
When Horizon returns information about an asset, it uses the following format:
ATTRIBUTEDATA TYPE
DESCRIPTION
asset_typestring
This asset's type. Either credit_alphanum4
or credit_alphanum12
.
asset_codestring
This asset's code
asset_issuerstring
The Stellar address of this asset’s issuer.
accountsobject
The number of accounts grouped by each trustline flag state.
num_claimable_balancesnumber
The current number of claimable_balances for this asset.
num_contractsnumber
The current number of Soroban contracts holding this asset.
num_liquidity_poolsnumber
The current number of liquidity pools holding this asset.
balancesobject
The number of units issued for this asset grouped by each trustline flag state.
claimable_balances_amountstring
The number of units for this asset held by all claimable balances.
contracts_amountstring
The number of units for this asset held by all Soroban contracts.
liquidity_pools_amountstring
The number of units for this asset held by all liquidity pools.
amountstring
The number of authorized units issued for this asset. This will be deprecated in Horizon v3.
num_accountsnumber
The number of accounts that have issued a trustline to this asset. If the auth_required
flag for this asset's issuer is set to true
, this number only includes the accounts who have both set up a trustline to the asset and have been authorized to hold the asset. This will be deprecated in Horizon v3.
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.
paging_tokennumber
A cursor value for use in pagination.
{
"_links": {
"self": {
"href": "https://horizon-testnet.stellar.org/assets?asset_code=USD\u0026asset_issuer=GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX\u0026cursor=\u0026limit=10\u0026order=asc"
},
"next": {
"href": "https://horizon-testnet.stellar.org/assets?asset_code=USD\u0026asset_issuer=GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX\u0026cursor=USD_GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX_credit_alphanum4\u0026limit=10\u0026order=asc"
},
"prev": {
"href": "https://horizon-testnet.stellar.org/assets?asset_code=USD\u0026asset_issuer=GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX\u0026cursor=USD_GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX_credit_alphanum4\u0026limit=10\u0026order=desc"
}
},
"_embedded": {
"records": [
{
"_links": {
"toml": {
"href": "https://www.anchorusd.com/.well-known/stellar.toml"
}
},
"asset_type": "credit_alphanum4",
"asset_code": "USD",
"asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX",
"paging_token": "USD_GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX_credit_alphanum4",
"accounts": {
"authorized": 9390,
"authorized_to_maintain_liabilities": 1240,
"unauthorized": 5
},
"num_claimable_balances": 253,
"balances": {
"authorized": "1347404.4083346",
"authorized_to_maintain_liabilities": "177931.9984610",
"unauthorized": "717.4677360"
},
"claimable_balances_amount": "36303.8674450",
"amount": "1347404.4083346",
"num_accounts": 9390,
"flags": {
"auth_required": false,
"auth_revocable": false,
"auth_immutable": false
}
}
]
}
}