Bilançolar
Bilanço Açıklanma Tarihleri
Description
Bilançoların açıklanma tarihlerini verir. Parametre verilmediğinde tüm sembollerde açıklanan son bilançolar için tarih bilgisi döner.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/fundamentals/declaration-dates
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| symbol | text | false | MTRKS | En fazla 20 sembol verilebilir. |
| period | integer | false | 202409 | En fazla 5 periyot verilebilir. |
| start | date (YYYY-MM-DD) | false | 2025-01-01 | end tarihinden daha yeni olamaz ve birlikte kullanılmalıdır. |
| end | date (YYYY-MM-DD) | false | 2025-01-24 | start tarihinden daha eski olamaz ve birlikte kullanılmalıdır. |
| last | integer | false | 50 | Açıklanma tarihine göre son N bilginin dönmesini sağlar. symbol parametresi ile birlikte kullanılabilir. |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/fundamentals/declaration-dates?symbol=BUCIM
[
{
"symbol": "BUCIM",
"info": [
{
"period": "202506",
"date": "2025-08-19",
"revisedDate": [
"2025-08-21"
]
},
{
"period": "202503",
"date": "2025-05-09"
}
]
}
]
Açıklanan Bilanço Periyotları
Description
İlgili sembol için solo veya konsolide olarak hangi dönemler bilanço bilgisi olduğunu gösterir. Bilanço servislerine gitmeden önce periyot ve sembol bilgisi için bu servis kullanılmalıdır.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/fundamentals/periods
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| symbol | text | true | MTRKS | Bir adet sembol verilebilir. |
| unadjusted | text | false | true | true verildiğinde mevcut bilançolar hariç düzeltme gelen bilançolar için de periyotları döner. Daha düzeltme gelmemiş bilançolarda görünür. |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/fundamentals/periods?symbol=MTRKS
{
"BS": [
{
"year": "2023",
"months": [
{
"month": "09",
"types": [
"C"
]
},
{
"month": "06",
"types": [
"C"
]
},
{
"month": "03",
"types": [
"C"
]
}
]
}
],
"CF": [
{
"year": "2023",
"months": [
{
"month": "09",
"types": [
"C"
]
},
{
"month": "06",
"types": [
"C"
]
},
{
"month": "03",
"types": [
"C"
]
}
]
}
],
"INC": [
{
"year": "2023",
"months": [
{
"month": "09",
"types": [
"C"
]
},
{
"month": "06",
"types": [
"C"
]
},
{
"month": "03",
"types": [
"C"
]
}
]
}
],
"isTogether": false
}
Bilanço Tablosu
Description
Birden fazla sembol ve birden fazla döneme ait bilanço tablosu verilerini tek seferde sorgulama imkanı sunar. BS endpoint'i JSON formatında veri dönerken, BS.csv endpoint'i CSV formatında veri döner. Period bilgisi yıl ve ay içerir ve 3 aylık dönemlerde açıklanan bilanço tabloları için her yıl 3, 6, 9 ve 12. ayları bir dönemi temsil eder. Item alanındaki değerler noktalarla ayrılmış 3 karakterli kodlar içerir. Her bir kaleme karşılık bir kod bulunur. 3 karakterli kodların nokta ile ayrılması alt kalemleri gösterir. Örneğin BAF.BFK, BAF'ın alt kalemidir.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/fundamentals/BS
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| symbols | string | true | GARAN,AKBNK | Sembol kodunun sonuna '@C' eklenerek sorgu yapıldığında konsolide bilanço verleri döner. |
| periods | string | true | 202003,202006 | Period bilgisi yıl ve ay içerir. Bilançolar 3 aylık dönemlerde açıklandığından her yıl için 3,6,9 ve 12. ayları bir dönemi gösterir. Bunlar dışındaki aylar kullanılırsa veri gelmez. |
| currency | string | false | USD | TRY, USD veya EUR değerlerini alabilir. Verilmezse TRY döner. Değerlerin ilgili kur karşılığını gösterir. |
| lang | string | false | en | Sadece "en" değerini alabilir, verildiğinde description alanı İngilizce olarak gösterilir. |
| unadjusted | string | false | true | true verildiğinde enflasyon muhasebesi uygulanmamış/düzeltilmemiş veriyi döner. |
Sample Request-Response
CSV Response (BS.csv):
item,description,AKBNK_202003,GARAN_202003,AKBNK_202006,GARAN_202006
VAR,VARLIKLAR,0,0,0,0
VAR.FVR,FİNANSAL VARLIKLAR (Net),156480881000,99107558000,134155081000,99016647000
VAR.FVR.ANN,Nakit ve Nakit Benzerleri,65001093000,65683659000,54983515000,59363516000
VAR.FVR.ANN.AND,Nakit Değerler ve Merkez Bankası,44686810000,58304823000,42732155000,44280061000
VAR.FVR.ANN.BNK,Bankalar,17768400000,6373331000,12251850000,15103351000
JSON Response (BS):
[
{
"item": "VAR",
"description": "VARLIKLAR",
"val": [
{
"columnName": "AKBNK_202003",
"value": 0
},
{
"columnName": "GARAN_202003",
"value": 0
}
]
},
{
"item": "VAR.FVR",
"description": "FİNANSAL VARLIKLAR (Net)",
"val": [
{
"columnName": "AKBNK_202003",
"value": 156480881000
},
{
"columnName": "GARAN_202003",
"value": 99107558000
}
]
}
]
Gelir Tablosu
Description
Birden fazla sembol ve birden fazla döneme ait gelir tablosu verilerini tek seferde sorgulama imkanı sunar. INC endpoint'i JSON formatında veri dönerken, INC.csv endpoint'i CSV formatında veri döner. Period bilgisi yıl ve ay içerir ve 3 aylık dönemlerde açıklanan nakit akışları için her yıl 3, 6, 9 ve 12. ayları bir dönemi temsil eder. Item alanındaki değerler noktalarla ayrılmış 3 karakterli kodlar içerir. Her bir kaleme karşılık bir kod bulunur. 3 karakterli kodların nokta ile ayrılması alt kalemleri gösterir. Örneğin BAF.BFK, BAF'ın alt kalemidir.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/fundamentals/INC
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| symbols | string | true | GARAN,AKBNK | Sorgulanacak sembol kodları (virgülle ayrılmış) |
| periods | string | true | 202003,202006 | Period bilgisi yıl ve ay içerir. Gelir Tabloları 3 aylık dönemlerde açıklandığından her yıl için 3,6,9 ve 12. ayları bir dönemi gösterir. Bunlar dışındaki aylar kullanılırsa veri gelmez. |
| currency | string | false | USD | TRY, USD veya EUR değerlerini alabilir. Verilmezse TRY döner. Değerlerin ilgili kur karşılığını gösterir. |
| lang | string | false | en | Sadece "en" değerini alabilir, verildiğinde description alanı İngilizce olarak gösterilir. |
| unadjusted | string | false | true | true verildiğinde enflasyon muhasebesi uygulanmamış/düzeltilmemiş veriyi döner. |
Sample Request-Response
CSV Response (INC.csv):
item,description,AKBNK_202003,GARAN_202003,AKBNK_202006,GARAN_202006
100,Kar veya Zarar Tablosu (TFRS 9''a Göre Karşılık Ayrılmış),0,0,0,0
101,FAİZ GELİRLERİ,8072797000,8913954000,15925360000,17347446000
101.101,Kredilerden Alınan Faizler,5854750000,7337179000,11424027000,14386198000
101.102,Zorunlu Karşılıklardan Alınan Faizler,13689000,0,13689000,0
101.103,Bankalardan Alınan Faizler,102097000,41993000,124786000,55741000
101.104,Para Piyasası İşlemlerinden Alınan Faizler,46663000,55375000,51726000,99039000
101.105,Menkul Değerlerden Alınan Faizler,2048556000,1361949000,4298692000,2601481000
101.105.101,Gerçeğe Uygun Değer Farkı Kar Zarara Yansıtılanlar,5590000,26161000,9108000,50175000
JSON Response (INC):
[
{
"item": "100",
"description": "Kar veya Zarar Tablosu (TFRS 9''a Göre Karşılık Ayrılmış)",
"val": [
{
"columnName": "AKBNK_202003",
"value": 0
},
{
"columnName": "GARAN_202003",
"value": 0
}
]
},
{
"item": "101",
"description": "FAİZ GELİRLERİ",
"val": [
{
"columnName": "AKBNK_202003",
"value": 8072797000
},
{
"columnName": "GARAN_202003",
"value": 8913954000
}
]
}
]
Nakit Akış Tablosu
Description
Birden fazla sembol ve birden fazla döneme ait gelir tablosu verilerini tek seferde sorgulama imkanı sunar. INC endpoint'i JSON formatında veri dönerken, INC.csv endpoint'i CSV formatında veri döner. Period bilgisi yıl ve ay içerir ve 3 aylık dönemlerde açıklanan nakit akışları için her yıl 3, 6, 9 ve 12. ayları bir dönemi temsil eder. Item alanındaki değerler noktalarla ayrılmış 3 karakterli kodlar içerir. Her bir kaleme karşılık bir kod bulunur. 3 karakterli kodların nokta ile ayrılması alt kalemleri gösterir. Örneğin BAF.BFK, BAF'ın alt kalemidir.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/fundamentals/CF
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| symbols | string | true | GARAN,AKBNK | Sorgulanacak hisse senetleri sembolleri |
| periods | string | true | 202003,202006 | Period bilgisi yıl ve ay içerir. Nakit Akışları 3 aylık dönemlerde açıklandığından her yıl için 3,6,9 ve 12. ayları bir dönemi gösterir. Bunlar dışındaki aylar kullanılırsa veri gelmez. |
| currency | string | false | USD | TRY, USD veya EUR değerlerini alabilir. Verilmezse TRY döner. Değerlerin ilgili kur karşılığını gösterir. |
| lang | string | false | en | Sadece "en" değerini alabilir, verildiğinde description alanı İngilizce olarak gösterilir. |
| unadjusted | string | false | true | true verildiğinde enflasyon muhasebesi uygulanmamış/düzeltilmemiş veriyi döner. |
Sample Request-Response
CSV Response (CF.csv):
item,description,AKBNK_202003,GARAN_202003,AKBNK_202006,GARAN_202006
100,Nakit Akış Tablosu (TFRS 9''a Göre Karşılık Ayrılmış),0,0,0,0
BAF,BANKACILIK FAALİYETLERİNE İLİŞKİN NAKİT AKIŞLARI,0,0,0,0
BAF.BFK,Bankacılık Faaliyet Konusu Varlık ve Yükümlülüklerdeki Değişim Öncesi Faaliyet Kârı,3958764000,3740855000,7783175000,11170238000
BAF.BFK.BAF,Alınan Faizler,7365996000,7235039000,14055380000,17737246000
BAF.BFK.COF,Ödenen Faizler,-3125723000,-3042410000,-6354444000,-6293115000
JSON Response (CF):
[
{
"item": "100",
"description": "Nakit Akış Tablosu (TFRS 9''a Göre Karşılık Ayrılmış)",
"val": [
{
"columnName": "AKBNK_202003",
"value": 0
},
{
"columnName": "GARAN_202003",
"value": 0
}
]
},
{
"item": "BAF",
"description": "BANKACILIK FAALİYETLERİNE İLİŞKİN NAKİT AKIŞLARI",
"val": [
{
"columnName": "AKBNK_202003",
"value": 0
},
{
"columnName": "GARAN_202003",
"value": 0
}
]
},
{
"item": "BAF.BFK.BAF",
"description": "Alınan Faizler",
"val": [
{
"columnName": "AKBNK_202003",
"value": 7365996000
},
{
"columnName": "GARAN_202003",
"value": 7235039000
}
]
}
]