Crypto off-ramp

Only registered if crypto off-ramp is enabled on the server. See Crypto off-ramp for the full flow.

get_crypto_status

Parameters: none.

{
  "crypto_enabled": true,
  "onboard_status": "active",
  "kyc_status": "approved",
  "external_ref": "...",
  "beneficiary_cvu": "0000003100010000123456",
  "deposit_addresses": [{ "id": "...", "network": "ETHEREUM_SEPOLIA", "address": "0x..." }],
  "auto_swap_enabled": false
}

activate_crypto

Idempotent — safe to call again once already active.

Parameters: none. Returns the same shape as get_crypto_status.

get_crypto_addresses

Parameters: none.

{ "addresses": [{ "id": "...", "network": "ETHEREUM_SEPOLIA", "address": "0x..." }] }

get_crypto_balances

Parameters: none.

{ "balances": [{ "currency": "USDC", "balance": "125.50" }] }

set_auto_swap

Parameter	Type	Required	Description
`enabled`	boolean	✓	`true` to auto-convert incoming crypto to ARS

{ "auto_swap_enabled": true }

get_crypto_offramp_quote

Parameter	Type	Required	Description
`amount`	number	✓	Amount of crypto to sell
`currency`	string		Default `USDC`

{ "quote_id": "q_8f2...", "pair": "USDC/ARS", "sell_rate": "1230.50", "crypto_amount": 100 }

execute_crypto_offramp

Parameter	Type	Required	Description
`quote_id`	string	✓	From `get_crypto_offramp_quote`
`amount`	number	✓	Amount of crypto to sell (must match the quote)
`currency`	string		Default `USDC`

{ "offramp_id": "o_91a...", "status": "processing", "transaction_id": "...", "pair": "USDC/ARS", "crypto_amount": 100 }

The resulting ARS lands in the wallet CVU, not the card account. A crypto.offramp.completed or crypto.offramp.failed webhook fires once it resolves.