v5

OpenAPI 3.1.0Proprietary2026-08-011476181.4 MB

Stablecoins

Link a stablecoin provider account

Link provider API credentials for the authenticated platform. Provider credentials are account-scoped and can be reused for multiple stablecoins. Currently, the only supported provider is BRALE; the provider environment is derived from the authenticated Grid platform mode.

post/stablecoin-provider-accounts

Headers

Idempotency-Keystring required

Idempotency key for retrying this request safely. Replays return the prior result; conflicting payloads are rejected.

Request body

provider'BRALE' required

Stablecoin provider backing the linked account, stablecoin, or operation.

apiClientIdstring required

Provider API client id used to verify and link the provider account.

apiClientSecretstring required

Provider API client secret. Grid verifies and stores this secret encrypted; it is never returned.

providerAccountIdstring

Provider account id. Optional when the submitted credentials expose exactly one provider account.

Example request

{
  "apiClientId": "provider_client_123",
  "apiClientSecret": "provider_secret_456",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4"
}

Response

Stablecoin provider account linked

idstring required

System-generated stablecoin provider account link identifier.

provider'BRALE' required

Stablecoin provider backing the linked account, stablecoin, or operation.

providerAccountIdstring required

Provider account id.

providerEnvironment'SANDBOX' | 'PRODUCTION' required

Provider environment derived from the authenticated Grid platform mode.

status'ACTIVE' | 'INVALID' | 'REVOKED' required

Status of the linked stablecoin provider account credentials.

lastVerifiedAtstring date-time

Timestamp of the last successful provider credential verification.

createdAtstring date-time required

Creation timestamp.

updatedAtstring date-time required

Last update timestamp.

Example response

{
  "id": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
  "lastVerifiedAt": "2026-05-20T16:35:00Z",
  "createdAt": "2026-05-20T16:35:00Z",
  "updatedAt": "2026-05-20T16:35:00Z"
}