The official Postman collection for the CurrencyFreaks exchange-rate API — live and\nhistorical rates for around 1026 currencies, covering fiat, cryptocurrencies and precious\nmetals, with history reaching back to 1984 for major pairs.
\napikey collection variable to your key — paste it into the Current value\ncolumn.Authentication is configured once at collection level, as an API key in the query string\nnamed apikey, and every request inherits it. There is no header-based alternative.
Every request carries tests, so you can run the whole collection in the Collection Runner\nor via Newman and confirm your integration end to end.
\nEndpoint availability depends on your subscription. A request outside your plan returns\n402 with This feature is available on {PLAN_NAME} plan and onwards!
See pricing for request quotas.
\nAll numeric values are strings. Rates, amounts and percentages are JSON-encoded as\nstrings to preserve full precision. Parse them into a decimal type rather than a float,\nparticularly for financial calculations.
\n/supported-currencies is authoritative. Filter on status == \"AVAILABLE\" to\ndetermine what you can query. Use /currency-symbols for display labels only.
Check coverage before querying history. Depth varies by currency, so call\n/historical-data-limits rather than assuming a start date.
Filter with symbols. An unfiltered response spans every available currency. Passing\nsymbols reduces both payload size and latency.
Quotas are monthly, not per-second. There are no hourly or daily throttles, so a 429\nmeans your plan quota is exhausted and retrying will not help. We email at 80%, 90% and\n100% usage on paid plans.
Call the API server-side. Because the key travels in the query string, requests should\noriginate from your backend, not from browser JavaScript. Proxy through your own endpoint\nand keep the key on your server.
\nJSON is recommended for cryptocurrency symbol sets. XML element names derive from\ncurrency codes, and codes containing characters that are invalid in XML names are\nnormalised. See the XML request in folder 02 for details.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"CurrencyFreaks API v2.0","slug":"currencyfreaks-api-v20"}],"owner":"57124893","collectionId":"eb48304d-2cb0-40ba-92c1-1906e43be64c","publishedId":"2sBY4TryiX","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"008080"},"publishDate":"2026-08-04T15:14:33.000Z"},"item":[{"name":"01 — Metadata (no API key required)","item":[{"name":"Supported Currencies","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('200 OK', () => pm.response.to.have.status(200));","pm.test('Responds under 5s', () => pm.expect(pm.response.responseTime).to.be.below(5000));","const m = pm.response.json().supportedCurrenciesMap;","pm.test('Catalogue is populated', () => pm.expect(Object.keys(m).length).to.be.above(500));","pm.test('Status is AVAILABLE or DEPRECIATED', () => {"," Object.values(m).forEach(c =>"," pm.expect(['AVAILABLE','DEPRECIATED']).to.include(c.status));","});","const avail = Object.keys(m).filter(k => m[k].status === 'AVAILABLE');","pm.collectionVariables.set('availableCount', avail.length);","console.log('Available currencies:', avail.length);"],"id":"d58d0a4c-84bf-40fb-accd-73783ae35460"}}],"id":"c87f32de-051e-46c6-ae93-5ddfdd8f5fde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.currencyfreaks.com/v2.0/supported-currencies","description":"The full CurrencyFreaks catalogue: currency code, name, country, coverage window, icon, and an AVAILABLE or DEPRECIATED status.
Use this endpoint as your source of truth. Filter on status == \"AVAILABLE\" to get the set of currencies that are actively updated. DEPRECIATED currencies stopped updating at their availableUntil date and remain queryable only for historical dates.
As of August 2026 the catalogue holds roughly 1100 entries — about 1026 available — comprising ~185 fiat currencies, 837 cryptocurrencies and 4 precious metals.
\nCrypto entries carry a countryCode of Crypto and metals carry Metal; both use a countryName of Global.
The response is around 260 KB. Cache it on your side rather than calling it per request.
\n","urlObject":{"path":["supported-currencies"],"host":["https://api.currencyfreaks.com/v2.0"],"query":[{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
A lightweight code-to-name map, around 21 KB versus 260 KB for /supported-currencies. No API key required.
This endpoint is intended for populating display labels, dropdowns and pickers. For programmatic decisions about which currencies you can query — and for coverage dates and status — use /supported-currencies, which is authoritative and updated first.
json (default) or xml. Any other value returns 400.
The date range for which we hold rates for each currency, returned as the string \"YYYY-MM-DD to YYYY-MM-DD\". Split on \" to \" to parse. No API key required.
Call this before any historical query. Coverage varies widely by currency: our deepest history reaches 1984-11-28 for nine major currencies (AUD, CAD, CHF, DKK, GBP, JPY, NOK, SEK, USD), most other fiat begins 1989-08-18, and cryptocurrencies begin on their individual listing dates from 2013 onward.
\n","urlObject":{"path":["historical-data-limits"],"host":["https://api.currencyfreaks.com/v2.0"],"query":[{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Catalogue and coverage endpoints. These need no API key and are available on every plan, so you can run them immediately after importing.
\nStart here. /supported-currencies tells you which currencies you can query, and /historical-data-limits tells you how far back each one goes.
Every available currency against USD.
\nThis returns roughly 1026 rates. If you only need a handful, use the filtered request below — it is faster and lighter.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":"YOUR_APIKEY"}]},"isInherited":true,"source":{"_postman_id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","name":"CurrencyFreaks API v2.0","type":"collection"}},"urlObject":{"path":["rates","latest"],"host":["https://api.currencyfreaks.com/v2.0"],"query":[{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Restrict the response with symbols to reduce payload size and latency. This is the recommended pattern for production use.
Currency codes are case-insensitive. Available on all plans, including Free.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":"YOUR_APIKEY"}]},"isInherited":true,"source":{"_postman_id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","name":"CurrencyFreaks API v2.0","type":"collection"}},"urlObject":{"path":["rates","latest"],"host":["https://api.currencyfreaks.com/v2.0"],"query":[{"description":{"content":"Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"USD,EUR,GBP,PKR"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Re-quote rates against any currency using base.
Available on paid plans. On the Free plan this returns 402 This feature is available on {PLAN_NAME} plan and onwards!
Because rates are sourced against USD, a custom base is computed as a cross rate. For high-precision accounting, retrieve the USD legs and perform the division yourself with a decimal type.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":"YOUR_APIKEY"}]},"isInherited":true,"source":{"_postman_id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","name":"CurrencyFreaks API v2.0","type":"collection"}},"urlObject":{"path":["rates","latest"],"host":["https://api.currencyfreaks.com/v2.0"],"query":[{"description":{"content":"Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"USD,GBP,PKR,INR"},{"description":{"content":"Currency to quote rates against. Defaults to USD. Available on paid plans — sending this on the Free plan returns 402.
\n","type":"text/plain"},"key":"base","value":"EUR"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Any endpoint accepts format=xml. The root element here is <LatestRatesResponse>.
XML element names are derived from currency codes, so codes that are not valid XML names are normalised:
\n1INCH becomes <_1INCH>.JSON is recommended when your symbol set includes cryptocurrencies. XML is fully reliable for fiat and metals, and for any explicitly filtered symbols list you control.
Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"USD,EUR,GBP"},{"description":{"content":"Switch to XML.
\n","type":"text/plain"},"key":"format","value":"xml"}],"variable":[]}},"response":[],"_postman_id":"88bf2747-c15b-4afd-81a6-63f9d525d31b"}],"id":"c9bd4b37-23ae-4795-9c94-898634df3ed8","description":"Current exchange rates, updated continuously. Available on every plan, including Free. The base parameter requires a paid plan.
Rates are quoted against USD and re-based on request, so non-USD bases are derived as cross rates.
\n","_postman_id":"c9bd4b37-23ae-4795-9c94-898634df3ed8","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":"YOUR_APIKEY"}]},"isInherited":true,"source":{"_postman_id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","name":"CurrencyFreaks API v2.0","type":"collection"}}},{"name":"03 — Conversion","item":[{"name":"Convert — latest rate","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('200 OK', () => pm.response.to.have.status(200));","pm.test('Responds under 5s', () => pm.expect(pm.response.responseTime).to.be.below(5000));","const b = pm.response.json();","pm.test('Has conversion fields', () => {"," ['from','to','rate','givenAmount','convertedAmount'].forEach(k =>"," pm.expect(b).to.have.property(k));","});","pm.test('convertedAmount = givenAmount * rate', () => {"," const expected = parseFloat(b.givenAmount) * parseFloat(b.rate);"," pm.expect(parseFloat(b.convertedAmount)).to.be.closeTo(expected, expected * 1e-6);","});"],"id":"668c6738-7e80-437f-9187-cdd9aeea29cb"}}],"id":"175d7d4c-b314-4813-a42e-24a0b6df6c44","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.currencyfreaks.com/v2.0/convert/latest?from=USD&to=PKR&amount=500","description":"Convert an amount at the current rate. Available on paid plans.
\namount defaults to 1.0 and must be greater than zero. Every numeric field in the response, including givenAmount, is returned as a string to preserve precision.
Currency to convert from. Required.
\n","type":"text/plain"},"key":"from","value":"USD"},{"description":{"content":"Currency to convert to. Required.
\n","type":"text/plain"},"key":"to","value":"PKR"},{"description":{"content":"Amount to convert. Defaults to 1.0. Must be greater than zero.
\n","type":"text/plain"},"key":"amount","value":"500"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Convert an amount at the rate that applied on a past date. Available on paid plans.
\nThe response date echoes your YYYY-MM-DD with no time component. Confirm the date falls inside both currencies' coverage windows using /historical-data-limits, otherwise the request returns 404.
Past date, YYYY-MM-DD. Required.
Currency to convert from. Required.
\n","type":"text/plain"},"key":"from","value":"USD"},{"description":{"content":"Currency to convert to. Required.
\n","type":"text/plain"},"key":"to","value":"PKR"},{"description":{"content":"Amount to convert. Defaults to 1.0. Must be greater than zero.
\n","type":"text/plain"},"key":"amount","value":"500"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Single-pair conversion for a given amount. Available on paid plans.
\nIf you convert many pairs against the same base, fetching rates once from /rates/latest and multiplying locally uses fewer requests against your monthly quota.
End-of-day rates for one past date. Available on paid plans.
\nA date outside a currency's coverage returns 404 naming the available window. A date we hold no data for at all returns Rates of provided date {DATE} are not available in our database.
Past date, YYYY-MM-DD. Required.
Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"USD,EUR,GBP,PKR"},{"disabled":true,"description":{"content":"Currency to quote rates against. Defaults to USD. Available on paid plans — sending this on the Free plan returns 402.
\n","type":"text/plain"},"key":"base","value":"EUR"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
One rate set per day, ordered ascending under historicalRatesList. Requires the Professional plan or above.
Constrain symbols for long ranges. An unfiltered multi-year request spans every available currency for every day in the range and produces a very large response.
First date of the range, YYYY-MM-DD. Required. Must not be in the future or after endDate.
Last date of the range, YYYY-MM-DD. Defaults to yesterday.
Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"USD,PKR"},{"description":{"content":"Currency to quote rates against. Defaults to USD. Available on paid plans — sending this on the Free plan returns 402.
\n","type":"text/plain"},"key":"base","value":"EUR"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Opening rate, closing rate, absolute change and percentage change for each requested currency. Requires the Professional plan or above.
\nHow change is calculated: change = startRate - endRate, and percentChange expresses that as a percentage of startRate. A currency whose rate against the base fell over the period therefore reports a positive change.
In the example response below, PKR moves from 254.331 to 243.874 per GBP, so change is 10.457 and percentChange is 4.11. If your charts use an up-is-positive convention, negate both fields.
First date of the range, YYYY-MM-DD. Required.
Last date of the range, YYYY-MM-DD. Defaults to yesterday.
Comma-separated currency codes. Omit to receive every available currency. Case-insensitive, no spaces after commas.
\n","type":"text/plain"},"key":"symbols","value":"PKR"},{"description":{"content":"Currency to quote rates against. Defaults to USD. Available on paid plans — sending this on the Free plan returns 402.
\n","type":"text/plain"},"key":"base","value":"GBP"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Rates for a past date, a daily series across a range, or a start-to-end summary.
\n/rates/historical is available on paid plans. /timeseries and /fluctuation require the Professional plan or above.
Check /historical-data-limits before querying — coverage runs from 1984 for our deepest fiat pairs to individual listing dates for cryptocurrencies.
Converts amount from the from currency into the local currency of the country the IP resolves to. Both IPv4 and IPv6 are supported. Requires the Growth plan or above.
Pass the ip explicitly when calling from a backend. With ip omitted we geolocate the requesting IP, which for server-side integrations is your own infrastructure rather than your visitor. Forward the visitor's address from your web tier.
A syntactically valid address we cannot place — a private range, for example, or unallocated space — returns 404 Geolocation of provided IP {IP} is unknown rather than a default currency, so handle that branch in your integration.
Currency to convert from. Required.
\n","type":"text/plain"},"key":"from","value":"GBP"},{"description":{"content":"IPv4 or IPv6 address to geolocate. If omitted, the IP the request originates from is used.
\n","type":"text/plain"},"key":"ip","value":"182.186.18.9"},{"description":{"content":"Amount to convert. Defaults to 1.0. Must be greater than zero.
\n","type":"text/plain"},"key":"amount","value":"500"},{"disabled":true,"description":{"content":"json (default) or xml. Any other value returns 400.
Resolve an IP address to a country and convert into that country's local currency. Requires the Growth plan or above.
\nDesigned for localising displayed prices without prompting visitors for their location.
\n","_postman_id":"875a4397-d316-466c-9f60-e10234c12a8e","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":"YOUR_APIKEY"}]},"isInherited":true,"source":{"_postman_id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","id":"eb48304d-2cb0-40ba-92c1-1906e43be64c","name":"CurrencyFreaks API v2.0","type":"collection"}}},{"name":"06 — Error Handling","item":[{"name":"400 — missing API key","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('400', () => pm.response.to.have.status(400));","pm.test('Error envelope shape', () => {"," const b = pm.response.json();"," ['timestamp','status','error','message','path'].forEach(k =>"," pm.expect(b).to.have.property(k));"," pm.expect(b.path).to.include('/v2.0');","});"],"id":"6c645034-9572-43ae-9062-7c2d6eea8c89"}}],"id":"58151cf1-944e-473a-8edc-67fdf82d609f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.currencyfreaks.com/v2.0/rates/latest?symbols=USD,EUR","description":"A request with no apikey. Returns 400 Invalid Param Exception.
The API key is supplied as a query parameter. Header-based authentication is not supported, so sending apikey as an HTTP header also produces this response.
An unrecognised key returns 401 Invalid Api Access Exception. A key that exists but has been deactivated also returns 401, with a message noting the key is inactive.
Deliberately unrecognised key.
\n","type":"text/plain"},"key":"apikey","value":"INVALID_KEY_123"},{"key":"symbols","value":"USD,EUR"}],"variable":[]}},"response":[{"id":"cc6b5e9b-81b1-4a0d-8cc5-97a3bcbbac6a","name":"401 Unauthorized","originalRequest":{"method":"GET","header":[],"url":""},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"timestamp\": 1785841639172,\n \"status\": 401,\n \"error\": \"Invalid Api Access Exception\",\n \"message\": \"Provided API key is invalid. [Contact tech. support for assistance at support@currencyfreaks.com]\",\n \"path\": \"/v2.0/rates/latest\"\n}"}],"_postman_id":"2b6561c2-20aa-445e-be6f-39c611bc2f1f"},{"name":"400 — unsupported format","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('400', () => pm.response.to.have.status(400));"],"id":"aac0d63d-04df-42fe-a505-790d87a703a1"}}],"id":"01d09490-7e6a-455b-9f05-b7afb6037aa7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.currencyfreaks.com/v2.0/currency-symbols?format=yaml","description":"Returns 400 Http Media Type Not Acceptable with the message Invalid format (Available formats: json, xml).
Only json and xml are accepted.
An unrecognised URL returns 404 No Handler Found Exception. All endpoints are GET; other methods on a valid path return 400.
Requests that deliberately fail, so you can see the error envelope and build handling against it.
\nEvery non-2xx response uses the same shape: timestamp, status, error, message and path. Note that path includes the /v2.0 prefix.
The status field mirrors the HTTP status code, so you can branch on either.