Oridatum · Қазақстанның қаржылық деректер API

Oridatum API құжаттамасы

Аутентификация — Authorization тақырыбындағы bearer API кілті. Әр жауапта жауап негізделген өзгермейтін снимокты анықтайтын `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.