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

> Oridatum API v1: аутентификация, нарықтар, компаниялар, қаржылық есептілік, есеп редакциялары, беттеу, as_of уақыт кезеңі бойынша сұраулар, қателер және сұрау лимиттері.

Source: https://oridatum.com/kk/docs

---

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

---

[API құжаттамасы](/kk/docs) · [Тарифтер](/kk/pricing) · [Деректер](/kk/data) · [Қызмет көрсету шарттары](/kk/terms) · [Құпиялылық саясаты](/kk/privacy) · [Ақшаны қайтару саясаты](/kk/refunds) · [Импрессум](/kk/impressum) · [Байланыс](/kk/contact)

Қызметті ұсынушы Oleh Ostapenko, sole proprietor, operating under the brand Oridatum, Sterngasse 3/2/6, 1010 Vienna, Austria. Қолдау: support@oridatum.com