Loading
Loading
Convert any currency amount to the local currency of a given IP address using live exchange rates. When no IP is provided, the client request IP is used automatically.
from is the only required parameter. Pass ip to specify the target location (IPv4 or IPv6). amount defaults to 1. Use updates to control rate freshness (1m, 10m, 1h, 1d).
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
Only from is required. Omit ip to auto-detect the client IP.
formatoptionalStringdefault: jsonResponse format: `json` (default) or `xml`.
fromrequiredStringSource currency code. Required. Supports fiat, crypto, and metals.
ipoptionalStringIPv4 or IPv6 address to geolocate. Defaults to the request IP if omitted.
amountoptionalStringdefault: 1Amount to convert as a positive decimal. Defaults to `1`.
updatesoptionalStringdefault: 1mUpdate frequency: `1m` (default), `10m`, `1h`, or `1d`.
A successful request returns 200 OK with the converted amount and the detected local currency of the IP address.
dateRate timestamp in UTC (e.g., `2026-06-05 14:39:00+00`).
fromSource currency code.
toTarget currency code - the local currency of the geolocated IP.
rateExchange rate from source to target currency.
ipAddressIP address used for geolocation. Defaults to the request IP.
givenAmountAmount provided for conversion.
convertedAmountConverted amount in the target (local) currency.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Invalid Amount. Please provide amount in decimal format and greater than 0!
Please provide valid updates parameter (1d,1h,10m,1m)
Provided IP Address [IP_ADDRESS] is invalid.
Geolocation of provided IP [IP_ADDRESS] is unknown.
Rates of provided currency [CURRENCY_CODE] are not available in our database!