Fiyat barları (OHLCV)
GET /v1/bars/{symbol}: tarihsel OHLCV barları, 1 dakikadan aylığa.
Yetki: market:read
GET /v1/bars/{symbol}
Bir hissenin kapanmış OHLCV barları. Bar zamanı (t) barın başlangıcı, UTC epoch saniyedir. Açık (devam eden) bar yanıta dahil edilmez.
Parametreler
| Parametre | Tip | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
symbol | string | evet | Yol parametresi, örn. THYAO | |
interval | string | evet | 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1mo | |
from | string | hayır | Başlangıç (dahil). UTC epoch saniye (1759708800) ya da ISO 8601 (2026-10-06T00:00:00Z) | |
to | string | hayır | Bitiş. Aynı biçimler; from değerinden büyük olmalı | |
limit | integer | hayır | 500 | En fazla bar sayısı, 1 ile 5000 arası |
from ve to verilmezse en son limit adet bar döner. Gün içi periyotlarda (1 dk-4 saat) geçmiş derinliği plana bağlıdır: from verilmezse planın penceresinin başından başlar, daha eskisi 403 PLAN_LIMIT_EXCEEDED döner (Limitler). Aralık limit değerinden fazla bar içeriyorsa en yeni barlar döner; eskiye doğru gitmek için to değerini en eski barın t değerine çekip tekrar isteyin.
Örnek
curl "https://api.istfin.com/v1/bars/THYAO?interval=1d&from=1759276800&limit=3" \ -H "Authorization: Bearer $ISTFIN_API_KEY"Yanıt
{
"data": [
{ "t": 1759276800, "o": 305.0, "h": 309.75, "l": 303.5, "c": 308.25, "v": 51240870 },
{ "t": 1759363200, "o": 308.5, "h": 311.0, "l": 306.0, "c": 309.0, "v": 44890210 },
{ "t": 1759449600, "o": 309.0, "h": 314.75, "l": 307.5, "c": 312.5, "v": 48213560 }
],
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}| Alan | Tip | Açıklama |
|---|---|---|
t | integer | Bar başlangıcı, UTC epoch saniye |
o | number | Açılış |
h | number | En yüksek |
l | number | En düşük |
c | number | Kapanış |
v | number | null | Hacim (lot); son 15 dakikaya düşen barlarda null |
Zaman dilimi notu
Borsa İstanbul seansı İstanbul saatiyle (UTC+3) 10:00 ile 18:00 arasındadır. Günlük (1d) barın t değeri o günün UTC gece yarısına, dakikalık barlar ise gerçek UTC başlangıcına denk gelir; yerel saate çevirmek istemci tarafındadır.
const date = new Date(bar.t * 1000)
date.toLocaleString('tr-TR', { timeZone: 'Europe/Istanbul' })