Tahvil/Repo Piyasası
Tahvil ve Bono Tanımları
Description
Borsa İstanbul'da işlem gören tahvil ve bonoların detaylı bilgilerini döner. Veriler saatte bir otomatik olarak yenilenir. Eğer bir alan ilgili enstrüman için boş ise, o alan response'da yer almaz.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/bonds
Query Parameters
| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| isin | string | false | - | TRB110326T12 | ISIN kodu belirtilirse sadece o tahvil/bono döner. Belirtilmezse tüm tahvil/bonolar döner. |
Response Description
| Alan | TR Açıklama | EN Description |
|---|---|---|
| updatedAt | Response oluşturulma zamanı | Response creation timestamp |
| data | Tahvil/bono objelerini içeren dizi | Array of bond/bill objects |
| isin | ISIN Kodu | ISIN Code |
| relSec | İlgili Menkul Kıymet | Related Security |
| iss | İhraççı Kurum | Issuer |
| issTyp | İhraç Türü | Type of Issuance |
| intTyp | Getiri Türü | Type of Interest |
| secTyp | MK Türü | Type of Security |
| cpnFrq | Yıllık Kupon Sıklığı | Coupons Frequency |
| cur | Para Birimi | Currency |
| grp | Grup Kodu | Group Code |
| fissDt | İlk İhraç Tarihi | First Issue Date |
| matDt | İtfa Tarihi | Maturity Date |
| dtm | Vadeye Kalan Gün | Days to Maturity |
| totIss | Toplam İhraç Tutarı Nom. | Total Issue Amount Nom. |
| lissDt | Son İhraç Tarihi | Last Issue Date |
| lissPr | Son İhraç Fiyatı | Last Issue Price |
| lissYld | Son İhraç Getirisi % (yıllık basit) | Last Issue Yield % (simple p.a.) |
| fissYld | İlk İhraç Getirisi % (yıllık basit) | First Issue Yield % (simple p.a.) |
| ncpnDt | Sonraki Kupon Tarihi | Next Coupon Date |
| ncpnRt | Sonraki Kupon Oranı % | Next Coupon Rate % |
| spr | Ek Getiri (%) | Spread (%) |
| fissPr | İlk İhraç Fiyatı | First Issue Price |
| qtMth | Emir Giriş Yöntemi | Quotation Method |
| accInt | İşlemiş Faiz/Kira | Accrued Interest/Lease |
| clnPr | Temiz Fiyat | Clean Price |
| drtPr | Kirli Fiyat | Dirty Price |
| stlPr | Takas Fiyatı | Settlement Price |
| yld | Getiri | Yield |
| cmpYld | Bileşik Getiri | Compound Yield |
| dcc | Gün Sayım Konvansiyonu | Day Count Convention |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/bonds
{
"updatedAt": "2025-12-01T11:00:00.282Z",
"data": [
{
"isin": "TRB110326T12",
"iss": "Hazine / Turkish Treasury",
"issTyp": "İhale / Auction",
"intTyp": "İskontolu / Discounted",
"secTyp": "Devlet Tahvili / Government Bond",
"cpnFrq": "-",
"cur": "TRY",
"grp": "152",
"fissDt": "11.06.2025",
"matDt": "11.03.2026",
"dtm": "100",
"totIss": "54,635,970",
"lissDt": "11.06.25",
"lissPr": "74.978",
"lissYld": "44.5",
"fissYld": "44.5",
"fissPr": "74.978",
"qtMth": "Basit Getiri/Simple Yield",
"accInt": "-",
"clnPr": "-",
"drtPr": "Formül 1/Formula 1",
"stlPr": "Kirli Fiyat/Dirty Price",
"yld": "Giriş/Input",
"cmpYld": "Formül 3/Formula 3",
"dcc": "ACT365"
}
]
}
Snapshot Market Verisi
Description
Tahvil/Repo piyasasına ait kullanıcı lisansına göre anlık (BD2 ve BD1P lisanslarını kontrol eder) veya gecikmeli snapshot veri döner. Terminalde bulunan sayfa yapısı üzerinden geliştirilmiştir.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/pages
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| page | int | true | 1 | Sayfa numarası. 1: Kesin Alım Satım Pazarı, 2: Kesin Alım Satım Pazarı Özet, 3: Repo/Ters Repo Pazarı, 4: Repo/Ters Repo Pazarı Özet, 6: Kesin Alım Satım Küçük Emirler Pazarı |
| type | text | false | gov | gov (devlet) veya private (özel). Sadece sayfa 1, 2 ve 6 için geçerlidir. Verilmediğinde tüm veri döner. |
Response Description
Alanlar — page(1, 2, 6)
| Field | Açıklama |
|---|---|
| VL | Valör Tarihi |
| ISIN | Uluslararası Menkul Kıymet Tanıtma Kodu |
| BPRICE | En İyi Alış Fiyatı |
| BSIZE | En İyi Alıştaki Miktar |
| BRATE | En İyi Alış Oranı |
| ARATE | En İyi Satış Oranı |
| ASIZE | En İyi Satıştaki Miktar |
| APRICE | En İyi Satış Fiyatı |
| TRDDATE1 | Son İşlem Tarihi |
| LRATE | Son İşlem Oranı |
| LPRICE | Son İşlem Fiyatı |
| LSIZE | Son İşlem Miktarı |
| CY | Bileşik Oran |
| PCT | Yüzde Değişim |
| NCH | Net Değişim |
| DTM | İtfaya Kalan Gün |
| RYLD | TÜFE Oranı |
| PYIELD | Bir Önceki Gün Son İşlem Oranı |
| PPRICE | Bir Önceki Gün Son İşlem Fiyatı |
| PDATE | Bir Önceki İşlem Tarihi |
| TIME | Gönderim Zamanı |
| ONBE | Overnight Eşleniği |
| TV | Toplam İşlem Miktarı (Nominal) |
| AV | Ortalama Fiyat |
| AVG_SY | Ortalama Basit Oran |
| AVG_CY | Ortalama Bileşik Oran |
| HIGH_PR | En Yüksek Fiyat |
| LOW_PR | En Düşük Fiyat |
| HIGH_SY | En Yüksek Basit Oran |
| LOW_SY | En Düşük Basit Oran |
| HIGH_CY | En Yüksek Bileşik Oran |
| LOW_CY | En Düşük Bileşik Oran |
| VOLUME | Hacim (TL) |
| AI | İşlemiş Faiz |
| BSP | Alış Takas Fiyatı |
| ASP | Satış Takas Fiyatı |
| LSP | Son İşlem Takas Fiyatı |
| DTC | Kupon Ödemesine Kalan Gün |
| SP | Takas Fiyatı |
| AVSP | Ortalama Takas Fiyatı |
| BIST_SYMBOL | Borsa Sembolü |
Alanlar — page(3, 4)
| Field | Açıklama |
|---|---|
| VL1 | Valör-1 Tarihi |
| VL2 | Valör-2 Tarihi |
| DAYS | Repo Süresi |
| RISK | Repo Risk Kodu |
| R_VO | En İyi Repo Hacmi |
| R_YI | En İyi Repo Oranı |
| TR_YI | En İyi Ters Repo Oranı |
| TR_VO | En İyi Ters Repo Hacmi |
| LY | Son İşlem Oranı |
| LV | Son İşlem Hacmi |
| TIME | Gönderim Zamanı |
| TV | Toplam İşlem Hacmi |
| IR | En Düşük Oran |
| XR | En Yüksek Oran |
| AR | Ortalama Oran |
| BIST_SYMBOL | Borsa Sembolü |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/pages?page=1
[
{
"VL": "12/09",
"ISIN": "TRT100925T18",
"TRDDATE1": 12.09,
"LRATE": 46.06,
"LPRICE": 68.584,
"LSIZE": 5000000,
"CY": 46.11,
"PCT": 0.08,
"NCH": 0.057,
"DTM": 363,
"PYIELD": 46.1,
"PPRICE": 68.505,
"PDATE": "11/09/2024",
"TIME": "13:54:41",
"ONBE": 37.94,
"TV": 15000000,
"AV": 68.571,
"AVG_SY": 46.09,
"AVG_CY": 46.14,
"HIGH_PR": 68.584,
"LOW_PR": 68.565,
"HIGH_SY": 46.1,
"LOW_SY": 46.06,
"HIGH_CY": 46.15,
"LOW_CY": 46.11,
"VOLUME": 10285657.77,
"BSP": 68.518,
"ASP": 68.584,
"LSP": 68.584,
"BIST_SYMBOL": "TRT100925T18_KESN_T0"
}
]
https://apitest.matriksdata.com/dumrul/v1/pages?page=3
[
{
"VL1": "12/09",
"VL2": "13/09",
"DAYS": 1,
"RISK": "S",
"LY": 48.11,
"LV": 20000000,
"TIME": "15:56:22",
"TV": 855808000000,
"IR": 47.51,
"XR": 51.98,
"AR": 50.91,
"BIST_SYMBOL": "S-NORMAL_REPN_T0-ON"
}
]
Derinlik Verisi
Description
Tahvil/Repo piyasasına ait emir defteri derinlik verisini döner. Kullanıcı lisansına göre anlık (BD2 ve BD1P) veya gecikmeli veri sunulur.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/pages-depth
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| page | int | true | 1 | Sayfa numarası. 1: Kesin Alım Satım Pazarı, 3: Repo/Ters Repo Pazarı, 6: Kesin Alım Satım Küçük Emirler Pazarı |
| symbol | string | false | TRT100925T18_KESN_T0 | Belirtilirse sadece o sembol için derinlik döner. Belirtilmezse tüm semboller döner. Sayfadan dönen BIST_SYMBOL değerini alır. |
Response Description
Derinlik Alanları — page(1, 6) — Kesin Alım Satım Pazarı / Küçük Emirler Pazarı
10 kolon × 10 satır
| Field | Açıklama |
|---|---|
| BTIME | Alış Zamanı |
| BCLEANPR | Alış Temiz Fiyatı |
| BPRICE | Alış Fiyatı |
| BSIZE | Alış Miktarı |
| BRATE | Alış Oranı |
| ARATE | Satış Oranı |
| ASIZE | Satış Miktarı |
| APRICE | Satış Fiyatı |
| ACLEANPR | Satış Temiz Fiyatı |
| ATIME | Satış Zamanı |
Derinlik Alanları — page(3) — Repo/Ters Repo Pazarı
6 kolon × 10 satır
| Field | Açıklama |
|---|---|
| RTIME | Repo Zamanı |
| RSIZE | Repo Miktarı |
| RRATE | Repo Oranı |
| TRRATE | Ters Repo Oranı |
| TRSIZE | Ters Repo Miktarı |
| TRTIME | Ters Repo Zamanı |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/pages-depth?page=1&symbol=TRT100925T18_KESN_T0
[
{
"symbol": "TRT100925T18_KESN_T0",
"depth": [
{
"BTIME": "15:54:10",
"BCLEANPR": 68.510,
"BPRICE": 68.510,
"BSIZE": 5000000,
"BRATE": 46.12,
"ARATE": 46.08,
"ASIZE": 3000000,
"APRICE": 68.540,
"ACLEANPR": 68.540,
"ATIME": "15:54:10"
},
{
"BTIME": "15:53:22",
"BCLEANPR": 68.490,
"BPRICE": 68.490,
"BSIZE": 2000000,
"BRATE": 46.15,
"ARATE": 46.06,
"ASIZE": 5000000,
"APRICE": 68.570,
"ACLEANPR": 68.570,
"ATIME": "15:53:22"
}
]
}
]
https://apitest.matriksdata.com/dumrul/v1/pages-depth?page=3
[
{
"symbol": "S-NORMAL_REPN_T0-ON",
"depth": [
{
"RTIME": "15:56:00",
"RSIZE": 50000000,
"RRATE": 48.25,
"TRRATE": 47.90,
"TRSIZE": 30000000,
"TRTIME": "15:56:00"
},
{
"RTIME": "15:55:10",
"RSIZE": 25000000,
"RRATE": 48.30,
"TRRATE": 47.85,
"TRSIZE": 20000000,
"TRTIME": "15:55:10"
}
]
}
]
Gerçekleşen İşlemler
Description
Tahvil/Repo piyasasına ait gerçekleşen işlem kayıtlarını döner. Kullanıcı lisansına göre anlık (BD2 ve BD1P) veya gecikmeli veri sunulur.
Endpoint
HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/pages-trade
Query Parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| page | int | true | 1 | Sayfa numarası. 1: Kesin Alım Satım Pazarı, 3: Repo/Ters Repo Pazarı, 6: Kesin Alım Satım Küçük Emirler Pazarı |
| symbol | string | false | TRT100925T18_KESN_T0 | Belirtilirse sadece o sembol için işlemler döner. Belirtilmezse tüm semboller döner. Sayfadan dönen BIST_SYMBOL değerini alır. |
Response Description
Alanlar — page(1, 3, 6)
| Field | Açıklama | Notlar |
|---|---|---|
| islemNo | İşlem Numarası | |
| miktar | İşlem Miktarı | |
| time | İşlem Zamanı (SS:DD:SS.mmm) | |
| fiyat | İşlem Fiyatı | |
| oran | İşlem Oranı | |
| bilesikOran | Bileşik Oran | |
| menkulFiyati | Menkul Kıymet Fiyatı | |
| islemYonu | İşlem Yönü: BUY (Aktif Alış) / SELL (Aktif Satış) | |
| islemTipi | İşlem Tipi: NORMAL / RAPOR | |
| crossTrade | Cross Trade: true / false |
Sample Request-Response
https://apitest.matriksdata.com/dumrul/v1/pages-trade?page=1&symbol=TRT100925T18_KESN_T0
[
{
"symbol": "TRT100925T18_KESN_T0",
"trades": [
{
"islemNo": 100423,
"miktar": 5000000,
"time": "15:54:41.320",
"fiyat": 68.584,
"oran": 46.06,
"bilesikOran": 46.11,
"islemYonu": "BUY",
"islemTipi": "NORMAL",
"crossTrade": false
},
{
"islemNo": 100401,
"miktar": 5000000,
"time": "14:22:10.150",
"fiyat": 68.565,
"oran": 46.09,
"bilesikOran": 46.14,
"islemYonu": "SELL",
"islemTipi": "NORMAL",
"crossTrade": false
}
]
}
]
https://apitest.matriksdata.com/dumrul/v1/pages-trade?page=3&symbol=S-NORMAL_REPN_T0-ON
[
{
"symbol": "S-NORMAL_REPN_T0-ON",
"trades": [
{
"islemNo": 55210,
"miktar": 20000000,
"time": "15:56:22.410",
"oran": 48.11,
"islemYonu": "BUY",
"islemTipi": "NORMAL",
"crossTrade": false
},
{
"islemNo": 55198,
"miktar": 15000000,
"time": "15:30:15.080",
"oran": 47.95,
"islemYonu": "SELL",
"islemTipi": "NORMAL",
"crossTrade": false
}
]
}
]