Skip to main content
POST
Register an existing provider-created stablecoin

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.

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

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"