curl --request POST \
--url https://api.simmer.markets/api/sdk/wallet/link \
--header 'Content-Type: application/json' \
--data '
{
"address": "<string>",
"signature": "<string>",
"nonce": "<string>",
"signature_type": 0,
"confirm_replace_managed": false,
"confirm_orphan_deposit_wallet": false
}
'{
"success": true,
"wallet_address": "<string>",
"wallet_ownership": "<string>",
"message": "<string>",
"error": "<string>"
}Wallet Link
Link an external wallet after proving ownership.
Submit the signed challenge message to link the wallet to your account. The signature must be valid for the challenge nonce that was requested.
Rate limited: 3 linking attempts per day per account.
curl --request POST \
--url https://api.simmer.markets/api/sdk/wallet/link \
--header 'Content-Type: application/json' \
--data '
{
"address": "<string>",
"signature": "<string>",
"nonce": "<string>",
"signature_type": 0,
"confirm_replace_managed": false,
"confirm_orphan_deposit_wallet": false
}
'{
"success": true,
"wallet_address": "<string>",
"wallet_ownership": "<string>",
"message": "<string>",
"error": "<string>"
}Body
Request to link an external wallet after signing challenge.
Wallet address being linked
Signature of the challenge message
Challenge nonce from GET /wallet/link/challenge
0=EOA, 1=Polymarket proxy, 2=Gnosis Safe
Required (true) when this link would replace an existing managed wallet with a different external wallet. Default false so SDK auto-relink paths (_ensure_wallet_linked) cannot silently overwrite a managed account when a stale WALLET_PRIVATE_KEY is left in the bot env. Explicit user calls to client.link_wallet() from simmer-sdk >= 0.16 pass this true. SIM-1574.
Required (true) when the user has an active Polymarket deposit wallet (wallet_uses_deposit_wallet=true) and the linking address differs from the current wallet_address. The DW is owned on-chain by the CURRENT EOA via CREATE2; relinking to a new address would orphan the DW (the new key can't sign WALLET batches against it — funds and positions get stuck). Default false so silent orphaning is impossible. SIM-1611. Surfaced after the 2026-05-07 audit found 3 already-orphaned DWs from prior relinks (da2185e0, ydir.tomas@, raynojam@). See _dev/active/_polymarket-dw-phase-2/.