Skip to main content
Ratio provides a dedicated sandbox environment on Kaia’s Kairos testnet that mirrors production behaviour. Use the sandbox to develop, test, and certify your integration before any real funds flow.

​
Sandbox environment

The sandbox exposes the same API endpoints as production with identical request/response formats. Your integration code should work in both environments with only a base URL and API key change.

​
Getting sandbox access

Sandbox credentials are issued during Stage 3 (Technical integration) of onboarding:
  • Sandbox API key — Separate from your production key; no rotation required during testing

​
Test scenarios

Use the scenarios below for edge-case testing. Conditions you cannot trigger yourself — such as a halted or restricted corridor — can be arranged with the Ratio team.
Default state. All corridors active, oracle feeds fresh, pools healthy. Use this for happy-path testing — verifying the full quote → execute → settle → confirm flow for each corridor you intend to support.
Test how your integration handles protective states and trading halts (arranged with the Ratio team). Verify that your UI degrades gracefully when corridors are paused or the system enters a protective state.
Quoting returns HTTP 503 when prices are stale or sources diverge. Verify that your error handling correctly processes HTTP 503 responses from the quote endpoints, checks corridor state via GET /v1/corridors, and presents appropriate messaging to downstream users.
Request a firm quote and wait for it to expire before submitting the transaction on-chain. Verify that your flow handles the rejected (reverted) transaction and re-requests a fresh firm quote without requiring manual intervention.
Submit transactions that exceed configured daily volume limits. Verify that rejections are handled gracefully and that your system does not retry automatically in a way that could cause duplicate submissions.

​
Certification test cases

You must pass all mandatory test cases before production activation. The full set of categories is listed below.

​
SLA targets

During sandbox testing, demonstrate the following SLA targets before certification is granted.

​
Certification and next steps

Once all mandatory test cases pass and SLA targets are demonstrated, Ratio certifies your integration for production. Certification typically takes 1–3 weeks depending on partner type and integration complexity. Gate criteria: All mandatory test cases passed; SLA targets demonstrated. After certification, Ratio issues your production API key and begins the controlled ramp-up described in Going Live.