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.
fromrequiredStringSource currency symbol to convert from.
ipoptionalStringIPv4 or IPv6 address to geolocate. Defaults to the client request IP if omitted.
amountoptionalIntegerdefault: 1Amount to convert. Defaults to 1.
updatesoptionalStringdefault: 1mRate update frequency. Accepted values: 1m, 10m, 1h, 1d.
A successful request returns 200 OK with the converted amount and the detected local currency of the IP address.
dateTimestamp of when the rate was recorded (UTC, with timezone offset).
fromSource currency code.
toTarget currency code — the local currency of the geolocated IP.
rateExchange rate from the source to the target currency.
ipAddressThe IP address used for geolocation. If no IP was provided, this is the client request IP.
givenAmountThe amount provided for conversion.
convertedAmountThe converted amount in the target (local) currency.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
please pass correct parameters
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!