Full API Reference

Ratio FX exposes REST API endpoints across two primary subsystems. All endpoints require Bearer token authentication.

FX Engine Endpoints

The FX Engine API handles quote requests, firm quote execution, and system state queries.

Endpoint	Method	Description
/v1/quote	GET	Request an indicative or firm quote for a corridor
/v1/firm-quote	POST	Lock a firm executable quote with inventory reservation
/v1/execute	POST	Execute a previously locked firm quote
/v1/system/state	GET	Query current State Engine status per corridor

Full request/response documentation: FX Engine API Reference

Reserve Pool Risk Endpoints

The Reserve Pool API exposes risk monitoring data, emergency controls, and batch lifecycle information.

Endpoint	Method	Description
/v1/reserve/risk-status	GET	Current VaR status snapshot for all corridors
/v1/reserve/batches	GET	Open rebalancing batches with WAOP and PnL
/v1/reserve/emergency-rfq	POST	Manual emergency RFQ trigger (ops-level auth)
/v1/reserve/state-override	POST	Manual state override for corridor (ops-level auth)

Full request/response documentation: Risk API Reference

Error Handling

All error codes across both subsystems are documented in the Unified Error Code Reference.

Authentication

All endpoints require a Bearer token in the Authorization header:

Authorization: Bearer {your_api_token}

Standard endpoints use partner-level tokens. Reserve Pool emergency and override endpoints require ops-level tokens.