Skip to main content
Assets represent the currencies and payment rails available on the Yativo platform. Use these endpoints to discover what’s supported and to get live exchange rates before executing transfers. 
interface Asset {
  code: string;
  name: string;
  symbol: string;
  type: "fiat";
  countries: string[];
  is_send_enabled: boolean;
  is_receive_enabled: boolean;
}

interface ExchangeRate {
  from: string;
  to: string;
  rate: string;
  inverse_rate: string;
  timestamp: string;
}

interface ConvertRequest {
  from: string;
  to: string;
  amount: number;
}

interface ConvertResponse {
  from: string;
  to: string;
  from_amount: string;
  to_amount: string;
  rate: string;
  fee: string;
  expires_at: string;
}

​
List assets

Get all assets (currencies) available on the platform. 
GET /assets
​
type
string
Filter by asset type. Currently fiat.
​
country
string
Filter by supported country (ISO 3166-1 alpha-2).
curl -X GET 'https://api.yativo.com/api/assets' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "data": [
    {
      "code": "BRL",
      "name": "Brazilian Real",
      "symbol": "R$",
      "type": "fiat",
      "countries": ["BR"],
      "is_send_enabled": true,
      "is_receive_enabled": true
    },
    {
      "code": "MXN",
      "name": "Mexican Peso",
      "symbol": "$",
      "type": "fiat",
      "countries": ["MX"],
      "is_send_enabled": true,
      "is_receive_enabled": true
    },
    {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$",
      "type": "fiat",
      "countries": ["US"],
      "is_send_enabled": true,
      "is_receive_enabled": true
    }
  ]
}

​
Get exchange rate

Retrieve the current exchange rate between two currencies. 
GET /assets/rate?from={code}&to={code}
​
from
string
required
Source currency code (e.g. USD).
​
to
string
required
Target currency code (e.g. BRL).
curl -X GET 'https://api.yativo.com/api/assets/rate?from=USD&to=BRL' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "data": {
    "from": "USD",
    "to": "BRL",
    "rate": "4.9820",
    "inverse_rate": "0.2007",
    "timestamp": "2026-03-26T10:00:00Z"
  }
}

​
Convert amount

Get the converted amount and applicable fee for a specific conversion, without executing a transfer. 
POST /assets/convert
​
from
string
required
Source currency code.
​
to
string
required
Target currency code.
​
amount
number
required
The amount in the source currency to convert.
curl -X POST 'https://api.yativo.com/api/assets/convert' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": "USD",
    "to": "BRL",
    "amount": 1000
  }'

{
  "status": "success",
  "data": {
    "from": "USD",
    "to": "BRL",
    "from_amount": "1000.00",
    "to_amount": "4974.00",
    "rate": "4.9820",
    "fee": "8.00",
    "expires_at": "2026-03-26T10:05:00Z"
  }
}
Conversion quotes are indicative. To lock in a rate and initiate a transfer, use Send Money — the quote step there returns a binding rate ID valid for 60 seconds.