Tarihsel Getiri Karşılaştırma

(GELİŞTİRME AŞAMASINDA)

Enstrüman Getiri Hesaplama

Description

Belirtilen enstrümanlar için istenilen tarih aralığında kümülatif getiri hesaplar. Her enstrüman bağımsız olarak hesaplanır.

Datası olan tüm enstrümanlar desteklenir.

Desteklenen periyotlar: Günlük, Haftalık, Aylık

Opsiyonel olarak başlangıç tutarı (amount) verilirse, her nokta için kümülatif tutar da hesaplanır.

Opsiyonel olarak divide=USDTRY verilirse, tüm fiyatlar USDTRY kuruna bölünerek hesaplanır.

Hafta sonları ve tatil günleri response'a dahil edilmez.

Endpoint

HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/historic-wealth

Query Parameters

Parameter	Type	Required	Default	Description
symbols	string	true	-	Virgülle ayrılmış sembol listesi (maksimum 10) . Özel tanımlanan sembollerle kullanılabilir.
start	string	true	-	Başlangıç tarihi (YYYY-MM-DD, maksimum 3 yıl geriye)
end	string	true	-	Bitiş tarihi (YYYY-MM-DD)
period	string	false	daily	Periyot: daily, weekly, monthly
divide	string	false	-	Bölme için kullanılacak sembol (şimdilik sadece USDTRY desteklenir)
amount	number	false	-	Başlangıç tutarı (verilirse her nokta için tutar hesaplanır)

Response Fields

Response direkt array olarak döner. Her eleman bir tarih noktasını temsil eder.

Field	Type	Description
d	string	Tarih
values	array	O tarihteki enstrüman değerleri
values[].s	string	Sembol
values[].r	number	Kümülatif getiri (%)
values[].a	number	Tutar (amount verilmişse)

Kısaltmalar:

• d = date (tarih)
• s = symbol (sembol)
• r = return (kümülatif getiri %)
• a = amount (tutar)

---

Sample Request-Response (Temel Kullanım)

GET https://api.matriksdata.com/dumrul/v1/historic-wealth?symbols=THYAO,GARAN,XU100&start=2025-01-01&end=2025-01-10&period=daily

Response:

[
  {
    "d": "2025-01-02",
    "values": [
      { "s": "THYAO", "r": 0 },
      { "s": "GARAN", "r": 0 },
      { "s": "XU100", "r": 0 }
    ]
  },
  {
    "d": "2025-01-03",
    "values": [
      { "s": "THYAO", "r": 1.50 },
      { "s": "GARAN", "r": 0.80 },
      { "s": "XU100", "r": 0.90 }
    ]
  },
  {
    "d": "2025-01-06",
    "values": [
      { "s": "THYAO", "r": 2.80 },
      { "s": "GARAN", "r": -0.50 },
      { "s": "XU100", "r": 1.20 }
    ]
  },
  {
    "d": "2025-01-07",
    "values": [
      { "s": "THYAO", "r": 3.10 },
      { "s": "GARAN", "r": -1.10 },
      { "s": "XU100", "r": 1.50 }
    ]
  },
  {
    "d": "2025-01-08",
    "values": [
      { "s": "THYAO", "r": 2.95 },
      { "s": "GARAN", "r": -0.90 },
      { "s": "XU100", "r": 1.80 }
    ]
  },
  {
    "d": "2025-01-09",
    "values": [
      { "s": "THYAO", "r": 3.80 },
      { "s": "GARAN", "r": -1.50 },
      { "s": "XU100", "r": 2.00 }
    ]
  },
  {
    "d": "2025-01-10",
    "values": [
      { "s": "THYAO", "r": 4.25 },
      { "s": "GARAN", "r": -1.20 },
      { "s": "XU100", "r": 2.10 }
    ]
  }
]

---

Sample Request-Response (Amount ile USD Bazlı)

GET https://apitest.matriksdata.com/dumrul/v1/historic-wealth?symbols=THYAO,TTE&start=2025-01-01&end=2025-03-01&period=monthly&divide=USDTRY&amount=50000

Response:

[
  {
    "d": "2025-01-02",
    "values": [
      { "s": "THYAO", "r": 0, "a": 50000.00 },
      { "s": "TTE", "r": 0, "a": 50000.00 }
    ]
  },
  {
    "d": "2025-02-03",
    "values": [
      { "s": "THYAO", "r": 5.20, "a": 52600.00 },
      { "s": "TTE", "r": 1.80, "a": 50900.00 }
    ]
  },
  {
    "d": "2025-03-03",
    "values": [
      { "s": "THYAO", "r": 8.50, "a": 54250.00 },
      { "s": "TTE", "r": 3.25, "a": 51625.00 }
    ]
  }
]

---

Sample Request-Response (Aylık Periyot - Bitiş Tarihi Ek Nokta)

Bugün 3 Nisan 2025 olduğunda, aylık periyotta bitiş tarihi için ek nokta döner:

GET https://apitest.matriksdata.com/dumrul/v1/historic-wealth?symbols=GARAN&start=2025-01-01&end=2025-04-03&period=monthly

Response:

[
  { "d": "2025-01-02", "values": [{ "s": "GARAN", "r": 0 }] },
  { "d": "2025-02-03", "values": [{ "s": "GARAN", "r": 2.10 }] },
  { "d": "2025-03-03", "values": [{ "s": "GARAN", "r": 3.50 }] },
  { "d": "2025-04-01", "values": [{ "s": "GARAN", "r": 5.20 }] },
  { "d": "2025-04-03", "values": [{ "s": "GARAN", "r": 6.80 }] }
]

---

Validation Errors

Error Code	Description
REQUIRED_ERROR	Zorunlu alan eksik (symbols, start, end)
INVALID_DATE_FORMAT	Tarih formatı hatalı (YYYY-MM-DD olmalı)
INVALID_DATE_RANGE	end, start'tan küçük veya eşit / start 3 yıldan eski
MAX_SYMBOL_COUNT_EXCEEDED	10'dan fazla sembol
INVALID_SYMBOL	Geçersiz veya tanımsız sembol kodu
INVALID_PERIOD	Geçersiz periyot (daily, weekly, monthly olmalı)
INVALID_DIVIDE	Geçersiz divide parametresi (sadece USDTRY desteklenir)
INVALID_AMOUNT	Amount 0 veya negatif
NO_DATA_AVAILABLE	Belirtilen tarih aralığında hiçbir sembol için data yok

---