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.

Convertly includes authenticated currency conversion for products that need reliable money-like calculations alongside media workflows. Use it when your app needs to quote a price in another currency, normalize reporting totals, show account balances in a user’s local currency, or convert marketplace values without maintaining a separate currency service.

What it solves

Currency conversion is useful when a workflow needs a server-side result that can be audited, rate-limited, and tied to an API key. It is not just a browser calculator: each authenticated request can return the conversion path, apply plan-aware quotas, and trigger webhook events on supported plans.

What it handles

CapabilityOutcome
Fixed-decimal amountsAvoids common floating-point drift for money-like values.
Rate pathsReturns the conversion path used for direct or routed conversions.
Usage trackingApplies plan-aware monthly and per-minute currency request limits.
Webhook eventsPro and higher tiers can receive currency.conversion.completed events.

When to use it

Use the currency API for SaaS dashboards, invoicing helpers, marketplace quotes, reporting totals, client portals, internal operations tools, and automation that needs a trusted conversion result. If your product only needs a public currency calculator, use Convertly’s website tools. If your application needs authenticated usage, quota headers, idempotency, records, or webhooks, use POST /api/currency/convert.

Convert currency

Make an authenticated currency conversion request.