Create a Conversion Account | Latitude

curl -X POST https://api.latitude.xyz/v1/conversion_accounts \
     -H "Content-Type: application/json" \
     -d '{
  "individual_id": "ind_1234567890abcdef",
  "payout_account": {
    "id": "fa_9876543210fedcba"
  },
  "source_currency": "MXN",
  "destination_currency": "USDC"
}'

{
  "id": "ca_abcdef1234567890",
  "individual_id": "ind_1234567890abcdef",
  "payout_account": {
    "id": "fa_9876543210fedcba",
    "type": "crypto_wallet",
    "details": {},
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z"
  },
  "source_currency": "MXN",
  "destination_currency": "USDC",
  "status": "pending",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "deposit_instructions": {
    "type": "mx_virtual_account",
    "currency": "mxn",
    "payment_methods": [
      "bank_transfer"
    ],
    "details": {},
    "deadline": "2024-01-22T09:30:00Z"
  }
}

Creates a new conversion account for on-ramp conversion

Request

This endpoint expects an object.

individual_idstringRequired

The public ID of the individual

payout_accountobjectRequired

Destination account for converted funds

source_currencyenumRequired

Source currency code (e.g., mxn)

destination_currencyenumRequired

Destination currency code (e.g., usdc)

client_reference_idstringOptional

Your unique identifier for this conversion account. Use this to correlate with your records in your own system. Maximum 255 characters.

Response

Conversion account created with deposit instructions

idstring

Unique public identifier for the conversion account

individual_idstring

Unique public identifier for the associated individual

payout_accountobject

Destination account for converted funds

source_currencyenum

Source currency code (e.g., mxn)

destination_currencyenum

Destination currency code (e.g., usdc)

statusenum

Status of the conversion account

created_atstringformat: "date-time"

ISO 8601 timestamp when the conversion account was created

updated_atstringformat: "date-time"

ISO 8601 timestamp when the conversion account was last updated

deposit_instructionsobject

Instructions for end-users to deposit funds into the conversion account (e.g. virtual account or QR code details)