Rates API

Complete API reference for exchange rates.

GET/v1/rates

Get Exchange Rates

Returns current exchange rates for currency conversion.

Note: Crypto prices (BTC, ETH, USDT, USDC) are sourced from CoinGecko with 1-minute caching.

Query Parameters

baserequiredstring

Base currency code (e.g., "USD")

targetsstring

Comma-separated target currencies. If omitted, returns all.

Request

curl
curl "https://api.caibopay.com/v1/rates?base=CAD&targets=COP,ARS,BRL,MXN" \
  -H "Authorization: Bearer sk_test_..."

Response

200 OK
{
  "object": "rates",
  "base": "CAD",
  "timestamp": "2026-03-10T10:00:00Z",
  "rates": {
    "COP": 3150.2500,
    "ARS": 650.4000,
    "BRL": 3.7200,
    "MXN": 12.8500
  }
}
POST/v1/rates/quote

Get a Quote

Get a guaranteed rate for a specific amount. Quotes are valid for 30 seconds.

Request

curl
curl https://api.caibopay.com/v1/rates/quote \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "fromCurrency": "CAD",
    "toCurrency": "COP",
    "amount": 100000
  }'

Response

200 OK
{
  "id": "quote_1234567890",
  "object": "quote",
  "fromCurrency": "CAD",
  "toCurrency": "COP",
  "fromAmount": 100000,
  "toAmount": 315025000,
  "rate": 3150.2500,
  "fee": 299,
  "expiresAt": "2026-03-10T10:00:30Z",
  "createdAt": "2026-03-10T10:00:00Z"
}

Note: Use the quote ID when creating a transfer to lock in the quoted rate.

Supported Currency Pairs

We support the following currency pairs:

CAD/USD
CAD/COP
CAD/ARS
CAD/BRL
CAD/MXN
USD/COP
USD/BRL
BTC/USD
ETH/USD