Skip to main content
This section covers every Ratio API endpoint. For step-by-step integration guidance, see the Integration Guide.

​
Base URLs

EnvironmentBase URL
Sandboxhttps://api.sandbox.ratiofx.com/v1
Productionhttps://api.ratiofx.com/v1
Sandbox connects to the Kaia Kairos testnet. No real funds are involved. Production connects to the Kaia mainnet and involves live stablecoins.

​
Authentication

Every request requires the following headers:
HeaderValue
AuthorizationBearer {api_key}
X-Partner-ID{partner_id}
Content-Typeapplication/json
API keys are 256-bit random tokens issued during onboarding. Sandbox and production keys are separate. 
curl -X GET "https://api.ratiofx.com/v1/quote?pair=USD-IDR&side=BUY&amount=10000" \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "X-Partner-ID: partner_uuid_xyz" \
  -H "Content-Type: application/json"

​
Endpoint index

​
Quotes and execution

MethodEndpointDescriptionReference
GET/v1/quoteIndicative quote — no inventory reservationQuotes API
POST/v1/firm-quoteFirm executable quote with inventory reservationQuotes API
POST/v1/executeExecute a firm quote for on-chain settlementSwaps API

​
System

MethodEndpointDescriptionReference
GET/v1/system/stateCurrent system state per corridorSwaps API

​
Webhook events

EventTriggerReference
settlement.confirmedSwap settled on-chain successfullyWebhooks
settlement.failedSwap execution failedWebhooks
quote.expiredFirm quote expired without executionWebhooks
system.state_changeA corridor’s system state changedWebhooks