CurrencyBeacon API

Name: CurrencyBeacon API API
Brand: CurrencyBeacon API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey, bearer5 EndpointsREST

For Agents

Look up live and historical foreign-exchange rates, convert amounts between currencies, and retrieve time-series data for over 168 fiat currencies and 2,000 cryptocurrencies.

Quickstart

Get started with CurrencyBeacon API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"convert currency to another currency"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with CurrencyBeacon API API.

Retrieve the latest mid-market exchange rates against a base currency for fiat and crypto pairs

Pull historical exchange rates for any specific date back through CurrencyBeacon's archive

Convert a specified amount from one currency to another using current or historical rates

Fetch time-series exchange rate data across a date range for charting or backtesting

GET STARTED

Start building with CurrencyBeacon API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for CurrencyBeacon API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for CurrencyBeacon API, keeping it validated and agent-ready. CurrencyBeacon (formerly CurrencyScoop) exposes a REST interface for real-time and historical exchange rates covering more than 168 fiat currencies and over 2,000 cryptocurrencies. Rates are aggregated from commercial banks and exchange providers, with endpoints for live quotes, historical lookups, currency conversion, and time-series ranges. The API authenticates either by API key passed as a query parameter or by bearer token.

Use Cases

Patterns agents use CurrencyBeacon API API for, with concrete tasks.

★ Multi-Currency Checkout Pricing

Display localised prices in a customer's home currency at checkout by fetching live rates against a base currency. The /latest endpoint returns mid-market rates for over 168 currencies in a single call, so storefronts can refresh quotes once per session and convert SKU prices client-side. Suitable for low-volume conversion display where settlement still happens in a single base currency.

Call GET /latest with base=USD and symbols=EUR,GBP,JPY,INR and use the returned rates to render localised prices for a product priced at 49.99 USD

Historical FX Reporting

Reconcile historical invoices, expenses, or accounting entries by retrieving the exchange rate that applied on a specific transaction date. The /historical endpoint accepts a date parameter and returns rates for all supported currencies, useful for finance teams generating multi-currency reports or auditors verifying booked FX values.

Call GET /historical with date=2024-06-15 and base=USD to retrieve the EUR/USD rate that applied on that day for an invoice reconciliation

Crypto Portfolio Valuation

Value a portfolio that mixes fiat and cryptocurrency holdings by pulling current rates against a single accounting currency. CurrencyBeacon covers more than 2,000 cryptocurrencies alongside fiat, so a single /latest call can return BTC, ETH, and stablecoin rates plus the fiat side of the book.

Call GET /latest with base=USD and symbols=BTC,ETH,USDC,EUR,GBP and compute total portfolio value from holdings supplied by the user

Time-Series FX Charting

Build line charts of exchange rate movement over a date range without scraping or storing historical data locally. The /timeseries endpoint returns a date-keyed object of rates between a start and end date, suitable for treasury dashboards or hedging analysis where teams need to see trend behaviour at a glance.

Call GET /timeseries with start_date=2025-01-01, end_date=2025-01-31, base=USD, symbols=EUR and return a daily rate series for plotting

AI Agent FX Lookup via Jentic

An AI agent answering a question like 'how much is 500 euros in dollars?' uses Jentic to discover and execute the right CurrencyBeacon operation. The agent searches for 'convert currency', loads the /convert schema, supplies from, to, and amount, and returns the converted value without the developer wiring up CurrencyBeacon directly.

Use Jentic to search 'convert currency' and execute /convert with from=EUR, to=USD, amount=500 to answer a user question

Key Endpoints

5 endpoints — jentic publishes the only available openapi specification for currencybeacon api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/latest

Get latest exchange rates against a base currency

GET

/historical

Get exchange rates for a specific date

GET

/convert

Convert an amount between two currencies

GET

/timeseries

Get exchange rates across a date range

GET

/currencies

List supported fiat and cryptocurrency codes

GET

/latest

Get latest exchange rates against a base currency

GET

/historical

Get exchange rates for a specific date

GET

/convert

Convert an amount between two currencies

GET

/timeseries

Get exchange rates across a date range

GET

/currencies

List supported fiat and cryptocurrency codes

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

CurrencyBeacon API keys and bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped access to call the API; the raw key is never placed into the agent's context window.

Intent-based discovery

Agents search by intent (e.g. 'convert currency' or 'historical exchange rate') and Jentic returns the matching CurrencyBeacon operation with its parameter schema, ready to execute.

Time to first call

Direct CurrencyBeacon integration: a few hours for auth, error handling, and date parsing. Through Jentic: under 10 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

CurrencyAPI

Similar live and historical FX coverage with a different free-tier ceiling

Choose CurrencyAPI if you need a higher monthly free quota or are already using their currency code conventions.

Alternative

ExchangeRate-API

Free fiat-only exchange rate API without crypto coverage

Choose ExchangeRate-API if you only need fiat rates and want a simpler free plan without crypto support.

Alternative

CurrencyFreaks API

Live, historical, and convert endpoints across 180+ currencies

Choose CurrencyFreaks if you want a comparable feature set with a different pricing model.

FAQs

Specific to using CurrencyBeacon API API through Jentic.

Why is there no official OpenAPI spec for CurrencyBeacon API?

CurrencyBeacon does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CurrencyBeacon API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the CurrencyBeacon API use?

The API supports two methods: an API key supplied as the api_key query parameter, or a bearer token in the Authorization header. Through Jentic the credential is stored in the encrypted vault and injected at call time, so the raw key never enters the agent's prompt.

Can I retrieve historical exchange rates with the CurrencyBeacon API?

Yes. Call GET /historical with a date parameter (YYYY-MM-DD) and an optional base and symbols list to retrieve the rates that applied on that date across all supported currencies.

What are the rate limits for the CurrencyBeacon API?

Rate limits depend on the CurrencyBeacon plan tier and are enforced by the vendor; the spec does not encode exact numbers. Free plans typically permit a few thousand calls per month, while paid plans raise the ceiling. Check your CurrencyBeacon dashboard for the current quota.

How do I convert an amount between two currencies through Jentic?

Run pip install jentic, then search for 'convert currency', load the /convert operation, and execute it with from, to, and amount parameters. Jentic returns the converted value and the rate used.

Is the CurrencyBeacon API free?

CurrencyBeacon offers a free tier suitable for low-volume use and paid plans for higher request volumes, real-time updates, and full historical access. Pricing is set on the vendor's website.