LIlightsparkdev
Stablecoins

Request Grid enablement for a stablecoin

Changed on

Ask Lightspark to approve a registered stablecoin as a Grid settlement currency. Grid enablement is a reviewed workflow rather than a self-service switch, so this endpoint only records the request: it moves gridOperationsStatus from NOT_ENABLED to PENDING_APPROVAL and returns the updated stablecoin. Lightspark drives the remaining ENABLING and ENABLED steps.

The request is idempotent. Repeating it while the stablecoin is already PENDING_APPROVAL succeeds and changes nothing. A stablecoin in any other Grid operations status cannot be requested, and returns 409.

post/stablecoins/{stablecoinId}/request-grid-enablement

Request

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

Response

Grid enablement requested

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

  • d996ddfb9d2bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 5abf2bb56bcbRevision changes
    • warning

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