Set an account's settlement preference
Choose which active destination a UPA’s incoming money settles to.
settlementDestinationId returned by List an account’s settlement destinations, and optionally an assetSymbol. The destination must be an active crypto wallet destination. A destination that is not active returns 409, and bank and rail-identifier destinations cannot be selected.
Repeating the same preference returns the existing profile. Deposits and Payments that already exist keep their immutable settlement snapshot.
See Settlement destinations.Authorizations
Headers
Path Parameters
Body
Select an active typed settlement destination returned by the settlement-destinations endpoint. Native assets cannot be selected for token settlement. THBT is Movement-only. JPYC is Polygon-only. USDG is Robinhood Chain-only (4663).
Response
Settlement profile
Supported settlement chain IDs: Arbitrum=42161, Ethereum=1, Base=8453, Polygon=137, BNB Smart Chain=56, Avalanche=43114, Robinhood Chain=4663, Tempo=4217, Solana=10103, Movement=10002. Settlement currently supports EVM, Solana, and Movement token destinations. Movement also supports THBT, while Polygon supports direct same-chain JPYC settlement. Tron can be used for deposits but not as a settlement destination.
42161, 1, 8453, 137, 56, 43114, 4663, 4217, 10103, 10002 42161