# Документация API Oridatum

> Oridatum API v1: аутентификация, рынки, компании, финансовая отчётность, редакции отчётов, пагинация, запросы as_of на момент времени, ошибки и лимиты запросов.

Source: https://oridatum.com/docs

---

Аутентификация — bearer-ключ API в заголовке Authorization. Каждый ответ содержит `meta.snapshot_id`, идентифицирующий неизменяемый снимок, на основе которого сформирован ответ.

## Эндпоинты

- `GET /v1/markets` — рынки, доступные по ключу API.
- `GET /v1/companies/{country}` — компании в активном снимке, с курсорной пагинацией.
- `GET /v1/companies/{country}/{ticker}` — запись об одной компании.
- `GET /v1/companies/{country}/{ticker}/financials` — стандартизированные показатели. Фильтры: period, statement, period_basis, metric, as_of, limit, cursor.
- `GET /v1/companies/{country}/{ticker}/revisions` — неизменяемые редакции отчётов и история замещения.

## Ошибки

- 400 — invalid_cursor, invalid_as_of.
- 401 — заголовок Authorization отсутствует, некорректен или ключ отозван.
- 403 — ключ не имеет прав на запрошенный рынок или тикер.
- 404 — market_not_found, company_not_found, route_not_found.
- 429 — rate_limit_exceeded. Соблюдайте заголовок Retry-After.
- 503 — нет действующего активного снимка; API возвращает отказ вместо неполных данных.

## Расчётные коэффициенты

Запрос `statement=ratios` возвращает рентабельность, доходность, долговую нагрузку, ликвидность, оборачиваемость и рост. Каждый коэффициент несёт `formula`, по которой он рассчитан, `inputs`, из которых он построен — каждый вход называет строку отчёта по `fact_id`, — и `calculation_version`, поэтому значение можно пересчитать и проследить до страницы источника. Коэффициент не публикуется, если его пришлось бы угадывать: нет ROE при отрицательном капитале, нет роста от отрицательной базы и нет коэффициента вовсе, если входного значения не хватает или входы несопоставимы.

Промежуточная отчётность в Казахстане нарастающая, поэтому двенадцатимесячные показатели точные, а не оценочные: последний полный год минус тот же период год назад плюс текущий период. Они отмечены `period_basis="TTM"` и выбираются фильтром `period_basis`. Полугодие никогда не аннуализируется умножением.

## Пример

```
curl "$ORIDATUM_API_BASE/v1/companies/KZ/KEGC/financials?period=FY2025" \
  -H "Authorization: Bearer $ORIDATUM_API_KEY"
```

---

[Документация API](/docs) · [Тарифы](/pricing) · [Данные](/data) · [Условия обслуживания](/terms) · [Политика конфиденциальности](/privacy) · [Политика возврата средств](/refunds) · [Импрессум](/impressum) · [Контакты](/contact)

Услугу предоставляет Oleh Ostapenko, sole proprietor, operating under the brand Oridatum, Sterngasse 3/2/6, 1010 Vienna, Austria. Поддержка: support@oridatum.com