Register an existing provider-created stablecoin

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

Register an existing provider-created stablecoin

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoins \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "providerTokenIdentifier": "ACME",
  "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
  "network": "SPARK",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"
}
'

201

{
  "id": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
  "name": "Acme Dollar",
  "symbol": "ACME",
  "baseCurrency": "USD",
  "network": "SPARK",
  "decimals": 6,
  "issuanceStatus": "PENDING_REVIEW",
  "gridOperationsStatus": "NOT_ENABLED",
  "networkTokenIdentifier": "btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k",
  "provider": "BRALE",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "providerEnvironment": "SANDBOX",
  "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>

Headers

Idempotency-Key · string · required

Required idempotency key for retrying this request safely.

Maximum string length: 255

Body

application/json

providerTokenIdentifier · string · required

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

Example:

"ACME"

networkTokenIdentifier · string · required

Token identifier in the namespace selected by network.

Maximum string length: 255

Example:

"btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k"

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

stablecoinProviderAccountId · string

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:

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

Response

201

application/json

Stablecoin registered

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"