Documentation

IOJ API

A read-only JSON API for fiat and crypto reference rates. No authentication is required for the public tier.

Endpoints

MethodPathDescription
GET/api/v1/rates.jsonAll fiat and crypto rates, base USD.
GET/api/v1/health.jsonService status and last update time.

Example

curl -s https://ioj.su/api/v1/rates.json
{
  "base": "USD",
  "updated": "2026-11-17T10:31:02Z",
  "fiat":  { "EUR": 0.9214, "RUB": 80.35, "GBP": 0.7891, "CNY": 7.241, "KZT": 489.2, "TRY": 34.21, "UAH": 41.33, "JPY": 154.6 },
  "crypto": {
    "BTC": { "usd": 95120.4, "eur": 87654.1, "rub": 7645120.0, "chg24h": 1.24 },
    "ETH": { "usd": 3210.8, "eur": 2958.7, "rub": 258020.0, "chg24h": -0.42 }
  },
  "meta": { "source": "currency-api + coingecko", "refresh_seconds": 60 }
}

Schema

FieldTypeNotes
basestringAlways USD at the moment.
updatedstringUTC timestamp, ISO 8601.
fiatobjectUnits of currency per 1 USD.
crypto.*.usdnumberPrice of one coin in USD.
crypto.*.eur / .rubnumberDerived from the fiat table.
crypto.*.chg24hnumber | nullPercent change over 24 hours.

Rate limits

The public tier allows up to 60 requests per minute per IP. Rates refresh once per minute, so polling more often will not return fresher data. For higher limits, write to hello@ioj.su.

Errors

StatusMeaning
404Unknown path.
405Method not allowed. Only GET and HEAD are supported.
429Rate limit exceeded.
503Upstream data source unavailable; retry with backoff.

Data sources

Fiat rates are taken from a daily European Central Bank mirror and refreshed every minute. Crypto prices come from a public market data provider. Values are indicative and not suitable for trading or settlement.

Changelog