> ## 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.

# FAQ

> Frequently asked questions about Ratio

## General

<AccordionGroup>
  <Accordion title="What is Ratio?">
    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.
  </Accordion>

  <Accordion title="Who is Ratio for?">
    Ratio is B2B infrastructure. It serves banks, payment service providers (PSPs), stablecoin issuers, exchanges, liquidity providers, and remittance operators — not retail end users directly.
  </Accordion>

  <Accordion title="What blockchain does Ratio use?">
    Ratio is built on the [Kaia blockchain](https://kaia.io), a high-performance Layer 1 with BFT consensus, sub-second finality, and full EVM compatibility.
  </Accordion>

  <Accordion title="What corridors are supported?">
    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](/corridors).
  </Accordion>

  <Accordion title="How do I get started?">
    Ratio is available to institutional partners through a structured onboarding process. Contact the team at [partnerships@ratiofx.com](mailto:partnerships@ratiofx.com) to begin. After KYB verification, you receive sandbox credentials and can start integrating. See [Onboarding Process](/partners/onboarding-process).
  </Accordion>
</AccordionGroup>

## Pricing and fees

<AccordionGroup>
  <Accordion title="How does Ratio price FX swaps?">
    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](/features/oracle-pricing).
  </Accordion>

  <Accordion title="Is there slippage?">
    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.
  </Accordion>

  <Accordion title="How does pricing work?">
    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](/features/fee-and-revenue).
  </Accordion>

  <Accordion title="Are there hidden fees?">
    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.
  </Accordion>

  <Accordion title="What is a firm quote vs an indicative quote?">
    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.
  </Accordion>

  <Accordion title="What happens if a firm quote expires?">
    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.
  </Accordion>

  <Accordion title="How fast is settlement?">
    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.
  </Accordion>
</AccordionGroup>

## Integration

<AccordionGroup>
  <Accordion title="Do I need to interact with the blockchain?">
    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.
  </Accordion>

  <Accordion title="How long does integration take?">
    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](/partners/onboarding-process).
  </Accordion>

  <Accordion title="Is there a sandbox environment?">
    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](/partners/sandbox-testing).
  </Accordion>

  <Accordion title="What are the rate limits?">
    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](/api-reference/rate-limits-errors).
  </Accordion>

  <Accordion title="What happens if the system goes into a HALT state?">
    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](/features/risk-management).
  </Accordion>
</AccordionGroup>

## Liquidity providers

<AccordionGroup>
  <Accordion title="How do I become a liquidity provider?">
    Contact the Ratio team to begin the LP onboarding process. The minimum deposit is \$50,000 equivalent. See [LP Participation](/partners/lp-participation).
  </Accordion>

  <Accordion title="What returns can LPs expect?">
    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.
  </Accordion>

  <Accordion title="Is there impermanent loss?">
    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.
  </Accordion>

  <Accordion title="Can I withdraw at any time?">
    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](/partners/lp-participation).
  </Accordion>
</AccordionGroup>

## Security

<AccordionGroup>
  <Accordion title="Is Ratio audited?">
    Ratio's smart contracts are deployed on the Kaia blockchain and undergo security review. Contact the team for the latest audit reports.
  </Accordion>

  <Accordion title="Where is my data stored?">
    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.
  </Accordion>

  <Accordion title="How are API keys managed?">
    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.
  </Accordion>
</AccordionGroup>