LIlightsparkdev
Stablecoins

Register an existing provider-created stablecoin

Changed on

Register an existing provider-created stablecoin as a Grid Stablecoin. This endpoint links provider token metadata to Grid; it does not create the token with the provider. Grid derives the active provider account link from the authenticated platform, provider, and provider environment.

post/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

Headers

Idempotency-Keystring required

Required idempotency key for retrying this request safely.

Request body

providerTokenIdentifierstring required

Provider identifier for the stablecoin. For Brale this maps to value_type.

networkTokenIdentifierstring required

Token identifier in the namespace selected by network.

network'SPARK' required

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

stablecoinProviderAccountIdstring

Provider account link to register against. Optional when exactly one active link exists for the authenticated platform; required to resolve STABLECOIN_PROVIDER_ACCOUNT_SELECTION_REQUIRED when multiple links exist.

Example request

{
  "providerTokenIdentifier": "ACME",
  "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"
}

Response

Stablecoin registered

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

  • f11f1e76bdd7Revision changes
    • warning

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