API Reference

This section provides a compact reference for all partner API endpoints. For step-by-step integration guidance, see the Integration Guide.

Base URLs

Environment	URL	Chain
Sandbox	`https://sbx.ratiofx.com/api/router`	Kaia Kairos (`1001`)
Production	`https://app.ratiofx.com/api/router`	Kaia mainnet (`8217`)

Every request must be signed with HMAC-SHA256:

Header	Value
`x-ratio-api-key`	Your API key (starts with `rk_`)
`x-ratio-timestamp`	Unix timestamp in seconds
`x-ratio-request-id`	POST only — unique replay-protection ID
`x-ratio-signature`	HMAC-SHA256 signature, lowercase hex
`Content-Type`	`application/json` (POST requests)

See Authentication details for string-to-sign format and examples.

Method	Endpoint	Description	Reference
`POST`	`/v1/quote`	Indicative quote (not executable)	Quotes API
`POST`	`/v1/firm-quote`	Firm executable quote with EIP-712 signature and calldata	Quotes API

Method	Endpoint	Description	Reference
`GET`	`/v1/executions`	Execution lookup (by quote, tx, or client_ref) or paginated history	Executions API

Method	Endpoint	Description	Reference
`GET`	`/v1/corridors`	Available corridors, token addresses, limits, fee tiers, risk state	Market API
`GET`	`/v1/rates`	Current oracle mid-market rates per corridor	Market API

Method	Endpoint	Description	Reference
`GET`	`/v1/reports/daily-summary`	Partner-scoped daily reconciliation summary	Reconciliation