Changelog & API Versions

Every release, deprecation notice, and breaking change — documented. Build on ChainOptics with confidence.

API Version

v2.1
Released Mar 3, 2026  CURRENT

Site Version

1.2.0
Released Mar 3, 2026  CURRENT

API v1 Status

v1
Active  STABLE
Deprecates Jan 1, 2027

Next Event

v1 Deprecation
Jan 1, 2027  PLANNED

⚠️ Deprecation Notices

API v1 — Deprecation Scheduled

All /api/v1/ endpoints are stable and fully functional today. They will be deprecated on January 1, 2027 and sunset (removed) on April 1, 2027. No action required until then.

You will receive a Deprecation and Sunset HTTP header on every v1 response starting now — useful for automated monitoring.

VersionStatusDeprecated DateSunset (Removal) DateMigration
/api/v1/*STABLEJan 1, 2027Apr 1, 2027Migration guide ↓

90-day notice is given before any breaking change. Breaking changes never happen on a stable version without advance notice. Subscribe below to receive deprecation notices by email.

Release History

Both API and site versions are tracked here. Response headers always carry X-API-Version and X-API-Changelog so you can detect version changes programmatically.

API v2.2.0 FEATURE SITE v2.0.0 April 16, 2026
Intraday Charts, SPA Architecture, Auth Fixes & Ecosystem Standardization
  • NEW API: GET /api/candles/:symbol?interval=N — intraday OHLC + volume candles via Kraken. Intervals: 1, 5, 15, 30, 60, 240 minutes. Returns up to 720 candles per request. Requires authentication.
  • FIX API: GET /api/history/:symbol now available to Free tier (capped at 7 days). Previously incorrectly gated Pro/API only.
  • FIX API: Webhook URLs on price alerts now correctly restricted to API tier only.
  • SITE: App converted to SPA — client-side router, shared shell, single index.html entry point. Dashboard, Assets, Portfolio, Alerts, and Profile all rendered as views.
  • SITE: Asset chart upgraded — line/candlestick/OHLC bar/histogram toggle with volume pane below. Chart type persists when switching timeframes.
  • SITE: Intraday range buttons added — 1m, 5m, 15m, 30m, 1H, 4H alongside existing 1M/3M/1Y daily ranges.
  • SITE: Chart auto-refresh — intraday charts refresh automatically (1m=30s, 5m=1min, 15m-1H=2min, 4H=5min). Last-updated timestamp shown. Daily charts do not auto-refresh.
  • SITE: Login page — API key auth tab removed. Email + password only, matching OnRampDLT and InvoiceDLT auth pattern.
  • SITE: pay-crypto.html rebuilt — ChainOptics design system, RLUSD/XRP/USDC support (USDT removed — not on XRPL), live XRP price fetch, QR code, memo field instructions, wallet address wired.
  • SITE: Legal pages (Terms, Privacy, FAQ, Support) replaced with substantive production-ready content.
  • INFRA: GitHub repo (RHinAK/chainoptics) created. GH Actions auto-deploy to CF Pages on every push to main.
  • INFRA: Stripe worker secrets updated to new StackStats Apps LLC account. Production webhook endpoint registered.
  • ECOSYSTEM: Byline "by StackStats Apps" standardized across ChainOptics, InvoiceDLT, and OnRampDLT. Footer normalized to "StackStats Apps LLC" sitewide.
  • ECOSYSTEM: Subscription confirmation modal added to InvoiceDLT and OnRampDLT pricing flows (already present in ChainOptics).
  • ECOSYSTEM: Orbitron font restored for product wordmarks. Plus Jakarta Sans 600 for byline text. All Google Fonts imports corrected sitewide.
API v2.1.0 FEATURE SITE v1.2.0 March 3, 2026
Correlation Cascade Indicator + API Versioning Infrastructure
  • NEW: GET /api/v1/correlation/:symbol — Pearson correlation coefficient vs BTC (for XRP) or XRP (for rail assets). 7-day free, 30-day Pro/API.
  • NEW: X-API-Version header on every response — detect the running version programmatically.
  • NEW: X-API-Changelog header — always points to this page.
  • NEW: Deprecation + Sunset headers on all /api/v1/ responses — machine-readable deprecation dates per RFC 8594.
  • NEW: API root response now includes full versioning block with deprecation dates and policy.
  • SITE: Asset detail pages now show correlation cascade panel (BTC/XRP or XRP/rail).
  • SITE: Pricing cards updated — correlation feature listed on Pro/API tiers.
  • DOCS: Section 10 added — "How to Read the Correlation Cascade" with full cascade logic guide.
  • INFRA: This changelog page + versioning policy + VERSIONING.md added.
API v2.0.0 FEATURE SITE v1.0.0 March 2026 (Launch)
Initial Public Launch
  • NEW: 7 DLT rail assets: XRP, XLM, HBAR, QNT, FLR, XDC, ALGO — live prices, 24h stats, VWAP.
  • NEW: GET /api/prices — all assets in one call.
  • NEW: GET /api/history/:symbol — OHLC history (7-day free, 365-day Pro/API).
  • NEW: GET /api/chain/:symbol — live on-chain health metrics (Pro/API).
  • NEW: POST /api/portfolio/value — multi-asset portfolio valuation (Pro/API).
  • NEW: /api/alerts — price alerts with threshold triggers (Pro/API).
  • NEW: /api/v1/* versioned aliases for all endpoints — guaranteed stable.
  • NEW: Stripe-based subscription: Free, Pro ($29/mo), API ($99/mo).
  • SITE: Dashboard, asset detail pages, portfolio, alerts, docs, pricing, FAQ, support.

Migration Guide: v1 → v2

v1 and v2 are currently identical in behavior. The /api/v1/ prefix is an alias for stability — it will remain in place until April 1, 2027. This section documents the planned differences when v2 routes are extended.

No changes required today

Both paths return the same data. Use whichever is convenient — or pin to /api/v1/ for guaranteed stability through the deprecation window.

# Current v1 path (stable until Apr 1, 2027)
GET https://api.chainoptics.io/api/v1/correlation/XRP

# Current v2 path (same response, shorter URL)
GET https://api.chainoptics.io/api/correlation/XRP

# Both return X-API-Version: 2.1.0

How to detect deprecation programmatically

# Check response headers on any request
curl -I https://api.chainoptics.io/api/v1/prices

# Headers you will see on v1 routes:
# X-API-Version: 2.1.0
# X-API-Changelog: https://chainoptics.io/changelog
# Deprecation: date="2027-01-01"
# Sunset: 2027-04-01
# Link: <https://chainoptics.io/changelog>; rel="deprecation"

Versioning policy

  • Stable versions never receive breaking changes without 90-day advance notice.
  • Additive changes (new fields, new endpoints) are non-breaking and may happen at any time.
  • Field renames, removals, or response structure changes are always breaking — version-gated.
  • Deprecation emails are sent to all API key holders 90 days before any deprecation date.
  • Sunset emails are sent 30 days and 7 days before removal.

Upcoming / On Deck

Not a commitment — just what's being considered for the next releases.

  • /api/v1/dominance/:symbol — market share % among tracked rail assets
  • /api/v1/sentiment/:symbol — social + on-chain sentiment score
  • Webhook delivery for alerts (API tier)
  • Historical correlation data endpoint (30-day rolling window)
  • API key usage dashboard (request counts, top endpoints, errors)