Skip to main content
Ratio provides a REST API for partners to request FX quotes, execute swaps, and receive settlement confirmations. This page covers authentication, rate limits, and the complete integration flow.

​
Base URLs

All endpoints are prefixed with /v1/.
Use the sandbox environment to build and test your integration. All stablecoins are test tokens with no real value. Sandbox API keys are issued alongside production keys during onboarding.
Both environments expose identical API endpoints with the same request and response formats.

​
Authentication

Every API request requires two headers: API keys are 256-bit random tokens issued during onboarding. Sandbox and production keys are separate. Keys rotate on a 90-day cycle, with emergency revocation available.

​
Rate limits

Rate-limited responses return HTTP 429 with a Retry-After header indicating the number of seconds to wait before retrying.

​
Integration flow

1

Get an indicative quote

Call GET /v1/quote to retrieve a reference price for a currency pair. Use this to display approximate rates to your users before they commit to a trade.Indicative quotes →
2

Request a firm quote

Call POST /v1/firm-quote to lock an executable rate with inventory reservation. The quote carries a hard expiry timestamp — typically 30–60 seconds.Firm quotes →
3

Execute the swap

Call POST /v1/execute with the quote_id from the firm quote. The swap settles atomically on the Kaia blockchain.Executing swaps →
4

Receive settlement confirmation

Settlement status is returned synchronously in the execute response. Ratio also delivers webhook callbacks for asynchronous confirmation.Settlements & webhooks →
Step 1 is optional. You can skip directly to a firm quote if you don’t need to preview pricing for your users.

​
Partner configuration

During onboarding, Ratio configures the following parameters for each partner: These parameters are managed by Ratio. Contact your account manager to request changes.