Skip to main content
POST
/
quotes
curl -X POST "https://api.tavio.io/v1/quotes" \
     -H "Authorization: Bearer tv_live_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{
           "from_currency": "ETH",
           "to_currency": "USDC",
           "amount": 0.5,
           "direction": "send"
         }'
{
  "quote_id": "qt_xyz789",
  "from_amount": 0.5,
  "to_amount": 1523.4,
  "rate": 3046.8,
  "fee": 4.57,
  "expires_at": "2026-02-21T12:00:30Z"
}

Body

from_currency
string
required
The source currency code (e.g. ETH).
to_currency
string
required
The target currency code (e.g. USDC).
amount
number
required
The amount to convert.
direction
string
required
Either send or receive.

Response

quote_id
string
The unique ID of the locked quote.
from_amount
number
The exact amount being sent.
to_amount
number
The exact amount being received.
rate
number
The conversion rate applied.
fee
number
The fee for the conversion.
expires_at
string
ISO-8601 timestamp for quote expiry (quotes are locked for 30 seconds).
curl -X POST "https://api.tavio.io/v1/quotes" \
     -H "Authorization: Bearer tv_live_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{
           "from_currency": "ETH",
           "to_currency": "USDC",
           "amount": 0.5,
           "direction": "send"
         }'
{
  "quote_id": "qt_xyz789",
  "from_amount": 0.5,
  "to_amount": 1523.4,
  "rate": 3046.8,
  "fee": 4.57,
  "expires_at": "2026-02-21T12:00:30Z"
}