---
title: "List stablecoins"
method: GET
path: "/stablecoins"
tags: ["Stablecoins"]
---

# List stablecoins

`GET /stablecoins`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/stablecoins`
- Auth: HTTP basic

Retrieve stablecoins registered to the authenticated platform.

## Query parameters

- `issuanceStatus` 'PENDING_REVIEW' | 'PROVISIONING' | 'PROVISIONED' | 'REJECTED' | 'FAILED': Provider issuance/linking status for the registered stablecoin.
- `gridOperationsStatus` 'NOT_ENABLED' | 'PENDING_APPROVAL' | 'ENABLING' | 'ENABLED' | 'DISABLED': Whether the stablecoin has been enabled for normal Grid operations.
- `provider` 'BRALE': Stablecoin provider backing the linked account, stablecoin, or operation.
- `limit` integer
- `cursor` string

## Response `200`

Successful operation

- StablecoinListResponse
  - `data` Stablecoin[], required
    - `id` string, required: System-generated stablecoin identifier.
    - `name` string, required: Stablecoin display name.
    - `symbol` string, required: Stablecoin symbol.
    - `baseCurrency` string, required: Fiat currency the stablecoin is denominated against.
    - `network` 'SPARK', required: Public network family for the stablecoin token identifier. The concrete Spark network is inferred from the platform mode.
    - `decimals` integer, required: Number of decimal places used by the stablecoin.
    - `issuanceStatus` 'PENDING_REVIEW' | 'PROVISIONING' | 'PROVISIONED' | 'REJECTED' | 'FAILED', required: Provider issuance/linking status for the registered stablecoin.
    - `gridOperationsStatus` 'NOT_ENABLED' | 'PENDING_APPROVAL' | 'ENABLING' | 'ENABLED' | 'DISABLED', required: Whether the stablecoin has been enabled for normal Grid operations.
    - `networkTokenIdentifier` string, required: Token identifier in the namespace selected by `network`.
    - `currency` string: Grid currency code after the stablecoin is enabled for Grid operations.
    - `provider` 'BRALE', required: Stablecoin provider backing the linked account, stablecoin, or operation.
    - `stablecoinProviderAccountId` string, required: Stablecoin provider account link selected for this stablecoin.
    - `providerEnvironment` 'SANDBOX' | 'PRODUCTION', required: Provider environment derived from the authenticated Grid platform mode.
    - `providerTokenIdentifier` string, required: Provider token identifier. For Brale this maps to `value_type`.
    - `createdAt` string, date-time, required: Creation timestamp.
    - `updatedAt` string, date-time, required: Last update timestamp.
  - `hasMore` boolean, required: Indicates if more results are available beyond this page.
  - `nextCursor` string: Cursor to retrieve the next page of results.
  - `totalCount` integer: Total number of stablecoins matching the criteria.

## Other responses

- `400`: Bad request - Invalid parameters
- `401`: Unauthorized
- `500`: Internal service error

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-28** `d996ddfb9d2b`: 2 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `400` status
- **2026-10-24** `715332dcb111`: 1 warning
  - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400`
- **2026-10-20** `761d1d030cb5`: 1 warning
  - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
  - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-05** `6d67fe99049c`: 3 info
  - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400`
  - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
  - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400`

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/stablecoins/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)