Stablecoins

Get a stablecoin

Changed on

Retrieve a single registered stablecoin by its Grid identifier.

get/stablecoins/{stablecoinId}

Request

  • Base URL: https://api.lightspark.com/grid/2025-10-13
  • URL: https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}
  • Auth: HTTP basic

Response

Successful operation

idstring required

System-generated stablecoin identifier.

namestring required

Stablecoin display name.

symbolstring required

Stablecoin symbol.

baseCurrencystring 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.

decimalsinteger 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.

networkTokenIdentifierstring required

Token identifier in the namespace selected by network.

currencystring

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

provider'BRALE' required

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

stablecoinProviderAccountIdstring required

Stablecoin provider account link selected for this stablecoin.

providerEnvironment'SANDBOX' | 'PRODUCTION' required

Provider environment derived from the authenticated Grid platform mode.

providerTokenIdentifierstring required

Provider token identifier. For Brale this maps to value_type.

createdAtstring date-time required

Creation timestamp.

updatedAtstring date-time required

Last update timestamp.

Example response

{
  "id": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
  "name": "Acme Dollar",
  "symbol": "ACME",
  "baseCurrency": "USD",
  "decimals": 6,
  "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
  "currency": "ACME",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "providerTokenIdentifier": "ACME",
  "createdAt": "2026-05-20T16:40:00Z",
  "updatedAt": "2026-05-20T17:10:00Z"
}

Changes

  • 3966e5d38aadRevision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      added the new ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new AUTH_METHOD_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new CUSTOMER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new DOCUMENT_HOLDER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PAYMENT_URL_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PLATFORM_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new REQUEST_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new SESSION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_OPERATION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new VERIFICATION_NOT_FOUND enum value to the response property for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • b21ed434ee6eRevision changes
    • info

      endpoint added