Request Grid enablement for a stablecoin

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

const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/request-grid-enablement', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/request-grid-enablement")
  .post(null)
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

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

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "details": {}
}

{
  "status": 403,
  "code": "FORBIDDEN",
  "message": "<string>",
  "details": {}
}

{
  "status": 404,
  "code": "TRANSACTION_NOT_FOUND",
  "message": "<string>",
  "details": {}
}

{
  "status": 409,
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "code": "GRID_SWITCH_ERROR",
  "message": "<string>",
  "details": {}
}

Stablecoins

Request Grid enablement for a stablecoin

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 Grid enablement for a stablecoin

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

const options = {method: 'POST', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/request-grid-enablement', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/request-grid-enablement")
  .post(null)
  .addHeader("Authorization", "Basic <encoded-value>")
  .build()

val response = client.newCall(request).execute()

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

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "<string>",
  "details": {}
}

{
  "status": 403,
  "code": "FORBIDDEN",
  "message": "<string>",
  "details": {}
}

{
  "status": 404,
  "code": "TRANSACTION_NOT_FOUND",
  "message": "<string>",
  "details": {}
}

{
  "status": 409,
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "code": "GRID_SWITCH_ERROR",
  "message": "<string>",
  "details": {}
}

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

Grid enablement requested

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"

Using the API

API documentation

Request Grid enablement for a stablecoin

Authorizations

Path Parameters

Response