Finmind HTTP API

Kirishsiz

Ochiq endpointlar

Ular har qanday soʻrovchiga javob beradi. Serverda oʻn daqiqa keshlanadi va ochiq Cache-Control sarlavhasi bilan yuboriladi, shuning uchun mijoz ham ularni keshlashi mumkin. Manbani oʻqish muvaffaqiyatsiz boʻlsa, eskirgan yoki boʻsh javob oʻrniga Retry-After sarlavhasi bilan 503 qaytaradi.

Pul va narxlar aniq oʻnlik sonlarni saqlaydigan JSON satrlari, hech qachon float emas. trade_date saqlangan yopilish narxi tegishli boʻlgan birja savdo kuni; oʻzgarish oldingi saqlangan savdo kuniga nisbatan oʻlchanadi, kam savdo qilinadigan aksiya uchun u bir necha hafta oldin boʻlishi mumkin. Korporativ axborotda published_at UTC da, published_date esa Toshkent taqvimida beriladi.

Sinab koʻring

Bugun ishlaydigan uchta soʻrov

Har bir misol 2026-09-26 kuni ishlab chiqarish muhitida bajarilgan; koʻrsatilgan natija nomlangan maydonlar bilan qisqartirilgan.

curl -s https://finmind.uz/api/v1/public/market/instruments/

{"as_of": "2026-09-25",
 "stocks": [{"ticker": "AGBA", "isin": "UZ7001560000", "name": "Agrobank ATB",
             "share_class": "common", "sector": "Financials",
             "last": "589", "change_pct": "-0.17", "trade_date": "2026-09-25"}, ...],
 "bonds":  [{"isin": "UZ6057687AE6", "ticker": "BFMT2B5",
             "coupon_rate_pct": "27", "maturity_date": "2028-01-20",
             "currency": "UZS", "last": "123998", "trade_date": "2026-09-25"}, ...]}

curl -s https://finmind.uz/api/v1/public/market/stocks/AGBA/

{"kind": "stock", "ticker": "AGBA", "isin": "UZ7001560000", "name": "Agrobank ATB",
 "currency": "UZS", "exchange": "UZSE",
 "issuer": {"sector": "Financials", "sub_industry": "Diversified Banks", ...},
 "quote": {"last": "589", "prev_close": "590", "change": "-1", "change_pct": "-0.17",
           "open": "609", "high": "609", "low": "589", "volume": "28615",
           "trade_date": "2026-09-25", "prev_trade_date": "2026-09-24"},
 "history": [..., {"date": "2026-09-25", "close": "589"}],
 "fundamentals": {...}, "disclosures": [...], "other_share_classes": [...]}

curl -s https://finmind.uz/api/v1/public/market/bonds/UZ6057687AE6/

{"kind": "bond", "isin": "UZ6057687AE6", "ticker": "BFMT2B5",
 "issuer": "BIZNES FINANS MIKROMOLIYA TASHKILOTI MChJ",
 "face_value": "100000", "coupon_rate_pct": "27", "coupon_frequency_per_year": 12,
 "issue_date": "2026-01-28", "maturity_date": "2028-01-20", "matured": false,
 "quote": {"last": "123998", "prev_close": "120000", "change_pct": "3.33",
           "trade_date": "2026-09-25", "prev_trade_date": "2026-09-24"},
 "history": [...], "disclosures": [...]}

Tizimga kirgan holda

Autentifikatsiya va huquqlar

Boshqa har bir endpoint Finmind hisobining elektron pochtasi va paroli bilan olingan JSON Web Token talab qiladi. Token shaxsning oʻz huquqlarini oʻzida saqlaydi: pullik funksiya ortidagi endpoint tokensiz 401, hisobda oʻsha funksiya boʻlmasa feature_locked kodi bilan 403 qaytaradi. Katalogning bepul qismlari (portfel, buyurtmalar kitobi, oʻrganish) faqat tokenni talab qiladi.

curl -s -X POST https://finmind.uz/api/v1/auth/token/ \
  -H 'Content-Type: application/json' \
  -d '{"email": "[email protected]", "password": "..."}'
# {"refresh": "...", "access": "..."}

curl -s https://finmind.uz/api/v1/portfolio/ \
  -H 'Authorization: Bearer <access>'

Kirish tokeni

30 daqiqa amal qiladi. Authorization: Bearer sarlavhasi sifatida yuboriladi.

Yangilash tokeni

7 kun amal qiladi. Uni /api/v1/auth/token/refresh/ manziliga POST qiling; har bir yangilash yangi juftlik qaytaradi va eskisini bekor qiladi.

Ikki bosqichli hisoblar

Birinchi soʻrov token oʻrniga twofa_required va challenge bilan javob beradi; ikkinchi qadam sxemada hujjatlashtirilgan.

Chiqish

Yangilash tokenini bekor qilish uchun uni /api/v1/auth/logout/ manziliga POST qiling.

Cheklovlar

Soʻrovlar cheklovi, sahifalash va versiyalash

Umumiy soʻrovlar cheklovi yoʻq; quyidagi endpointlar oʻz cheklovini mijoz manzili boʻyicha hisoblaydi. Cheklangan soʻrov Retry-After sarlavhasi bilan 429 qaytaradi.

Roʻyxatlar page va page_size bilan sahifalanadi (standart 50, koʻpi bilan 500). Bitta versiya prefiksi, /api/v1, xizmat koʻrsatadi; moslikni buzadigan oʻzgarish yangi prefiks ostida keladi.

Ochiq aytilgan

Hali taklif qilinmaydigan narsalar

• API kalitlari yoʻq. Token shaxsning oʻz Finmind kirishi boʻlib, faqat uning oʻz maʼlumotlari va huquqlari uchun amal qiladi; alohida dasturchi hisob maʼlumotlari hali yoʻq.
• Boshqa saytlardan brauzer soʻrovlari yoʻq. CORS faqat finmind.uz ga ruxsat beradi, shuning uchun boshqa domendagi sahifa tashrif buyuruvchi brauzeridan API ga murojaat qila olmaydi; server, skript yoki notebook qila oladi.
• Jonli kotirovkalar yoʻq. Narxlar birjaning saqlangan kunlik yopilish narxlari; har biri tegishli savdo kunini oʻzida saqlaydi, manba eʼlon qilmagan koʻrsatkich esa null boʻladi, hech qachon nol emas.
• Eʼlon qilingan eskirtirish siyosati hali yoʻq. Bitta versiya prefiksi bor va sxema oʻz versiyasini koʻrsatadi; yozmagan siyosatimizni vaʼda qilgandan koʻra shuni aytganimiz maʼqul.

Foydalanish shartlari

Maʼlumotlardan foydalanish

API foydalanish shartlari bilan qamrab olingan. Shaxsiy foydalanish, tadqiqot va oʻz investitsiyalaringiz uchun vosita yaratish mumkin. Maʼlumotlarni ommaviy yuklab olish, qayta sotish yoki tarqatish uchun avval bizning yozma ruxsatimiz kerak: [email protected] manziliga yozing va nima yaratayotganingizni ayting. Raqamlarni eʼlon qilganda manbalarni koʻrsating: narxlar birjaniki (uzse.uz), kompaniya maʼlumotlari va korporativ axborot esa openinfo.uz niki, ikkalasini ham Finmind oʻqiydi.

Mashina oʻqiy oladigan qoʻshnilar: /feeds/disclosures.xml manzilidagi korporativ axborot lentasi, sayt xaritasi va til modellari uchun /llms.txt.