Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.convertly.sh/llms.txt

Use this file to discover all available pages before exploring further.

Use POST /api/currency/convert for authenticated currency conversion inside your product. Convertly stores the conversion record, returns the rate path used, and includes quota headers so you can monitor usage.

Precise amounts

Amounts are parsed as fixed decimal strings internally to avoid floating-point drift.

Webhook-ready

Pro, Business, and Enterprise plans can receive currency.conversion.completed events.

​
What it achieves

The currency API is useful for quoting prices, normalizing transaction values, converting reporting totals, or adding a currency tool to a dashboard without maintaining your own rate ingestion and quota tracking system. 
curl -X POST "https://convertly.sh/api/currency/convert" \
  -H "Authorization: Bearer $CONVERTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "199.99",
    "from": "USD",
    "to": "EUR",
    "precision": 2,
    "idempotencyKey": "order_123"
  }'
Response: 
{
  "id": "order_123",
  "object": "currency.conversion",
  "from": "USD",
  "to": "EUR",
  "amount": "199.99",
  "convertedAmount": "184.21",
  "precision": 2,
  "ratePath": [
    {
      "base": "USD",
      "quote": "EUR",
      "rate": "0.9211",
      "asOf": "2026-05-09T10:00:00.000Z",
      "source": "provider"
    }
  ]
}

​
Quota headers

Currency responses include:
HeaderMeaning
x-ratelimit-limit-monthMonthly currency API quota.
x-ratelimit-remaining-monthRemaining monthly requests.
x-ratelimit-limit-minutePer-minute currency API limit.
x-ratelimit-remaining-minuteRemaining requests in the current minute.
Public, unauthenticated currency conversion for the website uses POST /api/currency/public-convert and is not intended as a developer API.