list.mdx

title	order
List All Assets	20

import { Endpoint } from "components/Endpoint"; import { ExampleResponse } from "components/ExampleResponse"; import { CodeExample } from "components/CodeExample"; import { AttributeTable } from "components/AttributeTable";

This endpoint lists all assets.

GET	/assets?asset_code{:asset_code}&asset_issuer={:account_id}&cursor={paging_token}&order={asc,desc}&limit={1-200}&include_failed{true,false}

• ARGUMENT
  • REQUIRED
  • DESCRIPTION
• asset_code
  • optional
  • The code of the asset you would like to filter by.
• asset_issuer
  • optional
  • The Stellar address of the issuer for the asset you would like to filter by.
• cursor
  • optional
  • A string pointing to a specific location in a collection of responses, pulled from the paging_token value of a record.
• order
  • optional
  • A designation of the order in which records should appear. Options include asc(ascending) or desc (descending). If this argument isn’t set, it defaults to asc.
• limit
  • optional
  • The total number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.

curl "https://horizon.stellar.org/assets?asset_code=CNY&limit=3"

var StellarSdk = require("stellar-sdk");
var server = new StellarSdk.Server("https://horizon.stellar.org");

server
  .assets()
  .forCode("CNY")
  .call()
  .then(function (resp) {
    console.log(resp);
  })
  .catch(function (err) {
    console.error(err);
  });

{
  "_links": {
    "self": {
      "href": "https://horizon.stellar.org/assets?asset_code=CNY\u0026cursor=\u0026limit=3\u0026order=asc"
    },
    "next": {
      "href": "https://horizon.stellar.org/assets?asset_code=CNY\u0026cursor=CNY_GATEMHCCKCY67ZUCKTROYN24ZYT5GK4EQZ65JJLDHKHRUZI3EUEKMTCH_credit_alphanum4\u0026limit=3\u0026order=asc"
    },
    "prev": {
      "href": "https://horizon.stellar.org/assets?asset_code=CNY\u0026cursor=CNY_GAOT23KBW2HL6HVZFPNFLLT5VGIKGTLGR3AFDHYSRIWS4QKBYRPUW4N3_credit_alphanum4\u0026limit=3\u0026order=desc"
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "toml": {
            "href": "https://stellar.chenyuzhifu.com/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum4",
        "asset_code": "CNY",
        "asset_issuer": "GAOT23KBW2HL6HVZFPNFLLT5VGIKGTLGR3AFDHYSRIWS4QKBYRPUW4N3",
        "paging_token": "CNY_GAOT23KBW2HL6HVZFPNFLLT5VGIKGTLGR3AFDHYSRIWS4QKBYRPUW4N3_credit_alphanum4",
        "accounts": {
          "authorized": 23,
          "authorized_to_maintain_liabilities": 11,
          "unauthorized": 6
        },
        "num_claimable_balances": 3,
        "balances": {
          "authorized": "997268.0000000",
          "authorized_to_maintain_liabilities": "498634.0000000",
          "unauthorized": "249317.0000000"
        },
        "claimable_balances_amount": "124658.5000000",
        "amount": "997268.0000000",
        "num_accounts": 23,
        "flags": {
          "auth_required": false,
          "auth_revocable": false,
          "auth_immutable": false
        }
      },
      {
        "_links": {
          "toml": {
            "href": "https://ripplefox.com/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum4",
        "asset_code": "CNY",
        "asset_issuer": "GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX",
        "paging_token": "CNY_GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX_credit_alphanum4",
        "accounts": {
          "authorized": 5514,
          "authorized_to_maintain_liabilities": 2757,
          "unauthorized": 1378
        },
        "num_claimable_balances": 551,
        "balances": {
          "authorized": "18318343.2623217",
          "authorized_to_maintain_liabilities": "7327337.3049290",
          "unauthorized": "2930934.9219720"
        },
        "claimable_balances_amount": "1172373.9687890",
        "amount": "18318343.2623217",
        "num_accounts": 5514,
        "flags": {
          "auth_required": false,
          "auth_revocable": false,
          "auth_immutable": false
        }
      },
      {
        "_links": {
          "toml": {
            "href": "https://naobtc.com/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum4",
        "asset_code": "CNY",
        "asset_issuer": "GATEMHCCKCY67ZUCKTROYN24ZYT5GK4EQZ65JJLDHKHRUZI3EUEKMTCH",
        "paging_token": "CNY_GATEMHCCKCY67ZUCKTROYN24ZYT5GK4EQZ65JJLDHKHRUZI3EUEKMTCH_credit_alphanum4",
        "accounts": {
          "authorized": 1,
          "authorized_to_maintain_liabilities": 0,
          "unauthorized": 0
        },
        "num_claimable_balances": 0,
        "balances": {
          "authorized": "0.0000000",
          "authorized_to_maintain_liabilities": "0.0000000",
          "unauthorized": "0.0000000"
        },
        "claimable_balances_amount": "0.0000000",
        "amount": "0.0000000",
        "num_accounts": 1,
        "flags": {
          "auth_required": false,
          "auth_revocable": false,
          "auth_immutable": false
        }
      }
    ]
  }
}

var StellarSdk = require("stellar-sdk");
var server = new StellarSdk.Server("https://horizon.stellar.org");

var callback = function (resp) {
  console.log(resp);
};

var es = server
  .assets()
  .forCode("CNY")
  .cursor("now")
  .stream({ onmessage: callback });