Link wallets to an account
Link one or more connected wallets to a UPA.
isPreferredSettlement: true.
Linked wallets appear as crypto destinations in List an account’s settlement destinations. See Settlement destinations.Authorizations
HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.
Headers
Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.
2026-09-09 Path Parameters
Canonical account id returned by the Accounts API.
"acct_123"
Body
Wallets to link. For a wallet-less account without a settlement profile, the first settlement-supported wallet becomes settlement. Otherwise, linking wallets does not change settlement unless one wallet is marked isPreferredSettlement.
1Response
Connected wallets
"wallet_123"
"acct_123"
evm, tron, solana, movement Supported connected-wallet 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, Tron=728126428. Address family must match the selected chain ID.
42161, 1, 8453, 137, 56, 43114, 4663, 4217, 10103, 10002, 728126428 42161
Wallet address. EVM addresses are normalized to lowercase before storage; other address families retain their submitted casing.
"0x1111111111111111111111111111111111111111"
Whether this wallet link can be used by the account.
active, disabled Ownership is unverified until Stableyard records a successful proof. Linking a wallet alone never verifies ownership.
unverified, verified The active settlement profile id when this wallet is the account settlement wallet; otherwise null.
"settle_123"
"Connected wallet"
"eip712_signature"