CurrencyScoop API

Currency Exchange / API Key Intermediate HTTPS CORS

77 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

CurrencyScoop (now CurrencyBeacon) provides real-time and historical exchange rates for 170+ currencies and cryptocurrencies via a REST API. An API key is required; a free plan with limited monthly requests is available. It supports latest rates, historical rates, time-series queries, and currency conversion endpoints.

Beginner Tip

Register at currencybeacon.com (the current brand name for CurrencyScoop) to get your free API key. Call GET /v1/latest?api_key=YOUR_KEY to retrieve all rates. The free plan allows up to 5,000 requests per month.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

exchange rate between currencies

conversion result

supported currency list

historical rates

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "base": "USD",
  "date": "2025-01-15",
  "rates": {
    "EUR": 0.92,
    "GBP": 0.79,
    "JPY": 149.5,
    "CAD": 1.35
  }
}

Field Reference

meta.code HTTP status code of the response; 200 means success.

response.base The base currency for all exchange rates.

response.date The date the rates were collected.

response.rates Key-value pairs of currency codes to their exchange rate relative to the base currency.

response.rates.EUR Example: the rate of EUR relative to the base currency as a numeric value.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://currencyscoop.com/api-documentation";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

API endpoint not found (404) The service has rebranded from CurrencyScoop to CurrencyBeacon and the base URL has changed

✓ Use the current base URL https://api.currencybeacon.com/v1/ instead of any old currencyscoop.com URLs.

401 Unauthorized Missing or invalid api_key parameter

✓ Include ?api_key=YOUR_KEY in every request. Generate your key at currencybeacon.com after registration.

Empty response for historical date Querying a date before the service started collecting data for that currency

✓ Check the API documentation for the earliest available historical date. Most currencies are available from 2019 onward.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →