> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stellartools.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Assets

> Query supported Stellar assets

An asset represents a Stellar token that StellarTools accepts as payment — USDC, EURC, XLM, or any other asset your organization has enabled.

## The asset object

**code** `string`

The Stellar asset code, e.g. `"USDC"`, `"XLM"`, `"EURC"`.

**description** `string`

Human-readable description of the asset, e.g. `"USD Coin"`.

**canonicalIssuer** `string | null`

The Stellar public key of the canonical issuer for this asset. `null` for native XLM, which has no issuer.

This is the authoritative issuer your integration should reference — for example, Circle's address for USDC. During one-time checkouts the DEX routes from any issuer the customer holds automatically, so you never need to resolve issuers yourself. For subscriptions, the smart contract uses this exact issuer.

**images** `array`

Array of image URLs for the asset logo.

***

## List supported assets

`GET /assets`

Returns all assets enabled for your account's environment (testnet or mainnet, determined by your API key).

```bash theme={null}
curl https://api.stellartools.dev/assets \
  -H "x-api-key: YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "data": [
    {
      "code": "USDC",
      "description": "USD Coin",
      "canonicalIssuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "images": []
    },
    {
      "code": "EURC",
      "description": "Euro Coin",
      "canonicalIssuer": "GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP",
      "images": []
    },
    {
      "code": "XLM",
      "description": "Stellar Lumens",
      "canonicalIssuer": null,
      "images": []
    }
  ]
}
```

This endpoint is useful for dynamically populating payment asset selectors in your storefront or checkout UI, so you always reflect the exact assets your account supports without hardcoding them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.