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).
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
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!