Create a Conversion Account | Latitude

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

{
  "id": "convacc_1234567890abcdef",
  "individual_id": "ind_9f8b7c6d5e4a3b2c1d0e",
  "payout_account": {
    "id": "fa_abcdef1234567890",
    "type": "pix",
    "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_account": {
    "id": "fa_0987654321fedcba",
    "type": "pix",
    "details": {},
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09: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)

Allowed values:

destination_currencyenumRequired

Destination currency code (e.g., usdc)

Allowed values:

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

Create a Conversion Account

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)

Allowed values:

destination_currencyenum

Destination currency code (e.g., usdc)

Allowed values:

statusenum

Status of the conversion account

Allowed values:

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_accountobject

Deposit account for receiving funds