Skip to main content
PUT
Set my default balances (payouts and payins)

Authorizations

Authorization
string
header
required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Body

application/json
default_settlement_asset
enum<string>

Balance payouts and service fees debit from by default. Optional.

Available options:
USD,
USDT,
USDC,
BTC,
GOLD,
SILVER,
PLATINUM
default_payin_asset
enum<string>

Balance payins settle into by default. With USD the net is credited directly in USD cents; with any other target the net amount is auto-converted via the swap engine at the real price (no extra swap spread). Optional.

Available options:
USD,
USDT,
USDC,
BTC,
GOLD,
SILVER,
PLATINUM

Response

Updated settlement settings.

default_settlement_asset
enum<string>

Balance operations debit from when no per-request override is sent. Fiat values are accepted by the contract but return 503 pricing_unavailable until fiat settlement pricing is available.

Available options:
USD,
USDT,
USDC,
BTC,
GOLD,
SILVER,
PLATINUM,
BOB,
MXN,
ARS
default_payin_asset
enum<string>

Balance payins settle into by default. Credits land in the account's principal asset (USD is the principal balance); when set to a different asset, the net amount is auto-converted via the swap engine at the real price, with no extra swap spread. Checkout/POS payins keep their per-link asset.

Available options:
USD,
USDT,
USDC,
BTC,
GOLD,
SILVER,
PLATINUM
enabled_assets
string[]

Assets your organization currently allows as settlement source. Ledger fiat BOB, MXN and ARS use two decimals; fiat execution returns 503 pricing_unavailable in v1. Ledger fiat BOB, MXN and ARS use two decimals; fiat execution returns 503 pricing_unavailable in v1. Ledger fiat BOB, MXN and ARS use two decimals; fiat execution returns 503 pricing_unavailable in v1.

volatile_op_limit_usdt
string

Per-operation limit (USDT equivalent) for volatile assets (BTC/GOLD/SILVER/PLATINUM).

volatile_daily_limit_usdt
string

Rolling 24h volume cap (USDT equivalent) per account for volatile assets (BTC/GOLD/SILVER/PLATINUM).