GET /convert
Convert a specific monetary amount from one currency to another using the latest exchange rates. Supports an optional margin parameter for adding business markup (e.g., 2% fee on top of the market rate), and an optional date parameter for historical conversions. Returns the converted amount, the rate used, and query details. Perfect for e-commerce checkout flows, invoicing systems, and travel budget tools.
from
required
Source currency
to
required
Target currency
amount
required
Amount to convert
margin
optional
Business markup percentage
date
optional
Historical date (YYYY-MM-DD)
| Name | Required | Default | Description |
|---|---|---|---|
from |
Yes | - | Source currency |
to |
Yes | - | Target currency |
amount |
Yes | - | Amount to convert |
margin |
No | - | Business markup percentage |
date |
No | - | Historical date (YYYY-MM-DD) |
curl "https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100"
curl "https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100"
curl "https://nordapi.ee/api/v1/convert?from=USD&to=EUR&amount=100&margin=2.5"
curl "https://nordapi.ee/api/v1/convert?from=GBP&to=NOK&amount=500&date=2026-01-15"
curl "https://nordapi.ee/api/v1/convert?from=JPY&to=NOK&amount=1000000"
{
"query": {
"amount": 100.0,
"from": "USD",
"to": "EUR"
},
"rate": 0.86767896,
"result": 86.767896,
"success": true
}
{"success":true,"query":{"from":"USD","to":"EUR","amount":100.0},"result":86.54,"rate":0.8654}