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.

• balancesobject

  The number of units issued for this asset grouped by each trustline flag state.

• claimable_balances_amountstring

  The number of units in claimable balances for this asset.

• 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.

Example

{
  "_links": {
    "self": {
      "href": "https://horizon.stellar.org/assets?asset_code=USD\u0026asset_issuer=GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX\u0026cursor=\u0026limit=10\u0026order=asc"
    },
    "next": {
      "href": "https://horizon.stellar.org/assets?asset_code=USD\u0026asset_issuer=GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX\u0026cursor=USD_GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX_credit_alphanum4\u0026limit=10\u0026order=asc"
    },
    "prev": {
      "href": "https://horizon.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
        }
      }
    ]
  }
}