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.
Authorizations
API token authentication using format <api token id>:<api client secret>
Headers
Required idempotency key for retrying this request safely.
255Body
Provider identifier for the stablecoin. For Brale this maps to value_type.
"ACME"
Token identifier in the namespace selected by network.
"btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k"
Public network family for the stablecoin token identifier. The concrete Spark network is inferred from the platform mode.
SPARK 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.
"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"
Response
Stablecoin registered
System-generated stablecoin identifier.
"Stablecoin:019542f5-b3e7-1d02-0000-000000000002"
Stablecoin display name.
"Acme Dollar"
Stablecoin symbol.
"ACME"
Fiat currency the stablecoin is denominated against.
"USD"
Public network family for the stablecoin token identifier. The concrete Spark network is inferred from the platform mode.
SPARK Number of decimal places used by the stablecoin.
6
Provider issuance/linking status for the registered stablecoin.
PENDING_REVIEW, PROVISIONING, PROVISIONED, REJECTED, FAILED Whether the stablecoin has been enabled for normal Grid operations.
NOT_ENABLED, PENDING_APPROVAL, ENABLING, ENABLED, DISABLED Token identifier in the namespace selected by network.
"btkn1qw508d6qejxtdg4y5r3zarvary0c5xw7k"
Stablecoin provider backing the linked account, stablecoin, or operation.
BRALE Stablecoin provider account link selected for this stablecoin.
"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"
Provider environment derived from the authenticated Grid platform mode.
SANDBOX, PRODUCTION Provider token identifier. For Brale this maps to value_type.
"ACME"
Creation timestamp.
"2026-05-20T16:40:00Z"
Last update timestamp.
"2026-05-20T17:10:00Z"
Grid currency code after the stablecoin is enabled for Grid operations.
"ACME"