---
title: "Asset holders list"
method: GET
path: "/explorer/{network}/asset/{asset}/holders"
tags: ["Asset Info API"]
---

# Asset holders list

`GET /explorer/{network}/asset/{asset}/holders`

Returns a list of all accounts holding non-zero amount of the given asset sorted by the balance size. Accounts with an established trustline but with zero balance excluded from the results set.
This API endpoint follows Stellar Horizon API response format convention. A response result contains records and navigation links.

## Path parameters

- `network` 'public' | 'testnet', required — Stellar network
- `asset` string, required — An asset in the format {CODE}-{ISSUER} (or "XLM" for Stellar lumens)

## Response `200`

Asset holders fetched

- object — List API response
  - `_links` object
    - `self` ListApiResponseNavLink
      - `href` string
    - `prev` ListApiResponseNavLink
      - `href` string
    - `next` ListApiResponseNavLink
      - `href` string
  - `_embedded` object
    - `records` AssetHolder[]
      - `account` string — Account address (ED25519 public key)
      - `balance` string — Asset balance in stroops
      - `paging_token` string — Paging token

## Other responses

- `400` — Invalid request parameters
- `404` — Asset not found

## Changes

- **2022-09-03** `ed63dd29618f` — 1 breaking, 1 warning
  - the `allOf[subschema #2]/_embedded/records/items/paging_token` response's property type changed from `integer` to `string` for status `200`
  - removed the optional property `allOf[subschema #2]/_embedded/records/items/position` from the response with the `200` status
- **2022-06-01** `e95744a13be0` — 1 breaking, 1 info
  - the `allOf[subschema #2]/_embedded/records/items/paging_token` response's property type changed from `string` to `integer` for status `200`
  - added the optional property `allOf[subschema #2]/_embedded/records/items/position` to the response with the `200` status

[Change history](https://skmtc.dev/stellar-expert/apis/stellarexpert-api/changes/explorer/:network/asset/:asset/holders/get.md)

---

[API](https://skmtc.dev/stellar-expert/apis/stellarexpert-api.md) · [All operations](https://skmtc.dev/stellar-expert/apis/stellarexpert-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stellar-expert/stellarexpert-api/revisions/5d96955edab4/schema)