Documentation
IOJ API
A read-only JSON API for fiat and crypto reference rates. No authentication is required for the public tier.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/rates.json | All fiat and crypto rates, base USD. |
GET | /api/v1/health.json | Service 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
| Field | Type | Notes |
|---|---|---|
base | string | Always USD at the moment. |
updated | string | UTC timestamp, ISO 8601. |
fiat | object | Units of currency per 1 USD. |
crypto.*.usd | number | Price of one coin in USD. |
crypto.*.eur / .rub | number | Derived from the fiat table. |
crypto.*.chg24h | number | null | Percent 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.
Errors
| Status | Meaning |
|---|---|
404 | Unknown path. |
405 | Method not allowed. Only GET and HEAD are supported. |
429 | Rate limit exceeded. |
503 | Upstream 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
- 2026-11-17 — public beta, v1 schema.
- 2026-10-02 — added 24h change for crypto pairs.