Frequently asked questions

Getting started

How do I get an API key?

Create a free account and generate a key from your dashboard. No credit card is required for the Free plan.

How do I authenticate requests?

Pass your key in the URL path (/api/v1/YOUR_KEY/latest) or as an Authorization: Bearer or X-API-Key header.

Which response formats are supported?

JSON by default, plus XML and CSV via the ?format= query parameter. Responses are gzip-compressed automatically.

Data & coverage

How many currencies do you cover?

Over 160 world currencies, each with a name, symbol and decimal metadata.

How often are rates updated?

Rates refresh hourly from trusted upstream sources. You can see freshness any time on the status page.

Can I convert between two non-USD currencies?

Yes. Rates are stored against USD and cross-rates are computed automatically, so pairs like GBP→JPY work out of the box.

Do you offer historical, crypto, stock and metal prices?

Yes - all four are available on the Pro plan and above. Historical rates go back to 1999, so you can reconcile or backtest against more than 27 years of daily data.

Plans & limits

Is there a free plan?

Yes, the Free plan includes 2,500 requests per month with no card required.

What are the rate limits?

Per-minute limits scale with your plan (Free 10, Pro 100, Business/Enterprise 1000). Every response includes X-RateLimit headers.

Can I change plans anytime?

Yes. Changes take effect immediately and your monthly quota adjusts right away.

How do I track my usage?

Your dashboard shows current-month usage, and the /usage and /quota endpoints return it programmatically.

Reliability & support

What happens if I hit my limit?

You receive a 429 response with a Retry-After header. Upgrade your plan for higher limits.

Will my integration break on updates?

No - the legacy, v1 and v2 URLs all keep working. We version the API so you can upgrade on your own schedule.

How do I get help?

Reach us through the contact page; paid plans receive priority support.

Still have a question? Get in touch