Skip to content

v2.0.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 02 Apr 09:00
· 302 commits to main since this release
479d6dd

Added

  • v2 API at /v2/ endpoints with multi-provider blended exchange rates
  • 35 data providers: ECB, BOC, TCMB, NBU, CBA, NBRB, BOB, CBR, NBP, NBP.B, FRED, BNM, RBA, BCRA, CBK, BOJ, BOJA, IMF, NBRM, BCEAO, BOI, BCCR, NB, NBG, HKMA, RB, BCB, BCCh, Banxico, BOE, FBIL, BANREP, SBI, CBC, BAM, BOT, Riksbank
  • Precious metal quotes (XAU, XAG, XPT, XPD)
  • Pegged currency expansion at query time
  • /v2/rate/{base}/{quote} endpoint for single currency pair lookups
  • /v2/rate/{base}/{quote}/{date} for historical single pair lookups
  • /v2/providers endpoint listing available data sources with date ranges and currency coverage
  • /v2/currencies endpoint with provider coverage per currency
  • providers parameter to scope rates and currencies to specific sources
  • group parameter to downsample time series (week or month)
  • CSV and NDJSON streaming output for rate endpoints
  • Outlier detection and filtering for rate quality
  • Recency-weighted blending
  • Strict parameter validation — unknown parameters return 422

Fixed

  • Fixed rounding when amount is 1 and base is EUR (#173)
  • Fixed TCMB rate direction by switching to buy/sell series
  • Fixed CBK inverted cross rates and per-unit parsing
  • Fixed NBRM rate parsing for denominated currencies
  • Fixed BCRA dates with duplicate currency entries
  • Fixed BCEAO number format parsing

Removed

  • Removed JSONP

Migrating from v1

The v1 API will remain available at /v1/ endpoints. To migrate to /v2:

  • Change your base URL from /v1/latest to /v2/rates.
  • Update response parsing: rates are now an array of {"date", "base", "quote", "rate"} objects instead of {"base", "date", "rates": {"USD": 1.23}}.
  • The symbols parameter is renamed to quotes.
  • The from and to parameters are now used for date ranges in v2.