Search the token registry

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/assets?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/assets?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/assets?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "asset_type": "credit_alphanum4",
        "code": "USDC",
        "contract_id": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
        "decimals": 7,
        "first_seen_ledger": 0,
        "flags": [
          "auth_revocable"
        ],
        "holder_count": 39417,
        "home_domain": "centre.io",
        "issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "kind": "classic",
        "layout": "sac",
        "metadata_source": null,
        "name": null,
        "paging_token": "eyJhIjoiVVNEQzpHQkJENDdJRjZMV0s3UDdNREVWU0NXUjdEUFVXVjNOWTNEVFFFVkZMNE5BVDRBUUgzWkxMRkxBNSIsIm4iOjM5NDE3fQ",
        "supply": "36968702153.4255427",
        "supply_raw": "369687021534255427",
        "supply_source": "exact",
        "symbol": null,
        "toml": null,
        "verified": true
      },
      {
        "asset": "CAUGJT4GREIY3WHOUUU5RIUDGSPVREF5CDCYJOWMHOVT2GWQT5JEETGJ",
        "asset_type": "contract",
        "code": "USDC",
        "contract_id": "CAUGJT4GREIY3WHOUUU5RIUDGSPVREF5CDCYJOWMHOVT2GWQT5JEETGJ",
        "decimals": 7,
        "first_seen_ledger": 0,
        "flags": [
          "impersonation_risk"
        ],
        "holder_count": 10055,
        "home_domain": null,
        "issuer": null,
        "kind": "sep41",
        "layout": "balance_i128",
        "metadata_source": "instance_storage",
        "name": "Test USDC",
        "paging_token": "eyJhIjoiQ0FVR0pUNEdSRUlZM1dIT1VVVTVSSVVER1NQVlJFRjVDRENZSk9XTUhPVlQyR1dRVDVKRUVUR0oiLCJuIjoxMDA1NX0",
        "supply": "1710004492581.2111110",
        "supply_raw": "17100044925812111110",
        "supply_source": "derived",
        "symbol": "USDC",
        "toml": null,
        "verified": true
      }
    ]
  },
  "_links": {
    "next": {
      "href": "/assets?cursor=eyJhIjoiQ0IzVExXNzROQklPVDNCVVdPWjNUVU02UkZERjZBNEdWSVJVUVJRWkFCRzVLUE9VTDRKSk9WMkYiLCJuIjo2NDB9&limit=10&q=USDC"
    },
    "self": {
      "href": "/assets?q=USDC&limit=10"
    }
  },
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332635,
    "as_of_closed_at": "2026-10-22T16:32:42Z",
    "bootstrap_ledger": 5253887
  }
}

GET

assets

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/assets?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/assets?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/assets?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "asset_type": "credit_alphanum4",
        "code": "USDC",
        "contract_id": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
        "decimals": 7,
        "first_seen_ledger": 0,
        "flags": [
          "auth_revocable"
        ],
        "holder_count": 39417,
        "home_domain": "centre.io",
        "issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "kind": "classic",
        "layout": "sac",
        "metadata_source": null,
        "name": null,
        "paging_token": "eyJhIjoiVVNEQzpHQkJENDdJRjZMV0s3UDdNREVWU0NXUjdEUFVXVjNOWTNEVFFFVkZMNE5BVDRBUUgzWkxMRkxBNSIsIm4iOjM5NDE3fQ",
        "supply": "36968702153.4255427",
        "supply_raw": "369687021534255427",
        "supply_source": "exact",
        "symbol": null,
        "toml": null,
        "verified": true
      },
      {
        "asset": "CAUGJT4GREIY3WHOUUU5RIUDGSPVREF5CDCYJOWMHOVT2GWQT5JEETGJ",
        "asset_type": "contract",
        "code": "USDC",
        "contract_id": "CAUGJT4GREIY3WHOUUU5RIUDGSPVREF5CDCYJOWMHOVT2GWQT5JEETGJ",
        "decimals": 7,
        "first_seen_ledger": 0,
        "flags": [
          "impersonation_risk"
        ],
        "holder_count": 10055,
        "home_domain": null,
        "issuer": null,
        "kind": "sep41",
        "layout": "balance_i128",
        "metadata_source": "instance_storage",
        "name": "Test USDC",
        "paging_token": "eyJhIjoiQ0FVR0pUNEdSRUlZM1dIT1VVVTVSSVVER1NQVlJFRjVDRENZSk9XTUhPVlQyR1dRVDVKRUVUR0oiLCJuIjoxMDA1NX0",
        "supply": "1710004492581.2111110",
        "supply_raw": "17100044925812111110",
        "supply_source": "derived",
        "symbol": "USDC",
        "toml": null,
        "verified": true
      }
    ]
  },
  "_links": {
    "next": {
      "href": "/assets?cursor=eyJhIjoiQ0IzVExXNzROQklPVDNCVVdPWjNUVU02UkZERjZBNEdWSVJVUVJRWkFCRzVLUE9VTDRKSk9WMkYiLCJuIjo2NDB9&limit=10&q=USDC"
    },
    "self": {
      "href": "/assets?q=USDC&limit=10"
    }
  },
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332635,
    "as_of_closed_at": "2026-10-22T16:32:42Z",
    "bootstrap_ledger": 5253887
  }
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <key>, the same keys as Activity and RPC. Testnet: lum_test_…; Mainnet: lum_live_…. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable lum_pub_… keys work only on the routes marked "Publishable keys allowed", from an allowed browser origin.

Query Parameters

string

Case-insensitive code or symbol prefix, 1 to 64 characters.

Required string length: 1 - 64

Example:

"USDC"

kind

enum<string>

Only this kind: native (XLM), classic (CODE:ISSUER assets) or sep41 (custom contract tokens).

Available options:

native,

classic,

sep41

Example:

"classic"

verified

enum<string>

true: only tokens whose balances are read from ledger entries or a recognized SEP-41 layout; false: only the others.

Available options:

true,

false

Example:

"true"

limit

integer

default:50

Records per page, 1 to 200 (default 50).

Required range: 1 <= x <= 200

Example:

10

cursor

string

Resume after this paging_token. Prefer following _links.next.href.

Response

A page of registry records, most holders first.

read_view

object

required

Show child attributes

limit

integer

required

Effective page size: default 50, maximum 200.

_links

object

required

Show child attributes

_embedded

object

required

Show child attributes

Activity API

Assets API

Webhooks

RPC

Account

Search the token registry

Authorizations

Query Parameters

Response