GET /rate/live

GET /api/v1/remittance/rate/live?currency={code}

Live FX rate for the requested currency. Triggers a real-time fetch from the FX provider. Not cached — use sparingly.

Auth: Basic merchant_code:merchant_secret

Query params

Param	Required	Description
currency	yes	ISO-4217 code, e.g. UGX, KES, ZAR.

Response (200 OK)

{
  "status": "success",
  "data": {
    "base":     "USD",
    "currency": "UGX",
    "rate":     3702.5,
    "as_of":    "2026-08-14T14:00:00.000000",
    "source":   "live"
  }
}

When to use /rate/live vs /rate

Use /rate by default — it's cached and free, and matches what Moko applies internally at settlement.

Use /rate/live when you display a quote to an end-user right before they confirm a transaction, so they see a rate that will match the actual conversion within seconds.

Do not call /rate/live on every /balance refresh or on every page load — it's a real-time fetch and hits provider quota.