Get a stablecoin

Retrieve a single registered stablecoin by its Grid identifier.

GET /stablecoins/{stablecoinId}

Get a stablecoin

cURL

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

200

{
  "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"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

stablecoinId · string · required

System-generated stablecoin identifier

Response

200

application/json

Successful operation

id · string · required

System-generated stablecoin identifier.

Example:

"Stablecoin:019542f5-b3e7-1d02-0000-000000000002"

name · string · required

Stablecoin display name.

Example:

"Acme Dollar"

symbol · string · required

Stablecoin symbol.

Example:

"ACME"

baseCurrency · string · required

Fiat currency the stablecoin is denominated against.

Example:

"USD"

network · enum<string> · required

Public network family for the stablecoin token identifier. The concrete Spark network is inferred from the platform mode.

Available options: SPARK

decimals · integer · required

Number of decimal places used by the stablecoin.

Example:

6

issuanceStatus · enum<string> · required

Provider issuance/linking status for the registered stablecoin.

Available options: PENDING_REVIEW, PROVISIONING, PROVISIONED, REJECTED, FAILED

gridOperationsStatus · enum<string> · required

Whether the stablecoin has been enabled for normal Grid operations.

Available options: NOT_ENABLED, PENDING_APPROVAL, ENABLING, ENABLED, DISABLED

networkTokenIdentifier · string · required

Token identifier in the namespace selected by network.

Example:

"btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k"

provider · enum<string> · required

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

Available options: BRALE

stablecoinProviderAccountId · string · required

Stablecoin provider account link selected for this stablecoin.

Example:

"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"

providerEnvironment · enum<string> · required

Provider environment derived from the authenticated Grid platform mode.

Available options: SANDBOX, PRODUCTION

providerTokenIdentifier · string · required

Provider token identifier. For Brale this maps to value_type.

Example:

"ACME"

createdAt · string<date-time> · required

Creation timestamp.

Example:

"2026-05-20T16:40:00Z"

updatedAt · string<date-time> · required

Last update timestamp.

Example:

"2026-05-20T17:10:00Z"

currency · string

Grid currency code after the stablecoin is enabled for Grid operations.

Example:

"ACME"