MonetaryAI / Docs
API ReferenceCurrency rates

Get UZS, USD, EUR and RUB rates

source defaults to CBU. CBU rate is UZS per one currency unit. KAPITALBANK returns separate buyRate (bank buys) and sellRate (bank sells), with rate null to avoid silently choosing a side. UZS always equals 1. updatedAt is the last successful fetch, effectiveDate/sourceUpdatedAt are publisher dates (bank timezone Asia/Tashkent). Status UNAVAILABLE means no successful snapshot; STALE retains last good values after a failed refresh or when a refresh is overdue. Read calls do not contact upstream sources.

GET
/api/v1/currency-rates

Authorization

bearerAuth
headerAuthorizationBearer <token>

Obtained from POST /api/v1/auth/login, on the tenant's own subdomain. Presenting it on another tenant's subdomain is a 403.

Query Parameters

source?string
Value in"CBU""KAPITALBANK"

Response Body

Exactly four currencies and source freshness

*/*
  1. response
baseCurrency?string
items?array<>
lastAttemptAt?string
Formatdate-time
refreshIntervalSeconds?integer
Formatint64
source?string
stale?boolean
status?string
Value in"FRESH""STALE""UNAVAILABLE"
updatedAt?string
Formatdate-time
curl -X GET 'https://api.monetaryai.uz/api/v1/currency-rates'
{  "baseCurrency": "string",  "items": [    {      "base": true,      "buyRate": 0,      "code": "string",      "effectiveDate": "2019-08-24",      "name": "string",      "rate": 0,      "sellRate": 0,      "sourceUpdatedAt": "2019-08-24T14:15:22Z",      "symbol": "string",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "lastAttemptAt": "2019-08-24T14:15:22Z",  "refreshIntervalSeconds": 0,  "source": "string",  "stale": true,  "status": "FRESH",  "updatedAt": "2019-08-24T14:15:22Z"}