Currency Conversion
What it does
Real-time exchange rates with daily auto-updates for 160+ currencies. POTAL fetches rates from central bank sources and caches them for fast lookups. Use it standalone or as part of landed cost calculations where product prices need to be converted to the destination currency.
Required Fields for 100% Accuracy
2 required / 2 total| Field | Type | Required |
|---|---|---|
from | string | ! |
to | string | ! |
Tips for Best Accuracy
- ✓Rates are updated daily from central bank sources
- ✓For landed cost calculations, currency conversion is automatic — no separate call needed
- ✓Rate lock is available for guaranteed pricing over 24–72 hours
Common Mistakes
- ✗Using country codes instead of currency codes — "US" is not valid, use "USD"
- ✗Assuming rates are real-time — they are daily snapshots from central banks
How to use it
Get current rates
GET /api/v1/exchange-rate?from=USD&to=EUR returns the current exchange rate.
Auto-convert in calculations
The /calculate endpoint automatically handles currency conversion when currencies differ.
Lock a rate
POST /api/v1/exchange-rates/lock to freeze a rate for 24-72 hours for guaranteed pricing.
Batch conversion
Convert multiple amounts in a single request by including the currency in each calculation.
API Reference
/api/v1/exchange-rate// GET /api/v1/exchange-rate?from=USD&to=EUR{
"from": "USD",
"to": "EUR",
"rate": 0.9234,
"timestamp": "2026-03-29T00:00:00Z",
"source": "ECB"
}curl "https://potal.app/api/v1/exchange-rate?from=USD&to=EUR" \
-H "X-API-Key: pk_live_your_key"Related Features
Get the full import cost including duties, taxes, fees, and shipping
Display costs in any currency with real-time conversion
Look up MFN, MIN, and AGR duty rates for 240 countries
Compare rates across 8 carriers including DHL, FedEx, UPS
Compare DDP vs DDU costs with itemized fee breakdown