All Assets  [Go SDK]

This endpoint represents all assets. It will give you all the assets in the system along with various statistics about each.

Notes

• The attribute num_accounts includes authorized trust lines only.

Request

GET /assets{?asset_code,asset_issuer,cursor,limit,order}

Arguments

curl Example Request

# Retrieve the 200 assets, ordered alphabetically:
curl "https://horizon-testnet.stellar.org/assets?limit=200"

JavaScript Example Request

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

server.assets()
  .call()
  .then(function (result) {
    console.log(result.records);
  })
  .catch(function (err) {
    console.log(err)
  })

Response

If called normally this endpoint responds with a page of assets.

Example Response

{
  "_links": {
    "self": {
      "href": "/assets?order=asc\u0026limit=10\u0026cursor="
    },
    "next": {
      "href": "/assets?order=asc\u0026limit=10\u0026cursor=3"
    },
    "prev": {
      "href": "/assets?order=desc\u0026limit=10\u0026cursor=1"
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "toml": {
            "href": "https://www.stellar.org/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum12",
        "asset_code": "BANANA",
        "asset_issuer": "GDSBCQO34HWPGUGQSP3QBFEXVTSR2PW46UIGTHVWGWJGQKH3AFNHXHXN",
        "paging_token": "BANANA_GDSBCQO34HWPGUGQSP3QBFEXVTSR2PW46UIGTHVWGWJGQKH3AFNHXHXN_credit_alphanum4",
        "amount": "10000.0000000",
        "num_accounts": 2126,
        "flags": {
          "auth_required": true,
          "auth_revocable": false
        }
      },
      {
        "_links": {
          "toml": {
            "href": "https://www.stellar.org/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum4",
        "asset_code": "BTC",
        "asset_issuer": "GBAUUA74H4XOQYRSOW2RZUA4QL5PB37U3JS5NE3RTB2ELJVMIF5RLMAG",
        "paging_token": "BTC_GBAUUA74H4XOQYRSOW2RZUA4QL5PB37U3JS5NE3RTB2ELJVMIF5RLMAG_credit_alphanum4",
        "amount": "5000.0000000",
        "num_accounts": 32,
        "flags": {
          "auth_required": false,
          "auth_revocable": false
        }
      },
      {
        "_links": {
          "toml": {
            "href": "https://www.stellar.org/.well-known/stellar.toml"
          }
        },
        "asset_type": "credit_alphanum4",
        "asset_code": "USD",
        "asset_issuer": "GBAUUA74H4XOQYRSOW2RZUA4QL5PB37U3JS5NE3RTB2ELJVMIF5RLMAG",
        "paging_token": "USD_GBAUUA74H4XOQYRSOW2RZUA4QL5PB37U3JS5NE3RTB2ELJVMIF5RLMAG_credit_alphanum4",
        "amount": "1000000000.0000000",
        "num_accounts": 91547871,
        "flags": {
          "auth_required": false,
          "auth_revocable": false
        }
      }
    ]
  }
}

Possible Errors

• The standard errors.