currency_api.constants

Documentation for eth_defi.currency_api.constants Python module.

Constants for the fawazahmed0 Exchange API integration.

Canonical API documentation: https://github.com/fawazahmed0/exchange-api

Module Attributes

`JSDELIVR_URL_TEMPLATE`	Primary host (jsDelivr CDN) URL template.
`PAGES_DEV_URL_TEMPLATE`	Fallback host (Cloudflare Pages) URL template.
`SOURCE_NAME`	Value written to the `source` column for rows fetched from this provider.
`DEFAULT_BASE_CURRENCY`	Default base currency.
`DEFAULT_QUOTE_CURRENCIES`	Default set of named quote currencies to scan.
`EARLIEST_AVAILABLE_DATE`	Earliest date for which the source publishes data: 2024-03-02.

JSDELIVR_URL_TEMPLATE = 'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@{date}/v1/currencies/{base}.min.json'

Primary host (jsDelivr CDN) URL template.

{date} is latest or an ISO YYYY-MM-DD date; {base} is the lower-cased base currency (e.g. usd). One request returns the base currency against ~200 fiat and crypto currencies.

PAGES_DEV_URL_TEMPLATE = 'https://{date}.currency-api.pages.dev/v1/currencies/{base}.min.json'

Fallback host (Cloudflare Pages) URL template.

Used when jsDelivr returns 404 or a transient error. The upstream docs recommend always having this fallback configured.

SOURCE_NAME = 'fawazahmed0'

Value written to the source column for rows fetched from this provider.

Future rate sources get their own string (e.g. frankfurter, coingecko).

DEFAULT_BASE_CURRENCY = 'usd': Default base currency. All rates are stored as “units of quote per 1 base”.

DEFAULT_QUOTE_CURRENCIES = ('eur', 'gbp', 'jpy', 'aud', 'sgd', 'hkd', 'try', 'chf', 'cad', 'btc', 'eth'): Default set of named quote currencies to scan.

EARLIEST_AVAILABLE_DATE = datetime.date(2024, 3, 2)

Earliest date for which the source publishes data: 2024-03-02.

Confirmed empirically by binary-searching the date-pinned endpoint — 2024-03-02 returns HTTP 200 while 2024-03-01 and every earlier date (all of 2020–2023, and 2019) return HTTP 404. There is no pre-2020 history, indeed nothing before 2024-03-02; the legacy GitHub-hosted endpoint serves nothing either. A scan requested from an earlier date is clamped to this floor. Adjust here if the provider ever backfills older history.

CURRENCY_API_DATABASE = PosixPath('/home/runner/.tradingstrategy/currency-api/exchange-rates.duckdb'): Default DuckDB database path.