Flow Analizleri

İşlem Hacimlerinde Sapma (DTV)

Description

Kullanıcı tarafından seçilen sembollerin, yine kullanıcı tarafından seçilen endeks'e oranla sapma hesapmalalarını içermektedir. Hesaplamalar önceki gün itibariyle çalışmaktadır. Bulunulan gün hesaplamalara dahil edilemez. AKD ya da AKDE şeklinde kontrol yapılmalı. Derinlik lisansı gerekmez.

Endpoint

HTTP GET

Endpoint https://apitest.matriksdata.com/dumrul/v1/flow-analysis/dtv

Query Parameters

Parameter	Type	Required	Example	Description
index	text	true	XU100	İlgili endeks seçimi buradan yapılır. Zorunlu alandır, kullanıcı tarafından seçilmelidir. Çoklu seçim yoktur.
symbol	text	true	GARAN, ZOREN, THYAO	İlgili sembol seçimi buradan yapılır. Zorunlu alandır, kullanıcı tarafından seçilmelidir. Çoklu seçim mevcuttur, 101 sembole kadar seçilebilir. Semboller virgül ile ayrılarak yazılmalıdır.
start	date	true	2023-02-01,2023-02-20	"end" parametresi ile birlikte çalışır. end parametresinden ileri tarih periyodu olamaz. İlgili birinci periyod tarihleri girilmelidir. Tarihler virgül ile ayrılarak girilmelidir. İki tarih arasında maksimum 30 gün olacak biçiminde girilebilir. Tarihlerde en fazla 1 sene geriye gidilebilir.
end	date	true	2023-08-01,2023-08-20	"start" parametresi ile birlikte çalışır. start parametresinden geride bir tarih periyodu olamaz. İlgili ikinci periyod tarihleri girilmelidir. Tarihleri virgül ile ayrılarak girilmelidir. İki tarih arasında maksimum 30 gün olacak biçiminde girilebilir. Tarihlerde en fazla 1 sene geriye gidilebilir.

Response Description

{
    "i": "İlgili endeks'in kodunu belirtir",
    "iFp": "Endeksin birinci periyodunun ilk tarihindeki açılış değerini getirir",
    "iSp": "Endeksin ikinci periyodunun son tarihindeki kapanış değerini getirir",
    "iFpV": "İlk dönem endeks hacmini belirtir",
    "iSpV": "İkinci dönem endeks hacmini belirtir",
    "iVpC": "Endeks hacim yüzdelik değişimi belirtir. [ (iFpV / iSpV) * 100 ]",
    "iFpQ": "İlk dönem endeks adedini belirtir",
    "iSpQ": "İkinci dönem endeks adedini belirtir",
    "iQpC": "Endeks adet yüzdelik değişimi belirtir. [ (iFpQ / iSpQ) * 100 ]",
    "symbols": [{
        "s": "Sembolün kodunu belirtir",
        "fP": "Sembolün birinci periyodunun ilk tarihindeki açılış değerini getirir",
        "sP": "Sembolün ikinci periyodunun son tarihindeki kapanış değerini getirir",
        "fPv": "Sembolün ilk periyodunun hacmini belirtir",
        "sPv": "Sembolün ikinci periyodunun hacmini belirtir",
        "vPc": "Sembolün hacim yüzdelik değişimini belirtir. [ (fPv / sPv) * 100 ]",
        "dV": "Hacimdeki sapmayı belirtir. [ vPc - iVpC ]",
        "fPq": "Sembolün ilk periyodunun adedini belirtir",
        "sPq": "Sembolün ikinci periyodunun adedini belirtir",
        "qPc": "Sembolün adet yüzdelik değişimini belirtir. [ (fPq / sPq) * 100 ]",
        "dQ": "Adet bazlı sapmayı belirtir. [ qPc - iQpC ]"
    }]
}

Sample Request-Response

https://apitest.matriksdata.com/dumrul/v1/flow-analysis/dtv?symbol=GARAN,FENER,THYAO,ZOREN,TUPRS&index=XU100&start=2023-02-01,2023-02-20&end=2023-08-01,2023-08-20

{
    "i": "XU100",
    "iFp": 4713.39,
    "iSp": 7513.29,
    "iFpV": 635504945135.3,
    "iSpV": 2146075360517.15,
    "iVpC": 237.69609142227003,
    "iFpQ": 25160630924,
    "iSpQ": 72635880071,
    "iQpC": 188.68862744500865,
    "symbols": [
        {
            "s": "GARAN",
            "fP": 22.36,
            "sP": 50.65,
            "fPv": 9581561660.62,
            "sPv": 51847062764.36,
            "vPc": 441.1128644869055,
            "dV": -11.13,
            "fPq": 420132582,
            "sPq": 1010230736,
            "qPc": 140.45522277536665,
            "dQ": 6.95
        }
    ]
}

---

Aracı Kurum Bazlı (STF)

Description

Kullanıcı tarafından seçilen aracı kurumların, yine kullanıcı tarafından seçilen tarih ve yüzde dilimlerine göre yapmış oldukları alım veya satım işlemlerindeki yüzdelik oranlarını sembol bazında getirir. Sembol detayında ilgili aracı kurumları listeler. Sadece AKDE lisansı kontrol edilmeli.

Endpoint

HTTP GET

Endpoint https://apitest.matriksdata.com/dumrul/v1/flow-analysis/stf

Query Parameters

Parameter	Type	Required	Example	Description
agents	text	true	GRM, YKR, MLB	Kullanıcı tarafından seçilecek olan aracı kurumlar bu parametrede gönderilir. Maksimum 5 aracı kurum seçilebilir olacak.
bidask	text	true	ask	Kullanıcı tarafından "alış" veya "satış" yönü seçimleri bu parametre ile gönderilir. ask (Satış), bid (Alış) Hatalı gönderimde uyarı verir.
type	text	true	quantity	Kullanıcı tarafından TL veya Adet seçeneklerine istinaden gönderilecek. quantity (Adet), volume (TL) Hatalı gönderimde uyarı verir.
period	text	true	daily	Yalnızca parantez içerisindeki periodlar girilebilir. (5,10,15,60,daily) Sayı ile belirtilenler dakika cinsindendir. Gün içi datayı verir. start ve end parametreleri ile birlikte kullanılamaz.
start	date	true	2023-08-01	Maksimum 1 ay geriye giderek start ve end tarihi aralığı maksimum 1 hafta olacak biçimde yapılabilinir. Start end'den büyük olamaz. period parametresi ile birlikte kullanılamaz.
end	date	true	2023-08-20	Maksimum 1 ay geriye giderek start ve end tarihi aralığı maksimum 1 hafta olacak biçimde yapılabilinir. End start'dan küçük olamaz. period parametresi ile birlikte kullanılamaz.
percent	integer	true	30	Yüzde değeri gönderilecek. 1 ile 100 arasında bir rakam gönderilmeli. Agent'ların sembol bazındaki yapmış oldukları yüzdesel değerdir.

Response Description

{
    "s": "Seçilen aracı kurumlarda parametrelere uyan sembollerin kod alanı",
    "a": "Sembolün anlık son satış fiyatı",
    "b": "Sembolün anlık son alış fiyatı",
    "q": "Sembolün seçili aracı kurumlar içerisindeki seçili tarihlere ait toplam adedi",
    "v": "Sembolün seçili aracı kurumlar içerisindeki seçili tarihlere ait toplam TL'si",
    "p": "Sembolün seçili aracı kurumlar içerisindeki seçilen tipe göre toplam oranı",
    "c": "Sembolün maliyeti. Hacim / Adet",
    "agents": [{
        "agent": "Sembolün, hangi aracı kurumlarda olduğunu göstereden aracı kurum kodu",
        "q": "Adet",
        "v": "Hacim",
        "p": "Yüzde"
    }]
}

Sample Request-Response

https://apitest.matriksdata.com/dumrul/v1/flow-analysis/stf?agents=GRM,YKR,OSM,MLB,ISY&bidask=ask&type=quantity&percent=1&start=2023-09-01&end=2023-09-10

{
    "s": "ADESE",
    "a": 1.94,
    "b": 1.93,
    "q": 137030852,
    "v": 282096658.56,
    "p": 2.74,
    "c": 2.06,
    "agents": [
        {
            "agent": "GRM",
            "q": 24397187,
            "v": 50192130.95,
            "p": 0.89
        },
        {
            "agent": "MLB",
            "q": 70460214,
            "v": 145056515.69,
            "p": 1.26
        }
    ]
}

---

Aracı Kurum Takip (ATF)

Description

Kullanıcı tarafından seçilen aracı kurumların, yine kullanıcı tarafından seçilen tarih ve yüzde dilimlerine göre yapmış oldukları alım veya satım işlemlerindeki yüzdelik oranlarını sembol bazında getirir. Sembol detayında ilgili aracı kurumları listeler.

Lisans Kontrolü: AKDE ve VAKD veya AKD ve VAKD eşlemesine sahip olunmalıdır.

Endpoint

HTTP GET

Endpoint https://apitest.matriksdata.com/dumrul/v1/flow-analysis/atf

Query Parameters

Parameter	Type	Required	Example	Description
agents	text	true	GRM, YKR, MLB	Kullanıcı tarafından seçilecek olan aracı kurumlar bu parametrede gönderilir. Maksimum 5 aracı kurum seçilebilir olacak.
bidask	text	true	ask	Kullanıcı tarafından "alış" veya "satış" yönü seçimleri bu parametre ile gönderilir. ask (Satış), bid (Alış) Hatalı gönderimde uyarı verir.
type	text	true	quantity	Kullanıcı tarafından TL veya Adet seçeneklerine istinaden gönderilecek. quantity (Adet), volume (TL) Hatalı gönderimde uyarı verir.
period	text	true	daily	Yalnızca parantez içerisindeki periodlar girilebilir. (5,10,15,60,daily) Sayı ile belirtilenler dakika cinsindendir. GÜn içi datayı verir.
percent	integer	true	30	Yüzde değeri gönderilecek. 1 ile 100 arasında bir rakam gönderilmeli. Agent'ların sembol bazındaki yapmış oldukları yüzdesel değerdir.

Response Description

{
    "agent": "Sembolün, hangi aracı kurumlarda olduğunu göstereden aracı kurum kodu",
    "s": "Seçilen aracı kurumlarda parametrelere uyan sembollerin kod alanı",
    "a": "Sembolün anlık son satış fiyatı",
    "b": "Sembolün anlık son alış fiyatı",
    "p": "Sembolün seçili aracı kurumlar içerisindeki seçilen tipe göre toplam oranı",
    "q": "Sembolün seçili aracı kurumlar içerisindeki seçili tarihlere ait toplam adedi"
}

Sample Request-Response

https://apitest.matriksdata.com/dumrul/v1/flow-analysis/atf?agents=GRM,YKR,OSM,MLB&bidask=ask&type=quantity&period=15&percent=10

[
    {
        "agent": "GRM",
        "s": "YKBNK",
        "a": 17.14,
        "b": 17.13,
        "p": 8.81,
        "q": 1436009
    },
    {
        "agent": "GRM",
        "s": "OZKGY",
        "a": 9.12,
        "b": 9.1,
        "p": 5.25,
        "q": 855629
    },
    {
        "agent": "YKR",
        "s": "YKBNK",
        "a": 17.14,
        "b": 17.13,
        "p": 6.55,
        "q": 1067540
    },
    {
        "agent": "YKR",
        "s": "KOZAL",
        "a": 29.02,
        "b": 29,
        "p": 17.69,
        "q": 2881290
    },
    {
        "agent": "MLB",
        "s": "KOZAL",
        "a": 29.02,
        "b": 29,
        "p": 5.28,
        "q": 860367
    }
]

---

Para Giriş Çıkışı (Flow Equities)

Description

İlgili sembollerin spot ve vadeli enstrümanları için ilk 5 kurumu ve diğer tüm kurumların toplamının para giriş çıkışını adet ve hacim cinsinden gösterir. Alıcı & satıcı ilk N sıralaması her zaman pay piyasası alış ve satış değerine göre yapılır. Dönen veride hem hisse hem vioplar yer aldığı için lisans kontrolü AKDE && VAKD ya da AKD && VAKD şeklinde yapılmalıdır. Sembol tipi parametresine göre "S"(stock) istenirse sadece AKDE veya AKD, "F"(future) istenirse sadece VAKD kontrolü yapılır.

Endpoint

HTTP GET

Endpoint https://apitest.matriksdata.com/dumrul/v1/flow-analysis/equities

Query Parameters

Parameter	Type	Required	Example	Description
type	text	true	volume	"volume" (TL cinsinden hesaplamaları gösterir) veya "quantity" (adet cinsinden hesaplamaları gösterir) verilmelidir.
start	date	true	2023-08-02	start-end aralığı en fazla 92 gün olabilir. start değerine en fazla 92 gün öncesi verilebilir.
end	date	true	2023-08-02	start-end aralığı en fazla 92 gün olabilir. start değerine en fazla 92 gün öncesi verilebilir.
symbols	text	false	GARAN,AKBNK	En fazla 10 sembol verilebilir. "indexes" parametresi ile birlikte kullanılamaz. "indexes" veya "symbols" parametrelerinden biri kesinlikle verilmelidir.
indexes	text	false	XU030	4 endeksten birini alabilir(XU030, XU100, XLBNK, X10XB). "symbols" parametresi ile birlikte kullanılamaz. "indexes" veya "symbols" parametrelerinden biri kesinlikle verilmelidir.
symbolType	text	false	S	"S"(stock) veya "F"(future) değerlerini alabilir. Verilmezse her ikisi için de veri döner. Lisanslama, servis açıklamasında belirtildiği gibi yapılır.

Response Description

{
    "sym": "Sembol kodu",
    "pPer": "Start-end arasında yüzde fiyat değişimi",
    "totNetAskVolS": "Ask altındaki ilk 5 kurumun toplam netAskVolS değeri",
    "totNetBidVolS": "Bid altındaki ilk 5 kurumun toplam netBidVolS değeri",
    "totNetAskVolF": "Ask altındaki ilk 5 kurumun toplam netAskVolF değeri",
    "totNetBidVolF": "Bid altındaki ilk 5 kurumun toplam netBidVolF değeri",
    "totNetVolPGC": "(totNetAskVolS + totNetAskVolF) - (totNetBidVolS + totNetBidVolF)",
    "totNetAskQtyS": "Ask altındaki ilk 5 kurumun toplam netAskQtyS değeri",
    "totNetBidQtyS": "Bid altındaki ilk 5 kurumun toplam netBidQtyS değeri",
    "totNetAskQtyF": "Ask altındaki ilk 5 kurumun toplam netAskQtyF değeri",
    "totNetBidQtyF": "Bid altındaki ilk 5 kurumun toplam netBidQtyF değeri",
    "totNetQtyPGC": "(totNetAskQtyS + totNetAskQtyF) - (totNetBidQtyS + totNetBidQtyF)",
    "ask": [{
        "code": "Kurum Kodu",
        "id": "Kurum id'si",
        "netAskVolS": "Net Alış Hacmi Hisse",
        "netAskVolF": "Net Alış Hacmi Vadeli"
    }],
    "bid": [{
        "code": "Kurum Kodu",
        "id": "Kurum id'si",
        "netBidVolS": "Net Satış Hacmi Hisse",
        "netBidVolF": "Net Satış Hacmi Vadeli"
    }],
    "rest": {
        "netAskVolS": "Net Alış Hacmi Hisse",
        "netBidVolS": "Net Satış Hacmi Hisse",
        "netAskVolF": "Net Alış Hacmi Vadeli",
        "netBidVolF": "Net Satış Hacmi Vadeli"
    }
}

Sample Request-Response

Type=volume örneği: https://apitest.matriksdata.com/dumrul/v1/flow-analysis/equities?start=2023-08-21&end=2023-08-21&symbols=GARAN&type=volume

{
    "all": [
        {
            "sym": "GARAN",
            "pPer": 0,
            "totNetAskVolS": 234290359.48999998,
            "totNetBidVolS": 206120267.32999995,
            "totNetAskVolF": 640903.190000001,
            "totNetBidVolF": -107282.0099999999,
            "totNetVolPGC": -28918277.36,
            "ask": [
                {
                    "code": "UNS",
                    "id": 104,
                    "netAskVolS": 78715059.49,
                    "netAskVolF": 420424.85000000003
                },
                {
                    "code": "TRA",
                    "id": 288,
                    "netAskVolS": 63673295.58,
                    "netAskVolF": 4831.72
                }
            ],
            "bid": [
                {
                    "code": "IYM",
                    "id": 211,
                    "netBidVolS": 52866009.29999995,
                    "netBidVolF": 2147.170000000042
                },
                {
                    "code": "HSY",
                    "id": 194,
                    "netBidVolS": 42298089.09,
                    "netBidVolF": -81609.6
                }
            ],
            "rest": {
                "netAskVolS": 73454227.67999995,
                "netBidVolS": 101624319.84000002,
                "netAskVolF": 175159.0999999999,
                "netBidVolF": 845790.14
            }
        }
    ],
    "startDate": "2023-08-21",
    "endDate": "2023-08-21"
}

Type=quantity örneği: https://apitest.matriksdata.com/dumrul/v1/flow-analysis/equities?start=2023-08-21&end=2023-08-21&symbols=GARAN&type=quantity

{
    "all": [
        {
            "sym": "GARAN",
            "pPer": 0,
            "totNetAskQtyS": 4675410,
            "totNetBidQtyS": 4167869,
            "totNetAskQtyF": 12953,
            "totNetBidQtyF": -2203,
            "totNetQtyPGC": -522697,
            "ask": [
                {
                    "code": "UNS",
                    "id": 104,
                    "netAskQtyS": 1599595,
                    "netAskQtyF": 8567
                },
                {
                    "code": "TRA",
                    "id": 288,
                    "netAskQtyS": 1286277,
                    "netAskQtyF": 98
                }
            ],
            "bid": [
                {
                    "code": "IYM",
                    "id": 211,
                    "netBidQtyS": 1102516,
                    "netBidQtyF": 34
                },
                {
                    "code": "HSY",
                    "id": 194,
                    "netBidQtyS": 837690,
                    "netBidQtyF": -1645
                }
            ],
            "rest": {
                "netAskQtyS": 1535429,
                "netBidQtyS": 2042970,
                "netAskQtyF": 3589,
                "netBidQtyF": 17162
            }
        }
    ],
    "startDate": "2023-08-21",
    "endDate": "2023-08-21"
}