Official libraries

Language	Code	Repository
PHP	https://github.com/everapihq/freecurrencyapi-php (opens new window)	https://packagist.org/packages/everapi/freecurrencyapi-php (opens new window)
Python	https://github.com/everapihq/freecurrencyapi-python (opens new window)	https://pypi.org/project/freecurrencyapi/ (opens new window)
R	https://github.com/everapihq/freecurrencyapi-r (opens new window)	https://cran.r-project.org/web/packages/freecurrencyapi/index.html (opens new window)
Go	github.com/everapihq/freecurrencyapi-go	https://pkg.go.dev/github.com/everapihq/freecurrencyapi-go (opens new window)
Ruby	https://github.com/everapihq/freecurrencyapi-ruby (opens new window)	https://rubygems.org/gems/freecurrencyapi-official (opens new window)
JavaScript ES6 module	https://github.com/everapihq/freecurrencyapi-js (opens new window)	https://www.npmjs.com/package/@everapi/freecurrencyapi-js (opens new window)
Rust	https://github.com/everapihq/freecurrencyapi-rs (opens new window)	https://crates.io/crates/freecurrencyapi-rs (opens new window)
C#	https://github.com/everapihq/freecurrencyapi-dotnet (opens new window)	https://www.nuget.org/packages/freecurrencyapi/ (opens new window)

Authentication & API key Information

freecurrencyapi.com uses API keys to allow access to the API.

Authentication methods

To authorize, you can use the following ways:

GET query parameter

You can pass your API key along with every request by adding it as a query parameter apikey

WARNING

This method could expose your API key in access logs and such. Sending the API key via a header parameter as specified below circumvents this problem.

HTTP Header

You can set a request header with the name apikey

Rate limit and quotas

You can use a certain amount of requests per month. Once you go over this quota you will be presented with a 429 HTTP status code, and you have to wait a month to do more requests.

We enforce a minute rate limit for each plan. If you exceed this you will also be presented with a 429 HTTP status code. You then have to wait until the end of the minute to do more requests.

Not every request counts

Only successful calls count against your quota. Any error on our side or any validation error (e.g. wrong parameter) will NOT count against your quota or rate limit.

Response Headers

We attach certain headers to tell you your current monthly/minute quota and how much you have remaining in the period.

X-RateLimit-Limit-Quota-Minute: 10
X-RateLimit-Limit-Quota-Month: 300

X-RateLimit-Remaining-Quota-Minute: 5
X-RateLimit-Remaining-Quota-Month: 199