CurrencyCore SDK for Python

Official client for the CurrencyCore API — currency conversion, FX rates, PPP, and analytics.

Generated from the CurrencyCore OpenAPI 3.1 spec with OpenAPI Generator (python, urllib3), plus a thin create_client helper for API-key and version handling.

• Website: https://currency-core.com
• Documentation: https://currency-core.com/docs

Install

pip install currencycore

Quickstart

from currencycore.client import create_client

api = create_client(api_key="cc_live_...")  # or set CURRENCYCORE_API_KEY
res = api.convert(var_from="USD", to="EUR", amount=100)
print(res.results[0])

var_from carries the var_ prefix because from is a reserved word in Python.

Public reference endpoints need no key:

api = create_client()
print(api.currencies())

Endpoints

All 14 endpoints are methods on the api client. * marks a required argument; the rest are optional. from/date become var_from/var_date (reserved words). Public = no key; Free = any plan with a key; Growth = Growth plan or higher.

More calls:

api.rates()                                          # latest snapshot (USD base)
api.rates_by_base(base="EUR")                        # same snapshot, EUR base
api.history(currency="INR", var_from="2024-01-01")
api.volatility(universe="majors", sort="volatile")   # most-volatile majors
api.ai(q="How has the rupee moved this year?")

API key

create_client resolves the key as api_key → CURRENCYCORE_API_KEY.

API version

Base URL is https://api.currency-core.com/{version} (default v1):

create_client(version="v1")
create_client(base_url="https://api.currency-core.com/v1")

Low-level client

import currencycore

config = currencycore.Configuration(
    host="https://api.currency-core.com/v1", access_token="cc_live_..."
)
api = currencycore.CurrencyCoreApi(currencycore.ApiClient(config))

Regenerate

The committed openapi.json is the source of truth:

bash scripts/generate.sh

Hand-written files (currencycore/client.py, this README) are protected by .openapi-generator-ignore.

License

MIT