Oridatum · API финансовых данных Казахстана

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

Аутентификация — 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"

Текстовая версия страницы для чтения без JavaScript. Полная версия открывается в браузере с включённым JavaScript.

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