Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ratiofx.com/llms.txt

Use this file to discover all available pages before exploring further.

​
General

Ratio is a stablecoin orchestration layer (SOL) purpose-built for institutional cross-border payments in Asia. It provides a unified API for stablecoin FX execution, liquidity management, and atomic settlement on the Kaia blockchain.
Ratio is B2B infrastructure. It serves banks, payment service providers (PSPs), stablecoin issuers, exchanges, liquidity providers, and remittance operators — not retail end users directly.
Ratio is built on the Kaia blockchain, a high-performance Layer 1 with BFT consensus, sub-second finality, and full EVM compatibility.
Phase 1 supports three APAC corridors: USD ↔ IDR, USD ↔ SGD, and MYR ↔ IDR. Additional corridors (JPY, KRW, CNH, PHP, THB) are planned. See Supported Corridors.
Ratio is available to institutional partners through a structured onboarding process. Contact the team at partnerships@ratiofx.com to begin. After KYB verification, you receive sandbox credentials and can start integrating. See Onboarding Process.

​
Pricing and fees

Ratio uses oracle-based pricing from Pyth Network — real-time institutional FX data — not AMM bonding curves. Every quote is anchored to the actual market rate. See Oracle-Based Pricing.
No. Unlike AMM-based DEXs, Ratio’s execution quality does not degrade with transaction size. A $100K swap gets the same spread as a $1K swap within the same volume tier.
Fees are volume-tiered — larger transactions receive lower rates. Each corridor has its own tier schedule. Fees consist of a small fixed component and a variable component measured in basis points. See Fee Structure.
No. Every quote response includes a full fee breakdown showing the fixed fee, variable fee, base spread, and total spread. The rate you see in the firm quote is the rate you get at execution.
An indicative quote is a reference price for display or planning purposes. It carries no inventory reservation, has no expiry, and is not executable.A firm quote is a binding, executable price with a hard expiry timestamp and inventory reservation. Accepting a firm quote triggers the atomic swap on-chain.
If you do not execute a firm quote before its expiry timestamp, the reservation is released and the quote becomes void. You must request a new firm quote to proceed. Ratio will send a webhook event when a quote expires if you have webhooks configured.
Settlement is under 1 second. Ratio uses the Kaia blockchain’s BFT consensus, which provides deterministic, immediate finality. There are no T+ delays and no cutoff windows.

​
Integration

No. Ratio’s API abstracts all on-chain operations. You send REST API requests and receive settlement confirmations — no wallet management, transaction signing, or gas fees required.
Typical integration takes 1–3 weeks from API credential issuance through sandbox certification. The timeline depends on partner type and integration complexity. See Onboarding Process.
Yes. Ratio provides a full sandbox on Kaia’s Kairos testnet with simulated oracle feeds, mock pool balances, and configurable test scenarios. See Sandbox and Testing.
Rate limits apply per API key and vary by endpoint type. Indicative quote endpoints have higher limits than firm quote and execution endpoints. Specific limits are provided in the API reference and in your onboarding documentation. See Rate Limits & Errors.
Ratio’s risk management system uses graduated circuit breakers rather than a hard shutdown. The system progressively widens spreads, reduces limits, and restricts trade directions as conditions deteriorate. A full trading halt (HALT state) is rare and the system recovers automatically when conditions improve. You can check current corridor state at any time using the /v1/system/state endpoint. See Risk Management.

​
Liquidity providers

Contact the Ratio team to begin the LP onboarding process. The minimum deposit is $50,000 equivalent. See LP Participation.
LP returns depend on swap volume and pool utilisation. LPs earn a share of swap fees proportional to their pool share, distributed automatically via kToken rebasing. Class B LPs also earn yield from deployed strategies.
No. Ratio uses single-sided pools — you deposit one stablecoin and receive the same stablecoin back. There is no paired-pool rebalancing and therefore no impermanent loss.
LP withdrawals are subject to a cooldown period to protect pool stability. After the cooldown expires, withdrawals are processed in FIFO order. See LP Participation.

​
Security

Ratio’s smart contracts are deployed on the Kaia blockchain and undergo security review. Contact the team for the latest audit reports.
Settlement data is recorded on the Kaia blockchain (immutable, public). Partner configuration and operational data is stored off-chain in Ratio’s secure backend infrastructure.
API keys are 256-bit random tokens issued during onboarding. Keys rotate on a 90-day cycle with emergency revocation available. Sandbox and production keys are separate.