Skip to main content

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.

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

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

    Example
    {
      "_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",
            "flags": {
              "auth_required": false,
              "auth_revocable": false,
              "auth_immutable": false
            }
          }
        ]
      }
    }