Currencyscoop CurrencyBeacon API

Name: CurrencyBeacon 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.

Install Jentic One Beta

Connect the CurrencyBeacon API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CurrencyBeacon API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with CurrencyBeacon 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

GET STARTED

Start building with CurrencyBeacon API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use CurrencyBeacon 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 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.

FAQs

Specific to using CurrencyBeacon 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.