Kapanmış tarihsel barlar
Tek PAY veya VİOP sembolünün kapanmış OHLC barlarını getirir. Gün içi periyotlarda tradingDate, UTC aralığı veya countBack; günlük, haftalık ve aylık periyotlarda tarih aralığı, UTC aralığı veya countBack kullanılır. Açık mumlar bu yanıtın parçası değildir.
15m isteği neden 400 döner?
15m gün içi bir periyottur. interval=15m ile fromDate/toDate kullanılamaz; tradingDate, fromUtc/toUtc veya countBack seçeneklerinden birini kullanın. fromDate/toDate yalnız 1D, 1W ve 1M periyotları içindir.
Periyot ve tarih seçimi
1m, 3m, 5m, 15m, 30m, 60m ve 240m için: tek gün gerekiyorsa tradingDate, kesin saat aralığı gerekiyorsa fromUtc/toUtc, son N mum gerekiyorsa countBack kullanın. 1D, 1W ve 1M için tarih aralığında fromDate/toDate kullanabilirsiniz.
Sayfalama ve eksik geçmiş
Sayfa içindeki sıralama eskiden yeniye doğrudur. hasMore=true ise nextCursor, aynı sorguya cursor olarak eklenir. isPartial=true eksik geçmişi belirtir; doğrulanmış boş sonuç anlamına gelmez. noData ayrı değerlendirilmelidir.
Sadeleştirilmiş bar yanıtı
Müşteri yanıtında tickCount, barId, interval, revision, isFinal ve calendarVersion alanları yer almaz. Sorgu periyodu request içindeki interval parametresiyle belirlenmeye devam eder.
Kapanmış ve açık mum
Yanıt yalnız kesinleşmiş/kapanmış barları içerir. Oluşmakta olan mum için live-bar, son fiyat olayları için recent-ticks kullanılır. VİOP tradingDate değeri sözleşmenin işlem günüdür.
Mevcut tarihsel veri kotaları korundu
Yeni saniyelik limit eklenmedi. API key başına mevcut 120 ağırlık birimi/dakika ve kullanıcı başına 5.000 istek/saat kotaları sürer. İstek ağırlığı 1 + ceil(tahmini bar sayısı / 500) olarak hesaplanır. X-RateLimit-Limit, Remaining, Reset ve Request-Weight başlıklarını izleyin; 429 sonrasında Retry-After süresini bekleyin.
Hata durumları
Geçersiz parametre veya cursor 400, kota aşımı 429; geçici veri erişim veya zaman aşımı hataları 502/503/504 döndürebilir. 503 düzeltmesi yalnız son fiyat endpoint’lerindeki eksik/eski fiyat ve sembol listesi erişim davranışını kapsar.
Sorgu parametreleri
Kapanmış tarihsel barlar — Sorgu parametreleri
| Alan |
Tip |
Açıklama |
symbol
zorunlu
|
string |
Tek PAY veya VİOP sembolü; virgülle çoklu sembol kabul edilmez. Örnek: ASELS veya F_ASELS0926. |
interval
zorunlu
|
string |
Gün içi: 1m, 3m, 5m, 15m, 30m, 60m, 240m. Takvim periyotları: 1D, 1W, 1M. 1m dakika, 1M ay periyodudur. |
countBack
|
integer |
Tüm periyotlarda en güncel kapanmış barları almak için kullanılır. Örnek: interval=15m&countBack=100. limit ile birlikte verilirse değerleri aynı olmalıdır. |
tradingDate
|
date |
Yalnız gün içi periyotlar için tek işlem günü (YYYY-MM-DD). Örnek: interval=15m&tradingDate=2026-09-04. fromDate/toDate veya fromUtc/toUtc ile birlikte kullanılamaz; 1D/1W/1M ile kullanılırsa 400 döner. |
fromDate
|
date |
Yalnız 1D/1W/1M için dahil başlangıç tarihi. 1m-240m gün içi periyotlarla kullanılırsa 400 döner. tradingDate veya UTC aralığıyla birlikte gönderilemez. |
toDate
|
date |
Yalnız 1D/1W/1M için hariç bitiş tarihi. Başlangıçtan sonra olmalıdır; 1m-240m gün içi periyotlarla kullanılırsa 400 döner. |
fromUtc
|
datetime |
Tüm periyotlarda kullanılabilen alternatif dahil başlangıç zamanı. 15 dakikalık belirli bir saat aralığı için interval=15m ile fromUtc/toUtc gönderin. Tarih seçicileriyle birlikte kullanılamaz. |
toUtc
|
datetime |
Alternatif hariç bitiş zamanı. Başlangıçtan sonra olmalıdır; fromUtc ile birlikte kullanılması önerilir. |
limit
|
integer |
Sayfa büyüklüğü: en fazla 1.000 bar; 1M için en fazla 300 bar. countBack ile birlikte gönderilirse aynı değerde olmalıdır. |
cursor
|
string |
Önceki yanıttaki nextCursor. Aynı sembol, periyot ve aralık korunarak sonraki (daha eski) sayfa istenir. |
İstekcURL
# En güncel 100 adet kapanmış 15 dakikalık mum
curl -X GET "https://api.tradewize.com.tr/api/v1/market-data/bars?symbol=ASELS&interval=15m&countBack=100" \
-H "Authorization: Bearer <access_token>"
# Belirli bir işlem gününün 15 dakikalık mumları
curl -X GET "https://api.tradewize.com.tr/api/v1/market-data/bars?symbol=ASELS&interval=15m&tradingDate=2026-09-04&limit=1000" \
-H "Authorization: Bearer <access_token>"
# Belirli bir UTC zaman aralığının 15 dakikalık mumları
curl -X GET "https://api.tradewize.com.tr/api/v1/market-data/bars?symbol=ASELS&interval=15m&fromUtc=2026-09-04T07:00:00Z&toUtc=2026-09-04T15:10:00Z" \
-H "Authorization: Bearer <access_token>"
# Günlük mumlarda tarih aralığı: başlangıç dahil, bitiş hariç
curl -X GET "https://api.tradewize.com.tr/api/v1/market-data/bars?symbol=ASELS&interval=1D&fromDate=2026-08-01&toDate=2026-09-01" \
-H "Authorization: Bearer <access_token>"
200 OK · kısaltılmış yanıt (tek bar gösteriliyor)JSON
{
"symbol": "ASELS",
"bars": [
{
"timeUtc": "2026-09-04T07:00:00Z",
"closeTimeUtc": "2026-09-04T07:05:00Z",
"open": 380,
"high": 381,
"low": 379.75,
"close": 380.25
}
],
"noData": false,
"hasMore": false,
"nextCursor": null,
"isPartial": false
}