List stablecoins - Grid API Documentation

List stablecoins

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoins \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins")
  .get()
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

{
  "data": [
    {
      "id": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
      "name": "Acme Dollar",
      "symbol": "ACME",
      "baseCurrency": "USD",
      "network": "SPARK",
      "decimals": 6,
      "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
      "provider": "BRALE",
      "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
      "providerTokenIdentifier": "ACME",
      "createdAt": "2026-05-20T16:40:00Z",
      "updatedAt": "2026-05-20T17:10:00Z",
      "currency": "ACME"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

{
  "status": 400,
  "message": "<string>",
  "details": {
    "errors": [
      {
        "field": "taxIdentifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ]
  }
}

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "message": "<string>",
  "details": {}
}

GET

/

stablecoins

List stablecoins

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoins \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins")
  .get()
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

{
  "data": [
    {
      "id": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
      "name": "Acme Dollar",
      "symbol": "ACME",
      "baseCurrency": "USD",
      "network": "SPARK",
      "decimals": 6,
      "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
      "provider": "BRALE",
      "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
      "providerTokenIdentifier": "ACME",
      "createdAt": "2026-05-20T16:40:00Z",
      "updatedAt": "2026-05-20T17:10:00Z",
      "currency": "ACME"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

{
  "status": 400,
  "message": "<string>",
  "details": {
    "errors": [
      {
        "field": "taxIdentifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ]
  }
}

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

API token authentication using format <api token id>:<api client secret>

Query Parameters

issuanceStatus

enum<string>

Provider issuance/linking status for the registered stablecoin.

Available options:

PENDING_REVIEW,

PROVISIONING,

PROVISIONED,

REJECTED,

FAILED

gridOperationsStatus

enum<string>

Whether the stablecoin has been enabled for normal Grid operations.

Available options:

NOT_ENABLED,

PENDING_APPROVAL,

ENABLING,

ENABLED,

DISABLED

provider

enum<string>

Stablecoin provider backing the linked account, stablecoin, or operation.

Available options:

BRALE

limit

integer

default:20

Maximum number of results to return (default 20, max 100)

Required range: 1 <= x <= 100

cursor

string

Opaque cursor returned as nextCursor from the previous response.

Response

Successful operation

data

object[]

required

Show child attributes

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.

Reveal card details

Register an existing provider-created stablecoin

⌘I