Documentation

API Changelog

This changelog documents all changes, updates, and new features in the CurrencyApi.net API. We recommend checking this page regularly to stay informed about new features, improvements, and any breaking changes.

For detailed migration instructions when upgrading between versions, see our migration guide.

Version 2 (Current)

Release Date: February 2026

Version 2 introduces significant improvements and new features:

  • New Endpoint: Added /api/v2/ohlc endpoint for OHLC (Open, High, Low, Close) price data
  • Currency Changes: 24 currencies added and 10 currencies removed (152 to 166 total)
  • Currencies Added (24): ADA, BNB, BYN, CLF, DOGE, DOT, ERN, FKP, GGP, JEP, LINK, MGA, MNT, MRO, SHP, SOL, STN, SYP, USDC, USDT, VES, VUV, XCG, XPF
  • Currencies Removed (10): BCH, BTG, CNH, CUP, DASH, EOS, PGK, SBD, TOP, XLM
  • Updated Error Codes: Improved error handling with updated HTTP status codes and new error codes for better debugging
  • Enhanced Error Responses: More accurate HTTP status codes (401 now returns 401, 417 now returns 404, 500 now returns 500)
  • New Error Codes: 405 (monthly allowance), 421 (ohlc - no data for date), 422 (ohlc - no data for currency), 423 (ohlc - invalid interval), 424 (ohlc - date older than 30 days)
  • URL Changes: All endpoints now use /api/v2/ instead of /api/v1/

Version 1 (Deprecated)

Release Date: September 2019

Removal Date: 31st July 2026

Version 1 was the initial release of the CurrencyApi.net API, featuring:

  • Core Endpoints: Rates, Convert, History, Timeframe, Currencies
  • Currency Support: 152 supported currencies
  • Response Formats: JSON and XML support
  • SDK Support: Official SDKs for Python, PHP, Node.js, and Go
  • Error Handling: Comprehensive error code system

Note: Version 1 is deprecated and will be removed on 31st July 2026. Please migrate to v2 for the latest features and improvements.