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. For higher limits, write to hello@ioj.su.
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.