跳转到内容
POST AI agent ready /v1/currency/rates

Currency Rates API - Bulk ECB Exchange Rates

Fetches the full rate table from Frankfurter.dev for the given base currency (defaults to USD) and returns every cross rate in a single response. The date field reflects the business day the ECB published the rates.

Parameters

string

Base currency code (ISO 4217). Defaults to USD.

Code examples

curl -X POST https://api.botoi.com/v1/currency/rates \
  -H "Content-Type: application/json" \
  -d '{"base":"EUR"}'

When to use this API

Populate a currency selector with live prices

On an e-commerce product page, cache the rates from this endpoint for 1 hour and show prices in every supported currency. One call powers the entire picker without N individual conversion requests.

Batch convert order history

When generating a multi-currency revenue report, pull all rates once and convert thousands of rows in-process. Much cheaper than calling /v1/currency/convert per row.

FX rate alerting

Poll daily and compare to the previous day. Alert when any target currency moves more than 2% against the base, useful for treasury teams managing invoiced FX exposure.

Frequently asked questions

How often do rates update?
Once per business day at approximately 16:00 CET when the ECB publishes its reference rates. The date field in the response reflects the most recent business day with data.
Can I use any currency as the base?
Any of the 30+ ECB-tracked currencies. The same cross-rate set is available regardless of base; the values are just renormalized.
Why are some currencies missing?
Frankfurter follows the ECB reference list. Currencies outside that list (many emerging markets, some African currencies) are not published. Use a commercial FX provider for exotic pairs.
Is this suitable for trading?
No. ECB reference rates are mid-market midday prints, not tradable quotes. For execution-grade pricing use a real-time FX feed from a broker or bank.
What happens on weekends?
The endpoint returns the rates from the most recent business day. Saturday and Sunday responses are identical to Friday's.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs