Developer Documentation

Market Data (FX)

Access real-time foreign exchange rates powered by the FX-Solara AI engine.

Get FX Rate

GET /v1/market/rates

Retrieve the latest exchange rate for a given currency pair. The rate is used automatically for cross-currency transfers.

Query Parameters

base (string, required): The currency to convert from (e.g., `USD`).
quote (string, required): The currency to convert to (e.g., `KES`).

Request Body

{
  "base": "USD",
  "quote": "KES"
}

Body Parameters

Test Request

Header: Authorization

base

quote

Example Request

GET /v1/market/rates?base=USD"e=KES

Response

{
  "status": "success",
  "data": {
    "base": "USD",
    "quote": "KES",
    "rate": "129.50000000",
    "spread_bps": 50,
    "quote_id": "ai_gen_64f8a1b2c3d4e"
  }
}