Sign in
Stablecoins

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

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

Changed in 5 of the 24 revisions of this API.71

  • aaa1fb8782c81See the full diff
    • ●

      added the new EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED enum value to the code response property for the response status 400

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • df12ec487f0e1See the full diff
    • ●

      added the new TRANSACTION_SIZE_LIMIT_EXCEEDED enum value to the code response property for the response status 400

      response-property-enum-value-added

  • b06902b6595a4See the full diff
    • ●

      added the new CARDHOLDER_KYC_NOT_APPROVED enum value to the code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new CARD_ALREADY_CLOSED enum value to the code response property for the response status 409

      response-property-enum-value-added

    • ●

      added the new CARD_NOT_MUTABLE enum value to the code response property for the response status 409

      response-property-enum-value-added

    • ●

      added the new INVALID_STATE_TRANSITION enum value to the code response property for the response status 409

      response-property-enum-value-added

  • 526036c126091See the full diff
    • ●

      added the new END_USER_TERMS_VERSION_NOT_FOUND enum value to the code response property for the response status 400

      response-property-enum-value-added

  • b21ed434ee6e1See the full diff
    • ○

      endpoint added

      endpoint-added