Skip to main content
All notable changes to Ratio’s platform and API are recorded here. Entries are listed in reverse chronological order.
Future releases will be documented here as they ship. Each entry will include the release date, version, and a summary of platform changes, new corridors, API updates, and documentation additions.

​
September 2026

​
v0.2 — API rewrite and documentation corrections

Changed
  • API authentication is HMAC-SHA256 signed requests (x-ratio-api-key, x-ratio-timestamp, x-ratio-signature, plus x-ratio-request-id on POST)
  • Quote requests use corridor_id, from_token and to_token instead of pair and side
  • Execution is on-chain: the partner wallet submits commitFirmQuote with the calldata returned by POST /v1/firm-quote; there is no execute endpoint and no webhooks — track settlement with GET /v1/executions
  • Base URLs: Sandbox https://sbx.ratiofx.com/api/router, Production https://app.ratiofx.com/api/router
  • Supported stablecoins: USDT, IDRX, IDRP, JPYC (tnSGD removed)
Documentation
  • Integration flow: approve the input token before requesting a firm quote; sandbox FxEngine address added
  • Fees: fee_breakdown example now matches the API response; tiers are MICRO, SMALL, MEDIUM; partner-specific pricing (STANDARD with discount, or FIXED_INPUT_RATE) documented
  • Oracle pricing: Pyth Network (primary), RedStone (fallback) and OANDA (cross-check), with an on-chain check against Orakl Network feeds at execution
  • LP participation: kTokens are share tokens (k<TOKEN>-fx, k<TOKEN>-full); swap fees accrue on-chain and are claimed in USDT; deposit cooldown, withdrawal queue and notice periods described
  • Risk management: FREEZE state added
  • Errors: plain-text error responses and 429 retry guidance clarified; there are no per-endpoint rate limits
  • Sandbox: live price feeds; daily volume limits
  • Corridor, pool, pricing and architecture diagrams updated

​
April 2026

​
v0.1 — Initial release

Added
  • Phase 1 corridors live: USDT-IDRX, USDT-IDRP, USDT-JPYC, IDRX-JPYC, IDRP-JPYC
  • Supported stablecoins: USDT, IDRX, IDRP, JPYC
  • Smart contracts deployed on Kaia Kairos testnet
  • Sandbox environment available for partner integration testing
  • Indicative and firm quote endpoints (POST /v1/quote, POST /v1/firm-quote)
  • Execution lookup and history (GET /v1/executions)
  • Corridor and rates endpoints (GET /v1/corridors, GET /v1/rates)
  • Daily reconciliation endpoint (GET /v1/reports/daily-summary)
  • Oracle-based pricing via Pyth Network
  • Volume-tiered fee schedule per corridor
  • kToken share accounting for LP positions
Documentation
  • Published Get Started section: Welcome, How Ratio Works, Supported Corridors, Key Concepts
  • Published Features section: Oracle-Based Pricing, Atomic Settlement, Liquidity and Pools, Rebalancing, Fee Structure, Risk Management, Compliance
  • Published Architecture section: System Overview, Kaia Blockchain, Oracle Infrastructure
  • Published Integration Guide: Overview, Indicative Quotes, Firm Quotes, Executing Swaps, Settlements and Verification, Error Handling
  • Published Partner Ecosystem section: Partner Types, Onboarding Process, Sandbox and Testing, Going Live, LP Participation
  • Published API Reference: Quotes API, Swaps API, Execution Tracking, Rate Limits and Errors
  • Published Resources section: FAQ, Glossary, Changelog, Support