121
BORSA İSTANBUL EXAPI İLETİŞİM YÖNTEMLERİ VE VERİ FORMATLARI Yazan: Bilgi Sistemleri Merkezi Sürüm: 3.3.10. Tarih: 29/06/22 Dosya: /home/website/convert/temp/convert_html/ 5e2aaff865e5606dc80a0244/document.docxx

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

  • Upload
    others

  • View
    6

  • Download
    0

Embed Size (px)

Citation preview

Page 1: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

BORSA İSTANBUL EXAPI İLETİŞİM YÖNTEMLERİ VE

VERİ FORMATLARI

Yazan: Bilgi Sistemleri Merkezi Sürüm: 3.3.10.

Tarih: 16/05/23

Dosya: /tt/file_convert/5e2aaff865e5606dc80a0244/document.docxx

Page 2: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Dökümanın TarihçesiSürüm Tarih Değişikliklerin Özeti1.0 08.09.2000 İlk Yazım1.1 29.10.2000 Yeni emir giriş cevap mesajına referans numarası alanının eklenmesi

Emir değiştirme istek mesajına süre alanı eklendi.Emir durum sorgusu cevap mesajı ile hata mesajları birbirinden ayrıldı.İstek red bilgisi mesajında emir numarası alanının yeri değiştirildi.İşlem bilgisi mesajında emir numarası alanının yeri değiştirildi.Genel yayın mesajlarının asenkron kanaldan iletilmesini açıklayan eklemeler yapıldı.Karşılaşılabilecek mesajlaşma sorunlarıyla ilgili açıklamalar eklendi.

1.2 23.11.2000 Disketle emir iletim modu açık iken ExAPI yoluyla yapılan isteklere karşılık alınan yanıt mesajlarının üye sistemine iletilmesiyle ilgili açıklamalar ve örnekler eklendi.EXAPI PC’lerinden üye sistemlerine gönderilecek olan tüm mesajlar 200 karakterlik sabit uzunluğa tamamlandı.Emir değiştirme ve emir bölme mesajlarının yapısında değişiklik yapıldı.İşlem Bilgisi Mesajlarının yapısında değişiklik yapıldı.Birden fazla mesajla gönderilecek olan genel yayın mesajlarıyla ilgili açıklama ve örnekler eklendi.Mesaj dosyasının bozulması durumu ile ilgili açıklamalar eklendi.

1.3 15.01.2001 Emir değiştirme cevap mesajı tablosunda değişen miktar ve fiyat alanlarıyla ilgili ifadelerde düzeltmeler yapıldı.Emir durum sorgusu cevap mesajında mesaj formatı ile örnekler arasındaki uyumsuzluk giderildi.Emir Bölme Cevap Mesajında “açıklama” alanı içeriğinde değişiklikler yapıldı.ExAPI Yönetim Ekranı ile ilgili açıklamalar eklendi.

1.4 17.04.2001 Genel Yayın Mesajları başlığı altına pazar açılış ve kapanış ifadelerini içeren liste eklendi.ExAPI Durum Bilgisi Mesajı eklendi.

1.5 23.05.2001 Disketle emir iletim modu ve seansında yapılan isim ve kural değişiklikleri doğrultusunda genel yayın mesajı örnekleri ve hata mesajı örnekleri kısmında gerekli düzeltmeler yapıldı. Kural değişikliği ile ilgili açıklamalar işlem bilgisi mesajı bölümünde açıklanmaktadır.Mesaj iletim hızı ile ilgili açıklamalar eklendi.

1.6 04.01.2002 “2.6.4” numaralı yeni PC yazılımı kapsamında yapılan değişikliklerle ilgili olarak çeşitli istek mesajlarına karşılık dönen hata ve red mesaj örnekleri ilave edildi.Bazı maddelerdeki açıklamalar genişletildi ve değiştirildi.

1.7 08.02.2002 “2.6.5” numaralı sürümle beraber, kurum içi sıra numarasının aynı olmasından dolayı reddedilen emirlere karşılık sistemden dönen mesajlara bu emirin sisteme ilk kabul edildiğinde aldığı emir numarası eklendi.(Bakınız 3.3.1.1 mesaj örnekleri)

1.8 08.12.2002 PC’lerdeki mesaj dosyasının silinmiş olması durumu için Emir Bölme Cevap Mesajında, eksik olarak oluşturulan “Emirler” ifadesi ile başlayan kısım, ilgili mesaja eklenmeye başlandı. Bu nedenle 3.2.2.3 Biriken Mesajları Üye Sistemine İndirme Cevap Mesajları başlığı altındaki emir bölme mesajları için yazılı olan uyarı çıkarıldı.ExAPI kullancıları ait oldukları kurumun tüm kullancıları tarafından girilen emirleri değiştirme yetkisine sahip olmaya başladıkları için emir değiştirme (3.1.2.1) ve bölme istek mesajları (3.1.3.1) maddelerine gerekli açıklamalar eklendi.İkinci Ulusal Pazar ve Yeni Ekonomi Pazarı Kuruluş ve Çalışma Esasları genelgelerinin yürürlüğe girmesi nedeniyle 3.4.4 Genel Yayın Mesajları maddesi altındaki piyasa açılış ve kapanışlarıyla ilgili genel yayın mesajları listesindeki “BOLGESEL PAZAR” ifadeleri “IKINCI ULUSAL PAZAR” olarak değiştirildi. Ayrıca, sistemde yer alan tüm hata ve red mesajlarında geçen “Bolgesel Pazar” ifadeleri değiştirildi.Seans sonu işlemleri sırasında fiyat adımı ve marj kontrolünden dolayı iptal edilen emirler için iptal mesajlarında aynı şekilde ifade edilen “Fiyat gecersiz” mesajı yerine “Fiyat marj disi” ve “Fiyat adimi uymuyor” şeklinde iptal nedenini kesin olarak açıklayan red mesajı içerikleri kullanılmaya başlandı. Bu amaçla 3.4.2 Emir İptal Bilgisi Mesaj örneklerinde gerekli değişiklikler yapıldı.Küsurat ve KİE emir girişinin sağlanması nedeniyle Yeni Emir Giriş Mesajı (3.1.1), Emir Değiştirme Mesajı (3.1.2) bölümlerine gerekli açıklamalar eklendi. Ayrıca eklenen bu yeni emir tiplerinin oluşturacağı hata, red ve işlem mesajları için gerekli örnekler ilgili kısımlara ilave edildi.Mesajlaşma Sorunları (5) maddesinin altına Genel Yayın Mesajının Kaybolması (5.4) maddesi eklendi. 2.6.6 sürüm numaralı PC kodunda piyasa açılış ve kapanış mesajlarının kaçırılması durumunda emir gönderilmesinin başlamasını sağlayabilmek için yapılan değişiklikler de bu maddede anlatılmaktadır.Hesap numarası alanının 9 haneden 15 haneye büyütülmesi nedeniyle ilgili istek mesajları ile bunların hata, onay ve red mesajlarında ve bunlarla ilgili örnekler kısımlarında gerekli düzeltmeler yapıldı.Emir Bölme Cevap Mesajlarında (3.1.3.2) “Emirler” ifadesi ile başlayan kısımdan orijinal emir numarası çıkarıldı.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 1

Page 3: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.Sürüm Tarih Değişikliklerin Özeti

3.4.1.1 numaralı İşlem Bilgisi Mesajı yapısına “İŞLEM TİPİ” alanı eklendi. Bu doğrultuda işlem bilgisi mesajları ile ilgili örnekler yeniden düzenlendi.Sisteme girilmiş bir emirin başka bir kullanıcı tarafından iptalinin istenmesi durumunda, 3.4.2 numaralı maddede yer alan emir iptal bilgisi mesajları, 2.6.6 numaralı sürümden itibaren, iptal isteğini yapan kullanıcı ile emirin sahibi olan kullanıcının her ikisine birden gönderilecektir. Bu nedenle 3.4.2 numaralı maddede gerekli açıklamalar yapıldı.

1.9 06.05.2003 Senkron kanaldan dönen emir teyid mesajları yapısına emirin kurum içi sıra numarası bilgisi eklendi.

1.10 07.01.2004 Pay Piyasası Elektronik Alım-Satım Sistemi’ne iletilen emir bilgilerine, kısaca “AFK” olarak tanımlanmış “Acente/Fon Kodu” olarak adlandırılan 3 karakterlik yeni bir alan eklendi.Yeni emir giriş mesajında “açığa satış” ayrımının yapılabilmesi için ALIŞ/SATIŞ alanında ilaveler yapıldı. Ayrıca, diğer mesaj tanımlarının örnekler kısımlarına açıklama amaçlı olarak gerekli örnekler eklendi.

1.11 13.10.2004 Borsa Yatırım Fonları’nın işlem görmeye başlaması nedeniyle Yeni Emir Giriş Mesajı (3.1.1) yapısında gerekli ilaveler yapıldı. Ayrıca Yeni Emir Giriş Mesajı (3.1.1), Emir Değiştirme Mesajı (3.1.2), Emir Bölme Mesajı (3.1.3), Emir İptal Mesajı (3.1.4) bölümlerine gerekli açıklamalar eklendi.Yeni Ekonomi Pazarı’nda işlem gören paylara ExAPI yoluyla emir girilebilmesi için İkinci Ulusal ve Yeni Ekonomi Pazar kodu olarak sadece ‘L’ kullanılmaktaydı. 2.7.1 numaralı PC sürümüyle birlikte bu kodun yanında ‘Y’ pazar koduyla da işlem yapabilmek mümkün olacaktır. Bu amaçla Yeni Emir Giriş Mesajı (3.1.1), Emir Değiştirme Mesajı (3.1.2), Emir Bölme Mesajı (3.1.3), Emir İptal Mesajı (3.1.4) bölümlerine gerekli açıklamalar ilave edildi.

2.0 19.11.2004 1 Ocak 2005 tarihinden itibaren yürürlüğe girecek olan Yeni Türk Lirası (YTL) uygulaması kapsamında yürürlükteki Türk Lirası değerinden altı sıfır atılacak olması nedeniyle mesaj yapıları değiştirildi. Yapılan değişiklikler nedeniyle ilgili mesajların örnekler alanlarında gerekli düzenlemeler yapıldı. Ayrıca Küsurat Emir Girişi YTL uygulaması ile birlikte kaldırıldığından Yeni Emir Giriş Mesajı (3.1.1), Emir Değiştirme Mesajı (3.1.2), Emir İptal Mesajı (3.1.4) bölümlerinde gerekli değişiklikler yapıldı.

2.1 01.03.2005 Açılış Seansı uygulaması kapsamında açılış fiyatlı emirlerin girilebilmesi için değişiklikler yapıldı. Bu amaçla mesaj tanımları ile ilgili örnekler genişletildi.

2.2 06.08.2008 Birincil Piyasa, Resmi Müzayede ve Temerrüt sıralarına ExAPI’den emir girişi sağlandı. Ayrıca Özel Limit Fiyatlı ve Özel Limit Değerli Emirlerin ExAPI’den girilebilmesi için gerekli değişiklikler yapıldı. İşlem Özet Bilgisi Mesajı eklendi. Bu nedenle İşlem Bilgisi mesaj tanımları ile ilgili örnekler genişletildi.

2.3 09.01.2009 Açığa satış işleminin, açılış seansı veya açılışa alınan paylarda yapılamayacağı 298 numaralı genelge çerçevesinde duyurulmuştur. Açığa satış işleminin ret mesajı, istek ret mesajları bölümüne eklenmiştir.

3.0.0 13.04.2009 Piyasa yapıcılığı ve Tek Fiyat işlem yöntemleri ile Kurumsal Ürünler Pazarı ve Gelişen İşletmeler Piyasası’na emir ve kotasyon iletimi ile ilgili gerekli değişiklikler yapılmıştır.

3.1.0 7.10.2009 Temsilci terminallerinden girilen/değiştirilen/iptal edilen emir ve kotasyonlar ile gerçekleştirilen işlemlerin, ilgili üye tarafından yetkilendirilmiş bir ExAPI terminaline gönderilebilmesi için yeni mesajlar eklenmiştir. Ek olarak, ExAPI terminallerinden ilgili üyenin temsilcilerinin işlemlerinin durdurulması veya yeniden başlatılabilmesı için de yeni mesaj tanımlamaları yapılmıştır.Bu çerçevede, Terminal Durum Güncelleme (3.1.7) ve Temsilci İşlemleri Bilgilendirme Mesajları (3.4.4) dökümana eklenmiştir.

3.1.1 29.03.2010 3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek mesajların kapsamı, seansın sürekli müzayede aşaması içinde açılış seansı yapılan menkul kıymetin açılış işlemleri sırasında otomatik kapanması sonrasında otomatik kotasyon atama yapılacağı ve AFK kodlu girilen kotasyonu takip eden seansta otomatik kotasyon atama yapılması durumunda bu AFK kodunun kullanılacağına ilişkin ekleme yapılmıştır.Tek Fiyat işlem sistemine ilişkin olarak 3.1.1.1 Yeni Emir Giriş Mesajı bölümünde Açığa Satış emrinin kullanımı ve AFE emirlerinin geçerlilik sürelerine ilişkin eklemeler ve değişiklikler yapılmıştır. 3,1.2.1 Emir Değiştirme, 3.1.3.1 Bölme ve 3.1.4.1 İptal bölümlerinde Tek Fiyat sürecinin bitişiyle sürekli müzayede seansı bitişi arasındaki süreçte yapılamayacak değişiklikler açıklanmıştır. 3.4.5 Genel Yayın Mesaj bölümünde ise Piyasaların açılma kapanma mesajları bölümüne Tek Fiyat uygulaması nedeniyle eklemeler yapılmıştır.

3.1.2 14.04.2010 3.4.5 nolu Genel Yayın Mesajı başlığına (3/70 nolu sayfaya) “KOTASYON ILETIMI BASLADI.” Şeklindeki mesaj ve açıklaması eklenmiştir.3.3.1.1 nolu İstek Red Bilgisi Mesajlarında yer alan ve bir emir değişiklik ya da bölme isteğinin kotasyonla karşılaşması durumunda gelen bir red mesajına açıklama eklenmiştir.

3.1.3 26.04.2010 3.3.1.1 nolu İstek Red Bilgisi mesajlarına bir istek red bilgisi mesajı eklenmiştir.Gelişen İşletmeler Piyasasına ilişkin Tek Fiyat İşlemleri başlama ve bitiş mesajlarında değişiklik.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 2

Page 4: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.Sürüm Tarih Değişikliklerin Özeti3.1.4 19.07.2010 Emir İptalinin ve değiştirmenin (miktar azaltma ve fiyat kötüleştirme anlamında)

serbest bırakılması uygulaması kapsamında 3.1.2 Emir Değiştirme, 3.1.4 Emir İptal ve 3.3 İstek Red Mesajları bölümlerinde değişiklik yapılmıştır. A, B, C gruplandırması kapsamında 3.1.1.1 Yeni Emir Girişi bölümünde değişiklik yapılmıştır. 3.4.5 Genel Yayın Mesajı bölümünde Kotasyon İletimi başlangıcına ilişkin eklemeler yapılmıştır.

3.1.5 23.02.2011 ve 21.03.2011

Birincil piyasa Sabit Fiyatla ve Değişken Fiyatla Satış Yöntemleri uygulamaları kapsamında yapılan değişiklikler.

3.1.6 03/08/2011 Serbest İşlem Platformuna ilişkin değişiklik3.1.7.0 04/11/2011 Kapanış Seansı, Kapanış Fiyatından İşlemler ve Tek Fiyattan İşlemler kapsamında

yapılan değişiklikler.3.1.7.1 18/11/2011 3.4.4.1 Temsilci Emir Giriş Mesajı geçerlilik süresi alanı 3 karakterden 4 karaktere

çıkarılmıştır.

Piyasa açılış kapanışlarıyla ilgili genel yayın mesajlarının listesinde GİP ile ilgili mesajlarda değişiklik yapılmıştır.

3.1.7.2 28/11/2011 3.3.1.1 İstek Red Bilgisi Mesajı başlığına eklenen dört mesajdan üç tanesi 3.1.1.3 Yeni Emir Giriş Hata Cevabı başlığına bir tanesi 3.2.1.3 Emir durum Sorgusu Hata Mesajı başlığına taşınmıştır.

3.1.1.3 Yeni Emir Giriş Hata Cevabı başlığında bulunan bir mesajın içeriği değiştirilmiştir.

Piyasa açılış kapanışlarıyla ilgili genel yayın mesajlarının listesinde Gözaltı Pazarı ile ilgili mesajlar eklenmiştir.

Piyasa açılış kapanışlarıyla ilgili genel yayın mesajlarının listesine emir aktarım bitiş mesajları eklenmiştir.

3.1.7.3 26.12.2011 3.1.5.3 Yeni Kotasyon Giriş Hata Cevabı ile 3.1.6.3 Kotasyon Değiştirme Hata Mesajı bölümlerindeki mesaj örneklerine “H Kurumsal Urunler Pazari Kapali. Islem Yapamazsiniz.” ve “H Gelismekte Olan Isletmeler Piyasasi Kapali. Islem Yapamazsiniz.” , mesajları eklendi. (Genel Mektup No: 3783)

3.1.7.4 06.01.2012 3.4.5 Genel Yayın Mesajı bölümünde bulunan Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesine pazar bazında emir aktarımı başladı mesajları eklenmiştir.

3.1.7.5 26.01.2012 3.3.1.1 İstek Red Bilgisi Mesajı başlığında mesaj güncellemesi yapılmıştır.3.1.81 25.05.2012 Sertifika Pazarı ile ilgili değişiklikler yapılmıştır.3.1.9 10.12.2012 Fon Pazarı ile ilgili ek kitapçık oluşturuldu.

2.3. Mesaj İletim Hızları adlı başlıkta Fon Pazarı ile ilgili açıklama eklendi.Kapanış seansı saatlerininn değişmesi ile ilgili düzeltmeler yapıldı.Mesaj örneklerinde düzeltmeler yapıldı.

3.3.0 02.07.2013 Emir Bölme uygulamasının kaldırılması ile ilgili düzeltmeler yapıldı.3.3.1 14.07.2013 Kotasyon Güncelleme Bilgisi ile ilgili açıklamalar eklendi.

İçerik1. GİRİŞ...................................................................................................................1-61.1 Dökümanın Amacı..........................................................................................................................1-6

1.1.1 Dökümanın Kullanımı............................................................................................................1-61.2 Hedef Kitle.....................................................................................................................................1-6

1.2.1 Uygulama Programcısının Bilmesi Gerekenler......................................................................1-6

2. GENEL YAPI VE İŞLEYİŞ..............................................................................2-62.1 İletişim Yöntemleri.........................................................................................................................2-6

2.1.1 İletişim Modu ve Ayarlar.......................................................................................................2-62.1.2 Genel Bilgiler ve İş Akışı.......................................................................................................2-7

2.1.2.1 Pay Piyasası API Başlatma İşlemleri..............................................................................2-72.1.2.2 Pay Piyasası ExAPI İletişim Akışı...............................................................................2-162.1.2.3 Pay Piyasası ExAPI İletişim Altyapısı.........................................................................2-19

2.2 Mesaj Tipleri.................................................................................................................................2-192.3 Mesaj İletim Hızı..........................................................................................................................2-21

3. MESAJ TANIMLARI......................................................................................3-213.1 İş (Transaction )İstek ve Cevap Mesajları....................................................................................3-22

3.1.1 Yeni Emir Giriş....................................................................................................................3-223.1.1.1 Yeni Emir Giriş Mesajı.................................................................................................3-223.1.1.2 Yeni Emir Giriş Cevap Mesajı.....................................................................................3-263.1.1.3 Yeni Emir Giriş Hata Cevabı........................................................................................3-27

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 3

Page 5: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.3.1.2 Emir Değiştirme...................................................................................................................3-30

3.1.2.1 Emir Değiştirme Mesajı................................................................................................3-303.1.2.2 Emir Değiştirme Cevap Mesajı....................................................................................3-313.1.2.3 Emir Değiştirme Hata Mesajı.......................................................................................3-32

3.1.3 Emir İptal..............................................................................................................................3-333.1.3.1 Emir İptal Mesajı..........................................................................................................3-333.1.3.2 Emir İptal Cevap Mesajı...............................................................................................3-343.1.3.3 Emir İptal Hata Mesajı..................................................................................................3-35

3.1.4 Yeni Kotasyon Giriş.............................................................................................................3-353.1.4.1 Yeni Kotasyon Giriş Mesajı.........................................................................................3-363.1.4.2 Yeni Kotasyon Giriş Cevap Mesajı..............................................................................3-383.1.4.3 Yeni Kotasyon Giriş Hata Cevabı................................................................................3-39

3.1.5 Kotasyon Değiştirme............................................................................................................3-403.1.5.1 Kotasyon Değiştirme Mesajı........................................................................................3-403.1.5.2 Kotasyon Değiştirme Cevap Mesajı.............................................................................3-413.1.5.3 Kotasyon Değiştirme Hata Mesajı................................................................................3-42

3.1.6 Terminal Durum Güncelleme...............................................................................................3-433.1.6.1 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Mesajı..................................3-433.1.6.2 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Cevap Mesajı.......................3-433.1.6.3 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Hata Mesajı..........................3-44

3.2 Sorgu (Inquiry) İstek ve Cevap Mesajları....................................................................................3-443.2.1 Emir Durum Sorgusu............................................................................................................3-44

3.2.1.1 Emir Durum Sorgusu Mesajı........................................................................................3-443.2.1.2 Emir Durum Sorgusu Cevap Mesajı.............................................................................3-453.2.1.3 Emir Durum Sorgusu Hata Mesajı...............................................................................3-46

3.2.2 Biriken Mesajları Üye Sistemine İndirme Mesajı................................................................3-463.2.2.1 Biriken Mesajları Üye Sistemine İndirme Mesajı........................................................3-463.2.2.2 Biriken Mesajları Üye Sistemine İndirme Cevap Mesajı (senkron kanaldan).............3-473.2.2.3 Biriken Mesajları Üye Sistemine İndirme Cevap Mesajları (asenkron kanaldan).......3-483.2.2.4 Biriken Mesajları Üye Sistemine İndirme Hata Mesajı................................................3-49

3.3 İstek Red Mesajları.......................................................................................................................3-493.3.1 İstek Red Bilgisi...................................................................................................................3-49

3.3.1.1 İstek Red Bilgisi Mesajı...............................................................................................3-493.4 Bilgi Mesajları..............................................................................................................................3-51

3.4.1 İşlem Bilgisi..........................................................................................................................3-513.4.1.1 İşlem Bilgisi Mesajı......................................................................................................3-513.4.1.2 İşlem Özet Bilgisi.........................................................................................................3-53

3.4.2 Emir İptal Bilgisi Mesajı......................................................................................................3-543.4.3 Kotasyon Güncelleme Bilgisi...............................................................................................3-563.4.4 Temsilci İşlemleri Bilgilendirme Mesajları..........................................................................3-57

3.4.4.1 Temsilci Emir Giriş Mesajı..........................................................................................3-573.4.4.2 Temsilci Emir Değiştirme Mesajı.................................................................................3-583.4.4.3 Temsilci Emir İptal Mesajı...........................................................................................3-593.4.4.4 Temsilci Gerçekleşen İşlem Mesajı..............................................................................3-603.4.4.5 Temsilci Kotasyon Giriş Mesajı...................................................................................3-613.4.4.6 Temsilci Kotasyon Güncelleme Mesajı........................................................................3-62

3.4.5 Genel Yayın Mesajı..............................................................................................................3-623.4.6 ExAPI Durum Bilgisi Mesajı...............................................................................................3-78

4. İŞLETİM AKIŞI VE ZAMANLAMALARI..................................................4-78

5. MESAJLAŞMA SORUNLARI.......................................................................5-795.1 Sorgulara Yanıt Alınamaması......................................................................................................5-805.2 İnteraktif Bağlantının Kopması....................................................................................................5-805.3 Mesaj Dosyasının Bozulması.......................................................................................................5-815.4 Genel Yayın Mesajının Kaybolması.............................................................................................5-81

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 4

Page 6: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

EkranlarEkran 1 ExAPI Yönetim Ekranı – İlk Çalıştırma....................................................................................2-8

Ekran 2 ExAPI Yönetim Ekranı (Senkron kanal açık)...........................................................................2-9

Ekran 3 ExAPI Yönetim Ekranı (Senkron ve asenkron kanallar açık)...............................................2-10

Ekran 4 Senkron ve asenkron kanallar ile ExAPI uygulaması çalışıyor.............................................2-12

Ekran 5 Kullanıcı Terminali ExAPI Temsilci Giriş Ekranı.................................................................2-12

Ekran 6 Kullanıcı Terminali Piyasa İzleme Ekranı...............................................................................2-13

Ekran 7 Kullanıcı Terminali Yardımcı Menü Ekranı............................................................................2-14

Ekran 8 Kullanıcı Terminali ExAPI Mesaj İzleme Ekranı...................................................................2-15

Ekran 9 Kullanıcı Terminali Mesaj İzleme Ekranı – (örnek) -.............................................................2-16

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 5

Page 7: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

1. GİRİŞ

1.1 Dökümanın AmacıBu dökümanın amacı, Borsa İstanbul Pay Piyasası Elektronik Alım-Satım Sistemi ile üyelerin merkezi sistemlerini elektronik bir altyapı, iletişim protokolü ve kullanım yöntemi (Borsa İstanbul ExAPI) ile bağlamak , üyelerin bu yapı vasıtasıyla emir işlemlerini (giriş, düzeltme, iptal, durum sorgusu, vb.) elektronik ortamda yürütebilmelerini sağlamak için oluşturulan yapıyı, bu yapı üzerinde uygulama geliştirecek olan programcılara tanıtmaktır.

1.1.1 Dökümanın Kullanımı

Bu döküman 4 bölüme ayrılmıştır.

Bölüm 1 giriş bölümüdür. Burada dökümanın amacı ve Borsa İstanbul ExAPI ile iletişim kuracak programları yazacak olan programcılara yönelik gereksinim tanımları yer almaktadır.

Bölüm 2 Borsa İstanbul ExAPI’nin genel işleyişi ve ihtiyaç duyulan altyapı hakkında bilgileri içerir.

Bölüm 3 Borsa İstanbul ExAPI içerisinde yer alan mesaj tiplerinin ayrıntılı açıklama ve tanımlarını içerir. Her mesaj tanımı; mesajın alanlarının bir listesini verir ve her alanın anlamını ve işlevini açıklar. Bu bölümde her mesaj tipi ayrı bir alt başlık altında belirtilmiştir.

Bölüm 4 genel işletim akışını tarif eder.

1.2 Hedef KitleBu döküman, Borsa İstanbul ExAPI’nin sağladığı mesaj formatlarını ve iletişim yöntemini kullanarak, üye sistemleri ile Borsa İstanbul Pay Piyasası Temsilci Ekranı bilgisayarı (Borsa İstanbul ExAPI PC) arasında mesaj alışverişi amaçlı programlama yapacak sistem analistleri ve programcılara yöneliktir.

1.2.1 Uygulama Programcısının Bilmesi Gerekenler

Borsa İstanbul ExAPI ile programlama yapabilmek için aşağıdaki alanlarda bilgi ve deneyim sahibi olmak gereklidir:

İstemci-Sunucu yapı hakkında bilgi.

Soket programlama bilgisi.

Multi-tasking programlama ve inter-process communication (IPC) bilgisi.

2. GENEL YAPI VE İŞLEYİŞBorsa İstanbul ExAPI, Borsa İstanbul üyelerinin, Borsa İstanbul Pay Piyasası’na erişimlerinin otomasyonu ve elektronik olarak emir iletimlerinin sağlanması amacıyla, varolan Pay Piyasası Temsilci Ekranı üzerinde, üyelerin sistemlerinden gönderilen mesajları kabul edip, Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne (İşlem Sistemi) gönderim imkanını sağlar.

Borsa İstanbul ExAPI, üyelerin merkezi sistemleri ile Borsa İstanbul Pay Piyasası Alım Satım Sistemi (İşlem Sistemi) arasında emir işlemlerinin iletimini sağlayan bir mesajlaşma arayüzüdür. Bu arayüz, üye sistemi ile Pay Piyasası Temsilci Ekranı (Borsa İstanbul ExAPI PC) arasındaki iletişim yöntemlerini ve mesaj yapılarını belirler.

Üye, kendi müşterilerinden topladığı emirleri, network üzerinden, TCP/IP protokolüyle ve socket programlama ile, Borsa İstanbul ExAPI PC’ye iletir. Borsa İstanbul ExAPI PC, ilgili mesajı İşlem Sistemi’ne gönderir ve İşlem Sistemi’nden aldığı cevap mesajına göre sonucu üye sistemine aynı şekilde geri döndürür.

Bu dökümanda, Borsa İstanbul ExAPI’nin iletişim yöntemlerinin ve kullanılan mesaj formatlarının tanımlamaları yapılmaktadır.

2.1 İletişim Yöntemleri

2.1.1 İletişim Modu ve Ayarlar

Üye Sistemi ile Borsa İstanbul ExAPI PC arasında TCP/IP altyapısının ve socket programlamanın kullanıldığı çift yönlü bir iletişim yapısı bulunmaktadır. Borsa İstanbul ExAPI, Üye Sistemi ile arasındaki veri iletimini her biri ayrı bir soket üzerinden çalışan iki ayrı kanal vasıtasıyla yapmaktadır.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 6

Page 8: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Bu kanallardan birincisi (bundan sonra senkron kanal olarak anılacaktır), yeni emir girişi, emir düzeltme, emir iptal, emir durum sorgusu gibi isteklerin yapıldığı, gönderilen mesajın cevabının ya da gönderim onayının aynı işlem kapsamında geri döndürüldüğü senkron işlemlerin yürütüldüğü kanaldır. Senkron kanal için kullanılacak port değeri c:\winnt\tcam.ini (ya da c:\windows\tcam.ini) dosyası içinde “[ISECTDR]” bölümündeki “APIRECVPORT” alanından alınacaktır.

İkinci kanal ise (bundan sonra asenkron kanal olarak anılacaktır), Üye Sistemi tarafından gönderilen mesajların bir sonucu olarak (işlem bilgisi gibi) zaman içerisinde oluşan işlem bilgilerinin Borsa İstanbul ExAPI tarafından üye sistemine gönderildiği kanaldır. Asenkron kanal için kullanılacak port değeri c:\winnt\tcam.ini (ya da c:\windows\tcam.ini) dosyası içinde “[ISECTDR]” bölümündeki “APISENDPORT” alanından alınacaktır.

APISENDPORT ve APIRECVPORT değerlerinin üye sistemindeki herhangi bir port değeri ile çakışmaması gerekmektedir. Aksi halde, yukarıda bahsedilen ayar dosyası açılarak ilgili değerler değiştirilmelidir.

Üye sisteminin IP adres değeri değeri c:\ winnt\tcam.ini (ya da c:\windows\tcam.ini) dosyası içinde “[ISECTDR]” bölümündeki “MEMBERIP1” alanına yazılacaktır. “MEMBERIP2” şimdilik kullanılmadığı için bu alana herhangi bir değer girilmeyecektir.

Örneğin, bir emir gönderildiğinde sistem, senkron kanaldan

“Y 00010000000002 10:16:40 EMİR 2006200000000509 ALIŞ 100 ANHYT.E 2.8 MÜŞ 12345678 GÜN İSTENDİ” şeklinde bir cevap mesajı gönderir. Asenkron kanaldan ise - eğer emir işleme girmişse- “S 00010000000003 10:16:45 ALINDI. LMT 100 ANHYT.E 2.8 MÜŞ 2006200000000509 52371 KARŞILANDI GÜN” şeklinde bir cevap mesajı gönderir.

Her iki kanal üzerindeki iletişim de TCP point-to-point bağlantı ile gerçekleştirilir.

Üye sistemi ile Borsa İstanbul ExAPI PC arasında bağlantı kurulması ile ilgili yukarıda anlatılan değerler, uygulamalar (isectdr.exe, exapirx.exe ve exapitx.exe) çalıştırılmadan önce c:\winnt (ya da c:\windows) dizini altında yer alan “tcam.ini” dosyasındaki “[ISECTDR]” bölümüne aşağıdaki örnekte olduğu gibi girilmelidir.

Örnek

[ISECTDR]APIRECVPORT = 8001APISENDPORT = 8002MEMBERIP1 = 10.36.1.79

Not: ExAPI PC’nin IP adresi, “ipconfig” komutu çalıştırılarak öğrenilebilir.

2.1.2 Genel Bilgiler ve İş Akışı

2.1.2.1 Pay Piyasası API Başlatma İşlemleri

Borsa İstanbul ExAPI vasıtasıyla elektronik olarak Pay Piyasası Alım Satım Sistemi’ne (İşlem Sistemi) bağlanmak için;

1. Öncelikle ExAPI Yönetim Ekranı (ExAPI programlarının yönetimini sağlayan uygulama arayüzü) çalıştırılır (XAPIFACE.EXE). Bu uygulama ExAPI uygulaması bileşenlerini (ISECTDR.EXE, EXAPIRX.EXE ve EXAPITX.EXE programları) çalıştırıp, kapatmaya yarayan grafik bir arayüzdür. Uygulama ilk çalıştırıldığında aşağıdaki görünümde olmalıdır (Ekran 1). ExAPI programlarının belirli bir sırada çalıştırılması gerekmektedir. Bu sıra, senkron kanalın açılması, asenkron kanalın açılması ve XAPI uygulamasının başlatılması şeklindedir. Programlar çalıştırılırken bu sıraya uymaya dikkat edilmelidir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 7

Page 9: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Ekran 1 - ExAPI Yönetim Ekranı – İlk ÇalıştırmaYukarıdaki ekran, üç bölümden oluşur. Birincisi ExAPI uygulamalarını açıp kapamaya yarayan “AÇ / KAPA” bölümü, ikincisi bileşenlerin son durumunu ( çalışıp çalışmadığını ) gösteren ve beşyüz(500) milisaniyelik zaman aralıklarıyla güncellenen “ÇALIŞIYOR” bölümü ( Not : Bu bölümdeki butonlar sadece gösterim amaçlıdır, üzerilerine basılması herhangi bir etkiye sebep olmaz ) ve üçüncüsü bileşenlerin çalışma bilgilerini sabit diskteki dosyalarda tutan “BİLGİLER” bölümüdür.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 8

Page 10: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

2. “SENKRON KANALI AÇ” butonuna basılarak senkron kanalı ayağa kaldıracak uygulama çalıştırılır. Bu yeni durumda ExAPI Yönetim Ekranı’nın görünümü aşağıdaki gibi olmalıdır. (“SENKRON KANALI AÇ” butonu pasif, “SENKRON KANALI KAPAT” butonu aktif, “ASENKRON KANALI AÇ” butonu aktif, “ASENKRON KANALI KAPAT “ butonu pasif, “API UYGULAMASINI BAŞLAT” butonu aktif, “API UYGULAMASINI BİTİR”butonu pasif ve “ÇALIŞIYOR” bölümündeki RX butonu aktif durumdadır.) Bu aşamada “SENKRON KANALI KAPAT” butonuna basılıp bir önceki duruma geri dönülebilir. Ancak senkron kanal bağlantısı kurulmamış ise, senkron kanalın kapatılamayacağına dair bir mesaj alınır.

Ekran 2 - ExAPI Yönetim Ekranı (Senkron kanal açık)

3. “ASENKRON KANALI AÇ” butonuna basılarak, aseknron kanalı ayağa kaldıracak uygulama çalıştırılır. Bu yeni durumda ExAPI Yönetim Ekranı aşağıdaki gibi olmalıdır ( “SENKRON KANALI AÇ” butonu pasif, “ASENKRON KANALI AÇ” butonu pasif, “API UYGULAMASINI BAŞLAT” butonu aktif ve “ÇALIŞIYOR” bölümündeki “RX” ve “TX” butonları aktif durumdadır). Bu aşamada “ASENKRON KANALI KAPAT” butonuna basılıp bir önceki duruma geri dönülebilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 9

Page 11: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Ekran 3 - ExAPI Yönetim Ekranı (Senkron ve asenkron kanallar açık)

4. “API UYGULAMASINI BAŞLAT” butonuna basılarak ExAPI programı çalıştırılır. Bu yeni durumda ExAPI Yönetim Ekranı aşağıdaki gibi olmalıdır. (“SENKRON KANALI AÇ” butonu pasif, “ASENKRON KANALI AÇ” nutonu pasif, “API UYGULAMASINI BAŞLAT” butonu pasif, “API UYGULAMASINI BİTİR” butonu aktif, “ASENKRON KANALI KAPAT” butonu aktif ve “SENKRON KANALI KAPAT” butonu ile “ÇALIŞIYOR” bölümündeki “RX”, “TX” ve “TCAM” butonları aktif durumdadır.) Bu aşamada “API UYGULAMASINI BİTİR” butonuna basıp bir önceki duruma geri dönülebilir. Artık, ExAPI uygulaması bütün bileşenleri ile çalışır durumdadır. Ancak üye sisteminden gelecek bağlantı isteklerini karşılayacak konumda değildir. Bunun için aşağıdaki işlemlerin gerçekleştirilmesi gereklidir. Ayrıca uygulamalar nizami bir şekilde kapatılmış ise “BİLGİLER” bölümündeki butonları kullanarak senkron kanal, asenkron kanal ile ilgili çalışma bilgilerini (asenkron ve senkron kanalların log dosyaları) WORDPAD metin editöründe görülebilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 10

Page 12: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Ekran 4 - Senkron ve asenkron kanallar ile ExAPI uygulaması çalışıyor

5. Borsa İstanbul ExAPI PC’si ExAPI Yönetim Ekranı’ndan açıldıktan sonra gelen “login” ekranına kullanıcı kodu ve şifresi yazılarak Borsa İstanbul ExAPI PC’nin İşlem Sistemi’ne bağlanması sağlanır. (Halen Pay Piyasası Alım Satım Sistemi’ne erişim için kullanılan önyüz yazılımının bir versiyonu olan kullanıcı ekranının İşlem Sistemi’ne bağlanma işlemi olarak da ifade edilebilir.)

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 11

Page 13: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Ekran 5 Kullanıcı Terminali ExAPI Temsilci Giriş Ekranı

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 12

Page 14: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

6. Borsa İstanbul ExAPI PC’nin İşlem Sistemi’nden ilk bilgi yükleme (download) işlemi bittikten sonra, ekrana piyasa ile ilgili bilgiler gelir.

Ekran 6 Kullanıcı Terminali Piyasa İzleme Ekranı

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 13

Page 15: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

7. Bu aşamadan sonra, “MENU” tuşuna basılmak suretiyle Menü ekranına girilir. Gelen ekrandan “API Bağlantısı” seçilir.

Ekran 7 Kullanıcı Terminali Yardımcı Menü Ekranı

8. Bu seçeneğin seçilmesi ve açılan ekrandan “API Başlat” butonuna basılması suretiyle Borsa İstanbul ExAPI uygulamasındaki ExapiRx programı “senkron kanaldan istek kabul”, ExapiTx programı ise asenkron kanaldan “cevap gönderme” moduna girer. Ancak bu modlara giriş yapılması için üye sistemi tarafında çalışacak programların Borsa İstanbul ExAPI PC’si üzerine çalışan ExapiRx ve ExapiTx programlarına bağlantılarını sağlamış (accept-connect) olmaları gerekmektedir. Başka bir ifadeyle, sunucu durumunda olan ExAPI PC’sinde çalışan programlara, istemci durumunda olan üye tarafındaki programların “connect” olması lazımdır. Aksi halde kullanıcıyı uyarmak amacıyla “Üye sistemiyle Senkron bağlantı kurulmamış” ve “Üye sistemiyle Asenkron bağlantı kurulmamış” mesajlarından biri ya da her ikisi API Mesaj Listesi altında listelenir. Üye sistemi ve Borsa İstanbul ExAPI arasındaki mesajlaşma ExapiRx ve ExapiTx programları vasıtasıyla sağlanır. Bu programlar arka planda kalarak mesajlaşma işini yürütürler. Dolayısıyla bu pencerelerin normal çalışma sırasında kapatılmaması gereklidir.Bu noktadan itibaren Borsa İstanbul ExAPI PC, Üye Sistemi’nden gelecek olan bağlantı isteklerini karşılamaya hazırdır. (Sunucu’nun hazır olması) “API Başlat” butonuna basılmaması durumunda, Üye Sistemi’yle mesajlaşma başlayamayacağından dolayı ExAPI PC’si Üye Sistemi’nden gönderilen hiçbir isteğe cevap veremeyecektir. Bu ekranda “Vazgeç/Kapat” butonuna basılması durumunda, Borsa İstanbul ExAPI uygulaması sona erer ve PC normal “Temsilci Ekranı” durumuna (tüm isteklerin PC’den klavye kullanılarak yapıldığı durum) geri döner.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 14

Page 16: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Ekran 8 Kullanıcı Terminali ExAPI Mesaj İzleme Ekranı

9. Yukarıdaki işlemin de tamamlanmasını takiben, Üye Sistemi ile Borsa İstanbul ExAPI PC’si arasında mesajlaşma başlayabilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 15

Page 17: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

10. Bu ekranda iken Mesajları Kaydet butonuna basıldığında o ana kadar “API Mesaj Listesi” alanında listelenen bilgiler c:\tcam dizini altına “ggaayylg.üyekodu” (örneğin 260800AP.IYM) formatıyla kaydedilir. “API Mesaj Listesi” altına eklenen mesajların log dosyasına kaydı ExAPI çalışması tamamen sona erdirildikten sonra yapılmalıdır.

Ekran 9 Kullanıcı Terminali Mesaj İzleme Ekranı – (örnek) -

Üye Sistemi üzerindeki Borsa İstanbul ExAPI ile iletişim kuran programlarda dikkat edilmesi gereken en önemli nokta; Borsa İstanbul ExAPI uygulamasının senkron ve asenkron kanallardan gelecek bağlantı isteklerini beklediği ( accept ) ve her iki kanal için de bağlantı isteklerinin Üye Sistemi programları tarafından yapılması ( connect ) gerektiği dir. Bu iki kanal üzerinden bağlantı kurulduktan sonra herhangi birinin kopması durumunda, üye sistemi tüm bağlantıları tekrar kurmalıdır.

2.1.2.2 Pay Piyasası ExAPI İletişim Akışı

Üye ile Borsa İstanbul ExAPI arasında TCP/IP altyapısının kullanıldığı çift yönlü bir iletişim bulunmaktadır. Borsa İstanbul ExAPI, Üye Sistemi ile arasındaki veri iletimini iki ayrı kanal vasıtasıyla yapmaktadır.

Senkron kanal, Yeni Emir Girişi, Emir Düzeltme, Emir İptal, Emir Durum Sorgusu gibi, gönderilen mesajın cevabının aynı işlem kapsamında geri döndürüldüğü senkron işlemlerin yürütüldüğü kanaldır. Bu kanal vasıtasıyla yapılan işlemlerde, gönderilmiş olan mesajın cevabı üye sistemine geri döndürülmedikçe başka bir mesaj gönderimi yapılamaz. Aksine bir işletim sözkonusu olduğunda, oluşabilecek bilgi ve zaman kayıplarından üye sorumludur.

Senkron Kanalın İşleyişi

Senkron Kanal üzerindeki gönderim yöntemi, aşağıda gösterilmiştir:

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 16

Page 18: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Senkron Kanal üzerindeki işletim akışı Yeni Emir Girişi için aşağıda verilmiştir:

(1) Üye Sistemi, Yeni Emir Giriş mesajını senkron kanal üzerinden Borsa İstanbul ExAPI’nin üzerinde çalışmakta olduğu PC’ye gönderir.

(2) Üye Sistemi, Borsa İstanbul ExAPI PC’den Yeni Emir Giriş Cevap mesajını beklemeye başlar.

(3) Borsa İstanbul ExAPI PC üyeden aldığı mesajı Borsa İstanbul’daki İşlem Sistemi’ne iletir.

(4) Borsa İstanbul İşlem Sistemi, mesajın cevabını Borsa İstanbul ExAPI PC’ye geri döndürür.

(5) İşlem Sistemi tarafından bu mesajın cevabı Borsa İstanbul ExAPI PC’ye ulaştığında, Borsa İstanbul ExAPI, Yeni Emir Giriş mesajı ile gönderilmiş olan emre ait Yeni Emir Giriş Cevap mesajını senkron kanal üzerinden Üye Sistemi’ne gönderir.

Senkron kanal üzerinden gönderilecek başka mesaj varsa, (1) ’den itibaren tüm işletim bu yeni mesaj için yinelenir.

Senkron kanaldan gönderilebilecek mesaj tipleri aşağıda verilmiştir:

Üye Sistemi Borsa İstanbul ExAPI Mesaj Tipi Borsa İstanbul ExAPI Üye Sistemi Cevap Mesajı TipiYeni Emir Girişi Emir Giriş CevapKotasyon Girişi Kotasyon Giriş CevapEmir Değiştirme Emir Değiştirme CevapKotasyon Değiştirme Kotasyon Değiştirme Cevap

CevapEmir İptal Emir İptal CevapEmir Durum Sorgusu Emir Durum Sorgusu CevapTerminal Durum Güncelleme Terminal Durum Güncelleme CevapBiriken Mesajları Üye Sistemine İndirme Biriken Mesajları Üye Sistemine İndirme Cevap

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 17

Page 19: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Örneğin; bir Yeni Emir Girişi mesajı gönderildiğinde, bu emirle ilişkili olarak durum bilgisinin gönderildiğini (“emir kabul edildi” gibi) içeren Emir Giriş Cevap mesajını beklemek gereklidir. Bu mesaj üye sistemine ulaşmadan, üye sisteminin ikinci bir mesaj göndermesi durumunda, ikinci gönderilen mesaj Borsa İstanbul ExAPI tarafından işlenmeyebilir ya da Emir Giriş Cevap mesajının üye sistemi tarafından alınıp işlenmesinde sorun yaşanabilir.

Asenkron Kanalın İşleyişi

Asenkron kanal ise, üye sistemi tarafından gönderilen mesajların bir sonucu olarak zaman içerisinde oluşan durumu (işlem bilgileri, süresi dolan emirlerle ilgili iptal bilgileri, vb. ) bildirmek amacıyla İşlem Sistemi tarafından üretilen mesajların Borsa İstanbul ExAPI tarafından üye sistemine gönderildiği kanaldır.

Asenkron kanal üzerindeki gönderim yöntemi aşağıda verilmiştir:

Asenkron Kanal üzerindeki işletim akışı aşağıda belirtilmiştir:

(1) Üyenin gönderidği mesajın cevabı (örneğin; üye tarafından girilen bir emrin taraf olduğu bir işlem gerçekleştiğinde oluşan cevap), İşlem Sistemi tarafından Borsa İstanbul ExAPI PC’ye ulaşır.

(2) Borsa İstanbul ExAPI PC’si, bu bilgiyi İşlem Bilgisi mesajı ile asenkron kanal üzerinden Üye Sistemi’ne gönderir.

(2) Üye Sistemi, İşlem Bilgisi mesajını alır.(İşlem Bilgisi mesajları herhangi bir anda Borsa İstanbul ExAPI PC’den gelebilir. Üye Sistemi bu duruma uygun olarak, her an bu mesajı alabilecek şekilde hazır beklemelidir.)

Asenkron kanal üzerinden gönderilecek başka mesaj varsa, (1) ’den itibaren tüm işletim bu yeni mesaj için yinelenir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 18

Page 20: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Bu duruma bir örnek olarak, Emir Giriş mesajı ile girilen ve İşlem Sistemi’ne kabul edildiği Emir Giriş Cevap mesajı ile alınmış olan ve pasife yazılmış olan bir emir, bir süre sonra bir aktif emir ile eşleşerek bir sözleşme oluşturabilir. Bu emire ve oluşturduğu sözleşmeye ait bilgiler, Borsa İstanbul ExAPI tarafından Gerçekleşen İşlem Bilgisi mesajı ile ikinci kanaldan üye sistemine gönderilir.

Üye, asenkron kanal üzerinden; herhangi bir anda, tanımlı olan herhangi bir cevabı alabilecek durumda hazır olmalıdır. Borsa İstanbul ExAPI PC’den gelen mesaj içerisindeki mesaj tipini ayırt ederek ilgili mesaja göre uygun “veri parçalaması” işlemlerini gerçekleştirmelidir.

Asenkron kanaldan üye sistemine gönderilebilecek mesaj tipleri aşağıda verilmiştir:

Borsa İstanbul ExAPI Üye Sistemi Mesaj TipiGerçekleşen İşlem BilgisiKotasyon Güncelleme Bilgisiİstek Red BilgisiGönderilen biriken mesajları üye sistemine indirme isteğine göre aşağıdaki mesaj tipleri döner: Emir Giriş Cevap Kotasyon Giriş Cevap Emir Değiştirme Cevap Kotasyon Değiştirme Cevap Emir İptal Cevap İşlem Bilgisi Kotasyon Güncelleme İptal Bilgisi İstek Red BilgisiBaşka bir kullanıcı tarafından değiştirilen/ ya da iptal edilen emirlere karşılık emirin sahibi olan kullanıcıya aşağıdaki mesaj tipleri döner: Emir Değiştirme Cevap Kotasyon Değiştirme Cevap Emir İptal CevapTemsilci terminallerinden yapılan işlemler yetkilendirilmiş ExAPI’ye aşağıdaki mesajlarla gönderilir : Temsilci Emir Giriş Mesajı Temsilci Emir Değiştirme Mesajı Temsilci Emir İptal Mesajı Temsilci Gerçekleşen İşlem Mesajı Temsilci Kotasyon Giriş Mesajı Temsilci Kotasyon Güncelleme Mesajı

Genel yayın (broadcast/multicast) mesajlarıİşlem Özeti Bilgisi

2.1.2.3 Pay Piyasası ExAPI İletişim Altyapısıİletişim Modu TCP/IP Altyapısı Üzerinde Çift Yönlü.İletişim Altyapısı Pay Piyasası için 10/100Mbit Ethernet.İletişim Karakteristikleri

10/100Mbit değişebilir Ethernet Altyapısı.(Şu anda 10 Mbit Ethernet kullanılmaktadır.)Veri, Borsa İstanbul ExAPI ile Üye Sistemi arasında “unicast” yöntemi ile gönderilir.

2.2 Mesaj TipleriBorsa İstanbul ExAPI mesajları işlem tipi ve ilgili işleme yönelik mesaj verisinden oluşur. Mesaj içerisindeki veriler birbirlerinden birer boşluk karakteri ile ayrılmış halde bulunurlar. Mesaj verisi içerisinde yer alan alanlardan bazıları sabit uzunluklu olup, ilgili mesaj tanımlarında belirtilen şekilde doldurulurlar. Bazı alanlar ise değişken uzunluklu olup, bu alanlara ait bilgileri elde etmek için takip eden ilk boşluk ya da tab karakterine kadar olan bilgiyi bu alana ait bilgi olarak ayırmak gereklidir.

Borsa İstanbul ExAPI, dört ana mesaj tipine sahiptir:

İstek Mesajı - Yeni emir girişi, emir düzeltme, kotasyon girişi, kotasyon değiştirme gibi İşlem Sistemi’ne mesajda belirtilen işi yapması için gönderilen mesajlardır. Senkron kanal üzerinde yapılan bir işlem (transaction) başlatan mesaj tipidir. Dolayısıyla bu isteğe karşılık mutlaka bir istek cevap mesajının geri dönmesi beklenmelidir. Gönderilen isteğe olumlu ya da olumsuz bir yanıt gelmesiyle ilgili iş (transaction) tamamlanmış olur.

Borsa İstanbul ExAPI İstek Mesajları aşağıda belirtilmiştir:

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 19

Page 21: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

1. Yeni Emir Girişi2. Kotasyon Girişi3. Emir Değiştirme4. Kotasyon Değiştirme5. Emir İptal6. Emir Durum Sorgusu7. Biriken Mesajları Üye Sistemi’ne İndirme8. Terminal Durum Güncelleme

İstek Cevap Mesajı - Yeni emir girişi, emir düzeltme, , kotasyon girişi, kotasyon değiştirme gibi İstek Mesajlarının ExAPI PC’si tarafından işlenirken (mesaj formatının kontrol edilmesi, alanların içeriklerinin kontrol edilmesi, vs.) bu isteğin sonucuna ait bilginin Üye Sistemi’ne geri döndürüldüğü mesaj tipidir. Senkron kanal üzerinde yapılan bir iş (transaction) bu mesaj tipi ile sonlandırılır. Burada PC tarafından yapılan kontroller sırasında, ilgili istekte herhangi bir hata varsa (örn. marj dışında kalan fiyat, adım hatası, vs.) Üye Sistemine giden yanıt hata bilgisini içerir. İstek Mesajında hatalı bir kayıt yok ve dolayısıyla istek İşlem Sistemi tarafından kabul edilmiş olduğu durumda ise Üye Sistemine giden yanıt isteğin kabul edildiği bilgisini içerir. İlgili isteğin işleme girmesi neticesinde oluşan mesaj ise “bilgi mesajı” bölümünde anlatılmaktadır.

Borsa İstanbul ExAPI İstek Cevap Mesajları aşağıda belirtilmiştir:1. Yeni Emir Girişi Cevap2. Kotasyon Girişi Cevap3. Emir Değiştirme Cevap4. Kotasyon Değiştirme Cevap5. Cevap6. Emir İptal Cevap7. Emir Durum Sorgusu Cevap8. Biriken Mesajları Üye Sistemi’ne İndirme Cevap9. Terminal Durum Güncelleme Cevap

İstek Red Mesajı - Yeni emir girişi, emir değiştirme, emir iptal, kotasyon girişi, kotasyon değiştirme gibi İstek Mesajlarının ExAPI PC’si ve İşlem Sistemi tarafındaki kontrollerden geçip sisteme kabul edildikten sonra, İşlem Sistemi tarafından işlenmesi sırasında, söz konusu isteğin yerine getirilmeyeceğinin Üye Sistemi’ne bildirildiği mesaj tipidir. Borsa İstanbul ExAPI İstek Red Mesajları aşağıda belirtilmiştir:

1. İstek Red Bilgisi Bilgi Mesajı - Daha önce bir İstek Mesajı (yeni emir girişi, emir değiştirme, emir iptal, kotasyon girişi, kotasyon

değiştirme vb.) ile İşlem Sistemi’ne gönderilmiş ve ilgili İstek Cevap Mesajı ile İşlem Sistemi’ne kabul edildiği bilgisi alınmış olan bir mesajın sonucunda oluşan bilginin (emirin işleme girmesi, emir iptal isteğinin gerçekleşmesi, vb.) İşlem Sistemi tarafından gönderildiği mesaj tipidir. Bunun yanında seans sonu işlemlerinde emirlerin süresinin bitimi nedeniyle ilgili emirin iptali ya da emirin sistem tarafında kontrol kullanıcıları tarafından iptali nedeniyle oluşan iptal mesajları da bu bilgi mesajının kapsamında yer alırlar.Borsa İstanbul ExAPI Bilgi Mesajları aşağıda belirtilmiştir:

1. Gerçekleşen İşlem Bilgisi2. Emir İptal Edildi Bilgisi (kullanıcı isteği)3. Emir İptal Edildi Bilgisi (süresi biten emir, kontrolden iptal edilen emir) (kullanıcı harici)4. Kotasyon Güncellendi Bilgisi5. Temsilci Emir Giriş Mesajı6. Temsilci Emir Değiştirme Mesajı7. Temsilci Emir İptal Mesajı8. Temsilci Gerçekleşen İşlem Mesajı9. Temsilci Kotasyon Giriş Mesajı10. Temsilci Kotasyon Güncelleme Mesajı11. Genel Yayın Mesajı12. İşlem Özeti Bilgisi

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 20

Page 22: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

2.3 Mesaj İletim HızıBurada mesaj iletim hızıyla anlatılmak istenen ExAPI PC’sinin birinci istek aldıktan (t1) ve Borsa İstanbul ana işlem sistemine gönderdikten sonra ikinci bir istek mesajının (t2) ne kadar süre sonra alınabileceğidir. İstek mesajlarının iletim hızı ExAPI PC’leri üzerinde yapılacak versiyon güncellemeleriyle gerçekleştirilecektir. Bu mesajların Borsa İstanbul seans saatleri içinde aktarım hızı, o anda açık olan seansa (1. Seans, 2. Seans, Açılış Seansına) bağlı olarak değişiklik gösterebilecektir. Aşağıdaki formül yukarıda anlatılan durumu izah etme açışından yararlı olacaktır. Tüm zaman değerleri milisaniye olarak hesaplanmaktadır.

t2 = t1 + tsistem + tbekleme (tsistem < = tsabit)t2 = t1 + tsistem (tsistem > tsabit)

t1 : Birinci isteğin ExAPI PC’si tarafından alındığı zaman değeri,t2 : İkinci isteğin ExAPI PC’si tarafından alındığı zaman değeri,tsistem : Borsa İstanbul ana işlem sistemi tarafından birinci istek mesajına karşılık olarak gönderilen yanıtın ExAPI PC’si

tarafından ne kadar süre sonra alındığı (sistemden ve iletişim altyapısından kaynaklanan tüm süre bu değer ile ifade edilmektedir),

tsabit : ExAPI PC’sinde tanımlı iki istek mesajı arası en az bekleme süresi,tbekleme : İkinci istek mesajının ExAPI PC’sine kabul edilebilmesi için ne kadar ilave bir süre bekleneceğini

gösterir. Borsa İstanbul ana işlem sisteminin yanıt verme süresi t sabit değerini aşarsa tbekleme süresi sıfır olarak hesaba katılır.

Yukarıdaki durumu örneklerle açıklamak gerekirse tsabit değerinin 200 milisaniye olduğu (saniyede en fazla 5 emir) ExAPI PC’sinden gelen istek mesajına Borsa İstanbul ana işlem sistemi, 150 milisaniye sonra cevap vermişse (t sistem), tbekleme süresi 50 milisaniye olacak ve yanıt mesajı senkron kanaldan gönderildikten sonra ikinci ikinci mesaj 50 milisaniye beklenerek kabul edilecektir. Ancak Borsa İstanbul ana işlem sistemi istek mesajına 250 milisaniye sonra cevap vermişse, senkron kanaldan ikinci istek mesajını kabul etmek için ilave bir süre beklenmeyecek birinci istek için cevap mesajı üye sistemine gönderilir gönderilmez ikinci istek mesajı ExAPI PC’sine alınacaktır.

Borsa İstanbul ana sisteminin istek mesajlarına yanıt verme süresi sistemdeki işlem yoğunluğuna bağlı olarak faklı değerler alabilir. Borsa İstanbul, ExAPI uygulamasının devreye alınmasıyla beraber API yoluyla istek mesajlarının ana sisteme iletim hızını belirlemekte serbesttir.

Üyeler Fon Pazarına saniyede 3 adede kadar emir gönderdikleri durumda aynı ExAPI’den Pay Piyasası’na gönderecekleri saniyedeki en fazla emir sayısında (ilgili kullanıcılar için önceden tanımlanmış) herhangi bir etkilenme olmayacaktır. Ancak bir kullanıcıdan sürekli fon emir gönderilmesi durumunda Pay Piyasası’na gönderilebilecek birim zamandaki emir sayısı farklılık gösterebilecektir.

3. MESAJ TANIMLARIBu bölüm, Üye Sistemi ile Borsa İstanbul ExAPI PC arasındaki iletişimde kullanılan mesaj tiplerinin açıklandığı bölümdür. Her mesaj tipinin kendi başlığı altında genel tanımı, alanlarının açıklamaları ve bu alanlar hakkındaki diğer ayrıntılı bilgileri yer alır.

Her mesaj tanımının bir adı vardır ve dökümanda bu isimlerle anılmışlardır.

Her mesajın formatı içerisinde yer alan alanların açıklandığı tabloların başlıkları aşağıdaki anlamları taşımaktadır:

Alan Adı: İlgili alanın adını belirtir.

Alan Türü: Alanın içerisindeki verinin tipini, uzunluğunu ve diğer format özelliklerini belirtir.

Zorunlu: Eğer bir alanın mesaj içerisinde doldurulması zorunlu ise bu kolonda ‘E’, değilse boşluk veya ‘H’ ibaresi bulunur.

Açıklama: Bu alanın açıklanması gereken başkaca bir özelliği varsa veya belirli değerleri alabiliyorsa, bunlar anlamları ile beraber bu kolonda belirtilir.

Girişi zorunlu olmayan alanlar –dökümanda aksi belirtilmedikçe tüm alanların doldurulması zorunludur- verilen tanımlarına uygun olarak hazırlanmalıdır. Örneğin, alfanümerik bilgi içeren bir alan, eğer boş bırakılacaksa, tanımına uygun sayıda boşluk karakteri ile doldurulmalıdır. Girişi zorunlu olmayan alanlar için, “alan türü” alanında tanımlanmış olan sayıda karakter tipi alanlar için “boşluk” karakteri bırakılması, nümerik alanlar için alan boyu kadar “0” (sıfır) yazılması gerekmektedir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 21

Page 23: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.1 İş (Transaction )İstek ve Cevap MesajlarıTüm istek mesajları kendilerine ait birer cevap mesajına sahiptir. Üye Sistemi, göndermiş olduğu bir istek mesajına karşılık gelen cevap mesajını Borsa İstanbul ExAPI PC’sinden almadan yeni bir istek mesajını kesinlikle göndermemelidir. Bir başka deyişle, Üye Sistemi, göndermiş olduğu istek mesajına karşılık bir cevap mesajı alarak işi (transaction) tamamlamalıdır. Aksi halde oluşabilecek veri kayıpları ve hatalar üye tarafında sorunlara neden olacak ve bu sorunlardan Borsa İstanbul sorumlu olmayacaktır.

3.1.1 Yeni Emir Giriş

3.1.1.1 Yeni Emir Giriş Mesajı

Bu mesaj ile üye, toplamış olduğu emirleri elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletebilir.

Açılış Seansı’nda (AS) Ulusal, İkinci Ulusal, Yeni Ekonomi, Gözaltı (sadece 2.seans açılış seansında), Kurumsal Ürünler Pazarı’nda ve Serbest İşlem Platformu’nda ve de Gelişen İşletmeler Piyasası’nda işlem gören E ve Y Özellik Kodlu menkul kıymetler için emir girilebilmektedir. Rüçhan Hakkı Kuponu (R), borsa Yatırım Fonları (F) varant ve sertifika işlem sırasına AS sırasında emir girilemez.

Seansın Açılış/Tek Fiyat bölümünde ve Sürekli Müzayede bölümünde yapılan pay bazındaki bir açılışta sadece AFE(Açılış Fiyatlı Emir) ve Normal Limit Fiyatlı Lot Emirler girilebilmektedir.

Tek Fiyat sisteminde işlem görecek paylarda Açılış sürecinde Açığa Satış emri kullanılamaz ancak Tek Fiyat bölümünde kullanılabilir. Açılış sürecine hiç girmeyen veya açılış sırasında kapanan işlem sıralarının Tek Fiyat sürecinde işleme açılması durumunda, bu paylarda o seans sadece bir kere fiyat belirlenir ve bu süreçte Açığa Satış emri kullanılabilir.

Kapanış Seansı, Kapanış Fiyatından İşlemler ve Tek Fiyattan İşlemler:

Kapanış Seansı, (17:33 – 17:38) normal seans sürecinden kalan -kotasyon hariç- tüm emirlerin de aktarılması suretiyle, belirlenmiş zaman dilimi boyunca yeni emirlerin herhangi bir eşleşme yapılmaksızın Sistem’e kabul edildiği ve bu süre sonunda en yüksek miktarda işlemin gerçekleşmesini sağlayan tek bir fiyat seviyesinin (Kapanış Seansı Fiyatı) hesaplanarak, tüm işlemlerin bu fiyat seviyesinden gerçekleştirildiği tek fiyat yöntemiyle çalışan özel bir seans uygulamasıdır. Pay Piyasası’nda sürekli müzayede ve piyasa yapıcılı sürekli müzayede yöntemi ile işlem görmekte olan, varant, sertifika ve borsa yatırım fonları haricindeki menkul kıymetlerde, sadece ikinci seansın son bölümünde, (E ve Y özellik kodlu tüm pazarlarda) uygulanır. Kapanış Seansı; Emir aktarım, Emir toplama ve Fiyat belirleme aşamalarından oluşur. Bu aşamalar sonrasında kapanış fiyatından ve tek fiyattan işlemler yapılır. Kapanış seansının emir toplama sürecinde (17:33 – 17:36) sadece limit fiyatlı emir, açığa satış emri ve KAFE kullanılır, KİE, OLFE, OLDE ve özel emir kullanılamaz. Kapanış seansında menkul kıymetin normal seansta geçerli olan +/- % 10’luk marjları dahilinde kalmak koşuluyla, kapanış seansına girilecek emirler (belirlenecek ve genelgede yer alacak istisnalar haricinde) kıymetin son işlem fiyatının +/- % 3’ünden daha farklı olamaz.

Kapanış Fiyatından İşlemler Aşaması (17:38 – 17:40) Kapanış seansında belirlenmiş olan kapanış seansı fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin öncelik kuralları çerçevesinde karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği son aşamadır. Kapanış fiyatından işlemler aşamasında KİE, OLFE, OLDE, açığa satış ve özel emir girişine imkan verilir, ancak bu aşamada girilen bu emirler belirlenmiş kapanış seansı fiyatından farklı bir fiyat kademesinde olamaz. Kapanış seansı fiyatı belirleme aşamasında bir fiyat belirlenemeyen kıymetlerde kapanış fiyatından işlemler aşamasında normal ya da özel emir girilemez. Kapanış fiyatından işlemler aşaması öncesinde girilerek bu aşamaya aktarılmış emirlerden, Kapanış seansı fiyatına eşit olanların fiyatları değiştirilemeyecek ancak miktarları azaltılıp arttırılabilecek ve iptal edilmeleri mümkün olacaktır;Kapanış seansı fiyatından farklı fiyatta bekleyen emirler ise miktarları azaltılıp arttırılamayacak ancak fiyatları kapanış seansı fiyatına değiştirilebilecek ve iptal edilmelerine izin verilecektir.

Tek Fiyattan İşlemler (17:38 – 17:40), tek fiyat yöntemiyle işlem görmekte olan menkul kıymetlerde fiyat belirleme aşaması sonrasında, belirlenen fiyat seviyesinden kalan emirlerle tek fiyattan işlemler süreci boyunca sisteme girilecek emirlerin karşılaşarak işlemlerin belirlenmiş sabit fiyattan gerçekleşeceği seans aşamasıdır. Tek fiyat yöntemi ile işlem görmekte olan menkul kıymetlerde, sadece ikinci seansın son bölümünde, tek fiyat belirleme aşaması sonrasında uygulanır.

Paylarda A, B ve C gruplandırması uygulamasının başlamasıyla birlikte B ve C Grubu işlem sıralarında Açığa Satış emri kullanılamaz. Varant ve sertifika işlem sıralarına da açığa satış emri girilemez. Serbest İşlem Platformunda işlem gören paylara da Açığa Satış emri girilemez; ayrıca platformda işlem gören paylarda A, B ve C gruplaması yapılmaz. Serbest İşlem Platformundaki E ve Y özellik kodlu menkul kıymetlerde işlemler tek fiyat yöntemiyle gerçekleşir. Serbest İşlem Platformunda işlem gören menkul kıymetlerde “brüt takas” uygulanır.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 22

Page 24: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Seansların Sürekli Müzayede kısmında ise sürekli müzayede ve piyasa yapıcılı sürekli müzayede yönteminde işlem gören menkul kıymetlere, Normal Limit Fiyatlı Lot Emirleri (Açığa Satış Dahil), Özel Limit Fiyatlı Emirler (OLFE), Özel Limit Değerli Emirler (OLDE) ve Kalanı İptal Et (KİE) türü emirler sisteme gönderilebilmekte olup; Özel Emirler ise hiçbir aşamada ExAPI aracılığıyla girilememektedir.

AFE Açılış/Tek Fiyat süreci veya tek pay bazında yapılan fiyat belirleme sırasında kullanılan, fiyatsız olarak sisteme girilen bir emir türüdür. AFE’nin açılımı “Açılış Fiyatlı Emir” olmakla beraber Tek Fiyat sürecindeki kullanımının Açılıştakinden hiçbir farkı olmadığı için Tek Fiyat bölümünde girilen fiyatsız emir için de aynı isim kullanılır. Bu emirler karşı tarafta yeterli emir varsa, Açılış Fiyatı’ndan/Tek Fiyattan işlem görmekte, yoksa ilgili Açılış/Tek Fiyat Seansı emir toplama aşaması sonunda iptal edilmektedir. Tek fiyat yönteminde işlem gören menkul kıymetlerde açılış seansında girilen AFE türü emirler aynı seansın takip eden tek fiyat emir toplama aşamasına aktarılmaz, açılış seansı sonunda iptal edilir. İşlem sırası Açılış emir toplama sürecinde kapatılmış ve Açılış biterken hala işleme kapalıysa bu durumda AFE’ler iptal edilmez ve takip eden Tek Fiyat sürecine aktarılır. Ancak Açılış /Tek Fiyat sürecinde kapatılan ve o seans artık işleme açılmayan işlem sıralarında 1. Seans bitiminde AFE’ler iptal edilir ve bir sonraki seansa aktarılmaz. AFE tarihli olarak girilemez.

KAFE (Kapanış Fiyatlı Emirler) Kapanış Seansında (menkul kıymetlerin toplu veya tekil olarak Kapanışa Seansına alınması hallerinde) kullanılan, fiyatsız olarak sisteme girilen bir emir türüdür. KAFE, belirlenecek kapanış seansı fiyatından işlem görmek üzere Sisteme fiyatsız, sadece miktarın girilerek gönderildiği kapanış seansı fiyatından karşı bir emirle (fiyatlı bir emirle veya KAFE ile) karşılaşması durumunda işlem gerçekleştiren alış ya da satış emirleridir. KAFE’lerin miktarları arttırılıp azaltılabilir (miktar arttırıldığında önceliği değişir), KAFE’ler istendiği an iptal edilebilir ancak fiyatları değiştirilemez. KAFE emirlerinin (AFE’lerde olduğu gibi fiyat belirlemesinde bir etkisi olmaz). Tarihli KAFE emri girilemez. Belirlenen kapanış fiyatından gerçekleşme imkanı bulmayan KAFE’ler Sistem tarafından otomatik olarak iptal edilir, seansın bir sonraki aşamasına (kapanış fiyatından işlemler aşamasına) aktarılmazlar.

Açığa Satış emirlerinde marjlar haricinde ikinci bir kısıt olarak sistem tarafından hesaplanan bir “En Düşük Açığa Satış Fiyatı” bulunduğu için fiyat girilmesi zorunludur. Dolayısıyla Açığa Satış emirleri AFE/KAFE olarak girilemez.

Özel Limit Fiyatlı Emirler (OLFE) ve Özel Limit Değerli Emirler (OLDE) esas olarak Kalanı İptal Et (KİE) türü emir grubuna girmektedir. Ancak, bu tip emirlerde KİE emirlerinden farklı olarak miktar alanı sıfır olarak girilmelidir.

1 Lot = 1 YTL = 1 Adet uygulamasına geçilmesi nedeniyle küsurat işlemleri borsa dışı lot altı işlemleri kapsamında yürütüldüğü için sisteme Küsürat Emir de girilememektedir.Gönderilen emirlerin ExAPI PC veya İşlem Sistemi tarafından alındıktan sonraki durumlarını içeren bilgileri, bu mesajın cevabı olarak yine senkron kanaldan Yeni Emir Giriş Cevap mesajı içerisinde Üye Sistemi’ne geri döner. Girilen emir İşlem Sistemi tarafından reddedildiği takdirde, bu Yeni Emir Giriş mesajına ait bir İstek Red Bilgisi mesajı ayrıca asenkron kanaldan Üye Sistemi’ne gönderilir.

Yönetim Kurulumuzun 08.07.2010 tarih ve 1349 sayılı, 16.07.2010 tarih ve 1350 sayılı kararları uyarınca Borsa birincil piyasada uygulanan mevcut yönteme ilave olarak aşağıdaki iki yeni halka arz yöntemi geliştirilmiştir:

- Sabit Fiyatla Talep Toplama ve Satış Yöntemi (Sabit Fiyat Yöntemi - SFY)- Değişken Fiyatla Talep Toplama ve Satış Yöntemi (Değişken - Çoklu Fiyat Yöntemi - DFY)

Bu yöntemlerin uygulanacağı sıralarda sadece “limit fiyatlı” normal emir şeklindeki alış emirleri girilir (limit fiyatlı satış emri, açığa satış emri, kalanı iptal et emri, özel limit fiyatlı emir, özel limit değerli emir, küsurat emri ve özel emir girilemez). Borsa birincil piyasada geliştirilen bu yeni yöntemler iki aşamadan oluşmaktadır:

- Talep Toplama Aşaması: Bu aşamada klavye ve ExAPI kanalıyla emirler toplanır. Emir toplama süresi en az bir iş günü, en fazla üç iş günüdür. Emir toplama süresi bir günü aşabilir. Süre şirketin talebi üzerine Borsa Yönetim Kurulu tarafından belirlenir. SPK’nın veya Borsa’nın aksi yönde alınmış bir kararının olmaması ve satıştan önce şirket veya halka arza aracılık eden kurum tarafından duyurulmuş olması şartıyla, talep toplama süresinin sonu beklenmeden (örneğin birinci gün birincil piyasa seansının sonunda veya ikinci gün birincil piyasa seansının sonunda) dağıtım yapılabilir.

- Dağıtım Aşaması: Toplanan emirler ilgili Genelge’de detayları açıklanan şekilde alıcılara dağıtılır.

Birincil piyasada yeni yöntemler ile işlem olacak sıralarda satış emirleri Borsa İstanbul sistemi tarafından üretilecektir. Satış işlemi satıcı üye tarafından Borsaya bildirilen temsilci veya ExAPI kodu adına borsa tarafından emir girişi yapılarak gerçekleştirilecektir. Borsaya bir ExAPI numarası verilmiş olması durumunda, ExAPI kendi adına Borsa tarafından girilmiş bir emrin işlemlerine ilişkin bilgi alacaktır. Emre ilişkin bir mesaj ayrıca gönderilmeyecektir. İşleme ilişkin mesajlarda bu emrin numarası yer alacaktır. Söz konusu satış emri tek bir emirdir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 23

Page 25: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Emirler talep toplama süresinin sonuna kadar geçerlidir. Emrin süresi aracı kurumlar tarafından belirlenemez, emir girişi sırasında emrin geçerlilik tarihi Sistem tarafından otomatik olarak talep toplama süresinin son tarihi olarak verilir. Bu alan mevcut durumda “0” (seanslık) ya da “1” (günlük) olarak girilebilmektedir. Yeni yöntemlerde ExAPI’den emir girişinde her iki seçenek de kabul edilir. Ancak Sistem bu emirlerin geçerlilik süresini talep toplamanın son günü olarak belirler ve emirleri bu sürenin sonuna kadar tutar ve geçerli sayar. Dolayısıyla gelecek cevap mesajlarında tarih bilgisi yer alır. Bu emirlerin süresini değiştirmek mümkün değildir (değiştirilmeye çalışıldığında “H Emir bilgileri değiştirilmedi…” mesajı verir).

Emirlerin miktarları, hesap numaraları, AFK’ları değiştirilemez, geçerlilik süreleri uzatılıp kısaltılamaz. Dağıtım yapıldıktan sonra emir iptali ve değişikliği yapılamaz.

Sabit Fiyat Yönteminde: Tüm emirler, payları halk arz edilen şirket tarafından belirlenen ve duyurulan tek bir fiyat ile Sistem’e gönderilir (fiyat alanı boş geçilmez). Bu tek fiyat Sistem’de yer alır. Farklı bir fiyattan gelen emirler Sistem tarafından reddedilir. Emrin fiyatı değiştirilemez. Değişken Fiyat Yönteminde: Tüm emirler, payları halka arz edilen şirket tarafından belirlenen ve duyurulan fiyat aralığında Sistem’e gönderilir. Bu aralık, Borsa uzmanları tarafından, minimum ve maksimum fiyatlar şeklinde Sistem’e girilir (bazı özel durumlarda maksimum sınırın serbest bırakılmasına yönelik, üst sınır olarak yüksek bir fiyat girilir). Bu aralıktan farklı bir fiyattan gelen emirler Sistem’e kabul edilmez. Emrin fiyatı verilen aralık dahilinde (aralık fiyatları dahil) değiştirilebilir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E Y: Yeni emir anlamında.SIRA NUMARASI 8 hane nümerik E Kurum içi sıra numarası. Sağa dayalı, soldaki boş haneler sıfır

olacak.PAZAR KODU 1 karakter E N:Ulusal, L: İkinci Ulusal, veya Yeni Ekonomi, Y: Yeni Ekonomi

veya İkinci Ulusal, W:Gözaltı K: Kurumsal Ürünler Pazarı, S: Serbest İşlem Platformu, G: Gelişen İşletmeler Piyasası

PAY İŞLEM SIRASI KODU

5 karakter E Sola dayalı, 5’den az karakterli ise sağdaki boş alanlara boşluk karakteri gelecek.

SERİ KODU 2 karakter E Sola dayalı, 2’den az karakterli ise sağdaki boş alanlara boşluk karakteri gelecek.E(Eski),Y(Yeni),BE, BY (Birincil Eski ve Yeni), BF (Borsa Yatırım Fonu Birincil)R(Rüçhan), (Açılış/Kapanış Seansı sırasında emir girilememektedir)F(Borsa Yatırım Fonu) (Açılış/Kapanış Seansı sırasında emir girilememektedir)V(Varant) (Açılış/Kapanış Seansı sırasında emir girilememektedir)C(Sertifika)(Açılış/Kapanış Seansı sırasında emir girilememektedir.)ME, MY, MR, MF, MV, MC (Müzayede Eski, Yeni, Rüçhan, Fon, Varant, Sertifika),TE, TY, TR, TF, TV, TC (Temerrüt Eski, Yeni, Rüçhan, Fon, Varant, Sertifika),LE, LY, LV, LC (Toptan Satış Eski, Yeni ,Varant, Sertifika)

Not: Bir şirketin hem eski hem de yeni kodunun Birincil Piyasada halka arz edilme durumunda B kodunun yetersiz kalması nedeniyle BE ve BY olarak tanımlanacağından “B” Seri kodu kaldırılmıştır.Not: Seri kodu , LE, LY, LV, LC kodlarına halihazırda ExAPI aracılığıyla emir gönderilememektedir. Bu kodların burada yer alması bilgi amaçlıdır.

ALIŞ/SATIŞ 1 karakter E A:Alış, S:Satış, T:Açığa Satış (AFE/KAFE Açığa Satış olarak girilemez.)

EMİR TİPİ 1 karakter E L:Limit fiyatlı emir, , E:Kalanı iptal et (KİE) emri, A:Açılış/Kapanış fiyatlı emir (AFE/KAFE), O:Özel Limit Fiyatlı Emir, D:Özel Limit Değerli Emir

MÜŞTERİ TİPİ 1 karakter E M:Müşteri, P:Portföy, F:FonFİYAT 10 hane noktalı

nümerikE 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan

nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur. Açılış/Kapanış fiyatlı emirler için ise tüm haneler sıfır ile dolu olacaktır (0000000.00).

MİKTAR 8 hane nümerik H Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir. OLFE ve OLDE türü emirlerde miktar alanı sıfırla doldurulacaktır.

GEÇERLİLİK SÜRESİ 2 hane nümerik E 00:Seanslık Emir(KİE, OLFE ve OLDE emirleri sisteme girildiği anda işlem gören ve görmediği takdirde iptal edilen emirler olmasına rağmen bu tipteki emirler için de seanslık emir tanımlaması kullanılmaktadır. Açığa Satış ve AFE/KAFE emirleri de seanslık olarak tanımlanır.) 01:Günlük Emir

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 24

Page 26: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaHESAP NO 15 karakter E Sola dayalıdır, 15’den az karakterli ise sağdaki boş alanlara boşluk

karakteri gelir.REFERANS 6 karakter H Sola dayalıdır, 6’dan az karakterli ise sağdaki boş alanlara boşluk

karakteri gelir.ACENTE / FON KODU (AFK)

3 karakter H Bir banka ile acentelik sözleşmesi imzalamış olan aracı kurumlar, aracı kurumda hesabı olmayan banka müşterileri için ilettiği emirlerde hesap numarası alanına, müşterilerin acente bankada açık olan hesap numaralarını ve yeni eklenen üç haneli AFK alanına ise, hesabın ait olduğu acentenin üye kodunu gireceklerdir.Ayrıca, sisteme müşteri tipi “fon” olarak belirtilerek girilen emirlerde, bu fon/yatırım ortaklıklarına Borsa İstanbul tarafından verilmiş olan 3 haneli kodların AFK alanına kaydedilmesi, hesap numarası alanına ise, fon/yatırım ortaklığının sayısal hesap numarasının, sayısal hesap numarası yok ise AFK alanına girilmiş olan fon/yatırm ortaklığı kodunun yeniden girilmesi zorunludur.Sola dayalıdır, AFK bilgisinin girilmemesi durumunda boşluk karakterleri bırakılmalıdır.

LİMİT DEĞER 12 hane noktalı nümerik

H Özel limit değerli emirler (OLDE) için girilmesi zorunlu olan limit değer alanı.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 76 karakter veri ve 14 karakter alanlar arası boşluk olmak üzere, toplam 90 karakterdir.

Mesaj Örnekleri

Y 00000001 N ANHYT E A L M 0000002.25 00000100 00 ACC REFREF 000000000.00Y 00000002 W CUKEL E S L P 0000485.00 00000100 00 ACCOUNTACCOUNTA REFREF 000000000.00Y 00000003 N SISE Y S L P 0000005.00 00000030 01 12345 000000000.00Y 00000005 N ISCTR E A E M 0000005.80 00010000 00 ACC000000000001 000000000.00Y 00000006 N TUPRS E A L F 0000000.75 00010000 00 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000007 N ISCTR E S L F 0000008.00 00005000 00 123 TI3 000000000.00Y 00000008 N SAHOL E S L F 0000004.42 00000500 01 YK1 YK1 000000000.00Y 00000009 N ARAT E T L M 0000009.10 00000010 00 123456789012345 REFRNS 000000000.00Y 00000010 N ISCTR E A L M 0000008.10 00000010 00 123456789012345 REFRNS 000000000.00Y 00000011 N ISCTR R A L M 0000001.00 00000100 00 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000012 K BORYF F A L M 0000010.00 00000100 00 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000013 N BOSSA E A A M 0000000.00 00000100 00 HESAPNO REFRNS 000000000.00Y 00000014 K ARFYO E S O P 0000001.02 00000000 00 123456789012345 REFRNS GLB 000000000.00Y 00000015 K ARFYO E S D M 0000001.02 00000000 00 123456789012345 REFRNS GLB 000005000.00Y 00000027 K ERC01 V S L M 0000001.02 00000100 00 123456789012345 REFRNS GLB 000000000.00Y 00000015 S ABSIP E S L M 0000001.02 00000100 00 123456789012345 REFRNS GLB 000000000.00Y 00000015 G GIPAS E S L M 0000001.02 00000100 00 123456789012345 REFRNS GLB 000000000.00Y 00000016 N AKBNK BE A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000017 N AFYON BY A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000018 N DENTA TE A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000019 N DENTA TY A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS IYM 000000000.00Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 25

Page 27: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Y 00000020 K DJIST TF A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000021 N DENTA TR A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS IYM 000000000.00Y 00000022 N DENTA ME A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000023 N DENTA MY A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000024 K DJIST MF A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000025 N DENTA MR A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000026 K DJIST BF A L M 0000002.00 00000100 00 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000027 K ABCAA C A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000028 K ABCAA TC A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS A8F 000000000.00Y 00000029 K ABCAA MC A L M 0000002.00 00000100 01 HESAPNOHESAPNOH REFRNS A8F 000000000.000--------1---------2---------3---------4---------5---------6---------7---------8

3.1.1.2 Yeni Emir Giriş Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne göndermiş olduğu emirlerin İşlem Sistemi tarafından sisteme kabul edilmesiyle oluşan bilgiyi alır.

Buradaki önemli nokta, bu mesajın sadece ilgili emirin sisteme girildiğine dair bir mesaj olmasıdır. Emir, bu aşamadan sonra sistemde herhangi bir sebeple iptal edilebilir. Örneğin, piyasa yapıcılı yöntemde işlem gören bir paya alış olarak satış kotasyon fiyatından daha yüksek fiyattan girilen bir emir veya satış olarak alış kotasyon fiyatından daha düşük bir fiyattan girilen bir emir, karşı tarafta bekleyen kotasyon ve kotasyondan daha iyi fiyatlı emirlerle (kotasyon emri dahil) eşleşerek işlem görmesi sonrasında kalan miktarı “kotasyon dışı” kalması sebebiyle iptal edilir.

Özel Limit Fiyatlı Emirler (OLFE) ve Özel Limit Değerli Emirler (OLDE) esas olarak Kalanı İptal Et (KİE) türü emir grubuna girmektedir. Dolayısıyla, bu tip emirlerin cevap mesajları KİE emirleriyle benzer (sadece miktar alanı sıfır) olacaktır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E Y: Yeni emir anlamında.LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI (*) 16 hane nümerik E İşlem Sistemi tarafından verilen emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış EmriMİKTAR (*) 8 hane nümerik E Emirde verilen miktar. Lot olarak belirtilir.PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Gönderilmiş olan emir giriş isteğinde belirtilen fiyat.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonSIRA NUMARASI(*) 8 hane nümerik E Kurum içi sıra numarası.AÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 26

Page 28: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Y 00010000000002 10:16:40 EMİR 2006200000000509 ALIŞ 100 ANHYT.E 2.2 MÜŞ 12345678 GÜN HESAPNOHESAPNOH İSTENDİY 00010000000022 10:16:41 EMİR 2006200000000510 ALIŞ 100 ANHYT.E 2.21 MÜŞ 123 GÜN ACCOUNTACCOUNTA İSTENDİY 00010000000054 10:16:41 EMİR 2006200000000511 ALIŞ 1 SISE.E 16.5 MÜŞ 12345678 TAR 1 GÜN HESAPNOHESAPNOH İSTENDİY 00010000000096 10:16:41 EMİR 2006200000000512 SATIŞ 100 ANHYT.E 2.2 PORT 12345678 GÜN HESAPNOHESAPNOH İSTENDİY 00010000000123 10:16:42 EMİR 2006200000000513 SATIŞ 100 CUKEL.E 480 PORT 123 GÜN ACCOUNTACCOUNTA REFREF İSTENDİY 10680979195588 10:56:29 EMİR 0111200200157430 ALIŞ 9 KARSN.E 8.4 MÜŞ 12345678 KIE HESAPNOHESAPNOH İSTENDİY 10793456150673 14:16:21 EMİR 1505200300119513 SATIŞ 100 ISCTR.E 6.15 PORT 12345678 GÜN ACCOUNTACCOUNTA REFRNS İSTENDİY 10793456456794 14:38:54 EMİR 1505200300139328 ALIŞ 2000 ISCTR.E 6.05 MÜŞ 2343 GÜN ACCOUNTACCOUNTA REFRNS İSTENDİY 15491891576763 11:08:47 EMİR 2212200300000002 SATIŞ 11 ARAT.E 0.95 FON 1 GÜN GLB 123456789012345 123456 İSTENDİY 15491916333104 11:15:04 EMİR 2212200300000003 ALIŞ 100 BOSSA.E 15.5 FON 12345 TAR 1 GÜN HESAPNOHESAPNOH TI3 REFRNS İSTENDİY 15622629788737 10:55:59 EMİR 3012200300000010 AÇSAT 10 ARAT.E 0.95 MÜŞ 3 GÜN GLB 123456789012345 REFRNS İSTENDİY 15625749786789 15:13:52 EMİR 0511200400000513 ALIŞ 100 BORYF.F 25 MÜŞ 655 GÜN HESAPNOHESAPNOH REFREF İSTENDİY 17092184301537 09:31:13 EMİR 1809200500001497 ALIŞ 100 BOSSA.E 0.00 MÜŞ 6 AFE HESAPNO REFRNS İSTENDİY 17082081683771 09:44:52 EMİR 1809200500021681 SATIŞ 10 AKBNK.E 0.00 MÜŞ 12345678 AFE ACCOUNTACCOUNTA REFRNS İSTENDİY 38142615388296 15:16:51 EMİR 2201200800001160 ALIŞ 100 AKBNK.BE 2.00 MÜŞ 75390901 TAR 1 GÜN A8F ZXC1BNMKL111111 415263 İSTENDİ Y 38142620220923 15:18:05 EMİR 2201200800001161 ALIŞ 100 AKBNK.TY 5.00 MÜŞ 49890901 TAR 1 GÜN A8F ZXC1BNMKL111111 415263 İSTENDİ Y 38142629248641 15:20:23 EMİR 2201200800001162 ALIŞ 100 AKBNK.TR 3.00 MÜŞ 42590901 TAR 1 GÜN A8F ZXC1BNMKL111111 415263 İSTENDİ Y 38142660508513 15:28:20 EMİR 2201200800001163 ALIŞ 100 DJIST.MF 3.40 MÜŞ 75290901 TAR 1 GÜN A8F ZXC1BNMKL111111 415263 İSTENDİY 37953615253658 09:38:04 EMİR 2201200800000476 ALIŞ 0 ARFYO.E 1.10 MÜŞ 123 KIE HESAPNO İSTENDİY 37953619538912 09:39:09 EMİR 2201200800000477 ALIŞ 0 DJIST.F 16.00 MÜŞ 123 KIE HESAPNO İSTENDİY 37953619538922 09:40:09 EMİR 2503200900000478 ALIŞ 100 ERC01.V 6.00 MÜŞ 75390901 TAR 1 GÜN A8F ZXC1BNMKL111111 415263 İSTENDİ Y 49521113328063 15:34:20 EMİR 1801201100000146 ALIŞ 5 TEST.BE 5.00 MÜŞ 4 TAR 21 OCA 11 TTT 987654321123456 654321 İSTENDİ Y 53301546502941 10:41:17 EMİR 0211201100000102 ALIŞ 1 VAKKO.E 0.00 MÜŞ 6 KAFE ZZZ HESAP4321123456 654321 İSTENDİ Y 53233333759870 11:49:57 EMİR 1309201100000193 ALIŞ 50 EREGL.E 0.00 MÜŞ 5 KAFE 987654321123 6543 İSTENDİY 55861770215676 16:58:27 EMİR 1309201100000173 SATIŞ 100 OZAPP.C 0.01 MÜŞ 10000001 TAR 1 GÜN 987654321123 6543 İSTENDİ0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.1.3 Yeni Emir Giriş Hata Cevabı

Bu mesaj, üye sisteminden gelen yeni emir isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. emirin 3.1.1.1’de belirtilen yapıda olmaması, fiyatın marj dışında kalması, adım hatası, emirin alanlarında içerik yanlışları olması , vs.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir girişi anlamında.AÇIKLAMA (**) 198 karakter E İlgili emrin/isteğin reddedilme nedeni. Reddedilme nedenine bağlı

olarak değişen uzunluklardaki hata ifadesini içerir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 27

Page 29: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmıştır. Mesaj, hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen açıklama alanında, emirin hatalı olduğu durumun açıklaması ile birlikte emir detay bilgisi bulunur.

Mesaj Örnekleri

H Mesaj içeriği yanlış.H Fiyat bugünkü marjların dışındadır. EMİR : A 00000100 ANHYT.E 129.03 N M ACCOUNTACCOUNTA REFREF 00 000000000.00H Sistem isleme kapatilmistir.H Ulusal Pazar Icin Piyasa Kapali.Islem Yapamazsiniz.H Ikinci Ulusal Pazar Icin Piyasa Kapali.Islem Yapamazsiniz.H Gozalti Pazari Icin Piyasa Kapali. Islem yapamazsiniz.H Birincil Piyasa Kapali. Islem Yapamazsiniz.H Serbest Islem Platformu Kapali.Islem Yapamazsiniz.H İşlem kodu Y,D,I,U,K,M ya da N olabilir.H Bu Hissenin İşlemleri Durdurulmuştur. Emir Girilemez.H Ana Sistemden alınan hisse bilgileri geçersizdir.Destek birimini arayınız.H Ana Sistemden alınan işlem kodu geçersizdir.Destek birimini arayınız.H HATA – Adım yanlış . Olması Gereken Fiyat Adımı : 0.01H Fiyat girilmelidir.H Hesap numarası içeriği yanlış.H Hesap numarası girişi zorunludur.H Emir yöntemi L(Limit fiyatlı), E(KİE), O(OLFE), D(OLDE) ya da A(AFE) olmalıdır.H Geçersiz Özellikli Emir Koşulu. EMİR: A 00000000 KARSN.E 19 N F ACCOUNTACCOUNTA REFREF 00 000000000.00H Girilen değer izin verilen sınırın dışındadır. 1500000H Bu Hisse senedi tipi için geçersiz Miktar formatı. EMİR: A 00000000 ARFYO.E 1.04 N M 123456789012345 REFRNS 00 000000000.00H Özel Limit Fiyat/Değerli Emir (OLFE) Miktarı '0' olmalıdır. EMİR: A 00000001 ARFYO.E 1.04 N M 123456789012345 REFRNS 00 000000000.00H HATA - Emir Miktarı Bu Hisse İçin İzin Verilen Limitin Dışındadır. Maksimum : 600 EMİR: S 00001000 ISCTR.TR 6.50 N M 123456789012345 REFRNS 01 000000000.00H Ana Makina isteğinize cevap vermiyor.H Acente/Fon kodu alanında uygun olmayan karakterler var. H Fon emirlerinde AFK alanına fon kodunun girilmesi zorunludur.H Alış için A, satış için S, açığa satış için T olmalıdır.H Üye açığa satış emri vermeye yetkili değildir.H Bu hissede açığa satış emirleri verilemez. EMİR: S 00001003 EREGL.E 0.00 N M 123456789012345 REFRNS 01 000000000.00H Yukarı adım kuralı yerine getirilemedi. EMİR: S 00000010 ARAT .E 15 N M 123456789012345 REFRNS 00 0000000.00H Açığa satış emirleri tarihli olarak girilemez. EMİR: S 00000010 ARAT .E 9.1 N M 123456789012345 REFRNS 01 000000000.00H Geçersiz hisse özellik kodu!H Bu hisse senedine küsürat emri girilemez.H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır. H Emir tipi M, P ya da F olmalıdır.H Limit Değer alanında uygun olmayan karakterler var!H Emir fiyatı sisteme girilebilecek maksimum değeri aşıyor ya da noktalı gösterim hatası var. Fiyat alanını kontrol ediniz.H Ana Sistemden alınan işlem kodu geçersizdir.Destek birimini arayınız.H Açılış fiyatlı emirler fiyatlı girilemez. EMİR: A 00001000 BOSSA.E 3.00 N M HESAPNO REFRNS 00 000000000.00H Piyasa henüz oluşmadı - Limit Fiyat giriniz.H Açılışta verilecek miktar hissenin lot adedi veya katları olmalıdır. EMİR: A 00000001 BEKO .E 0 N M 00 000000000.00H Pazar ya da hisse açılış öncesi seansında. KİE emirlere izin verilmiyor.H Bu hisse açılış öncesi işlemlerine dahil değil. Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 28

Page 30: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

H Açılış öncesinde hesap numarası girişi zorunludur!H Hissenin özellik kodu açılışa dahil değildir.H Kalanı iptal et(KİE, OLFE, OLDE) ya da açılış fiyatlı(AFE)emirler tarihli girilemez.H UYARI - Henüz Pazar Oluşmadı, Miktar Girilmelidir. EMİR: A 00000000 ISCTR.E 7.85 N M 123456789012345 REFRNS 00 000000005.00H Girilen fiyat, arz fiyatından küçük olamaz. EMİR: A 00000100 AKBNK.BE 1.05 N M ACC01234567 REFRNS 00 000000000.00H Bu emir tipinde limit değer alanı sıfır olmalıdır.H Özel limit fiyatlı(OLFE) veya değerli(OLDE)emirler açılış veya kapanış seansında girilemez.H Açılış fiyatlı (AFE) emir girilemez.H Kotasyon İletim Periyodunda Emir Girilemez.H Kotasyon Girilmeden Emir Girilemez.H Varant özellik kodu açılışa dahil değildir.H Sertifika özellik kodu açılışa dahil değildir.H Açılış öncesi başlamadı! Henüz emirleriniz gönderilemez.H Bu hisse açılış öncesi işlemlerine dahil değil. EMİR: A 00001000 ERC01.V 0.00 K M 987654321123456 654321 01 000000000.00H Miktar Toplam Acik Miktardan buyuktur. EMİR: A 00000100 TEST .BE 5.00 N M 987654321123456 654321 01 000000000.00 H Birincil piyasada ilgili işlem yönteminde satış emri girilemez. EMİR: S 00000005 TEST .BE 5.00 N M 987654321123456 654321 01 000000000.00 H Birincil piyasada ilgili işlem yönteminde sadece limit fiyatlı normal emirler girilmelidir. EMİR: A 00000005 TEST .BE 5.00 N M 987654321123456 654321 00 000000000.00 H Birincil piyasanın ilgili işlem yöntemi için geçersiz fiyat. EMİR: A 00000005 TEST .BE 5.02 N 654321 00 H Limit fiyatlı emir! Fiyat alanı sıfırdan büyük olmalıdır! EMİR: A 00000005 TEST1.BE 0.00 N M HESAP4321123456 654321 01 000000000.00 H Halka Arz Bittikten Sonra Bu İşlemi Yapamazsınız.H Hissede İşlmeler durdurulmuştur.H Fiyat Kapanış Seansı Marjı dışındadır. EMİR: A 00000005 VAKKO.E 1.56 N M HESAP4321123456 654321 00 000000000.00 H Geçersiz hisse özellik kodu!H Hissenin özellik kodu kapanış seansına dahil değildir.H Emir yöntemi L(Limit fiyatlı), E(KİE), O(OLFE), D(OLDE) ya da A(AFE - KAFE) olmalıdır.H Kalanı iptal et(KİE, OLFE, OLDE) ,açılış fiyatlı(AFE) ya da kapanış fiyatlı (KAFE) emirler tarihli girilemez.H Fiyat Kapanış Fiyatından İşlemler Aşaması Marjı dışındadır.

H Kapanış fiyatı oluşmamış. Emir girilemez. EMİR: A 00000010 BOSSA.E 1.10 N M 987654321123 6543 01 000000000.00

H Sistem İşleme Kapatılmıştır.H Kapanış fiyatlı emirler fiyatlı girilemez. EMİR: S 00000150 EREGL.E 3.22 N 6543 00H Kapanış başlamadı! Henüz emirleriniz gönderilemez.H Kapanış Seansında hesap numarası girişi zorunludur.H Kalanı iptal et(KİE) ,açılış fiyatlı(AFE) ya da kapanış fiyatlı (KAFE) emirler tarihli girilemez.H Bu hisse kapanış seansı işlemlerine dahil değildir.

H Bu hisse kapanış fiyatından işlemler aşamasına dahil değildir. EMİR: A 00000110 ADANA.R AFE N M 987654321123 6543 01 000000000.00

H Hisse özellik kodu kapanış seansına dahil değildir.H Pazar ya da hisse açılış öncesi ve kapanış seansında KİE emirlere izin verilmiyor H Özel limit fiyatlı (OLFE) ya da özel limit değerli (OLDE) emirler Kapanış Seansında girilemez.H HATA - Islemi durdurulan hissede fiyatli girilen emirler KAFE yapilamaz.H Kapanis Seansinda Bu Tur Emirlere Izin Verilmez.H Bu Isleme Kapanis Seansinda Izin Verilmiyor.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 29

Page 31: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.2 Emir Değiştirme

3.1.2.1 Emir Değiştirme Mesajı

Bu mesaj ile üye, daha önce elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletmiş olduğu emirleri emir değiştirme kuralları dahilinde kalarak değiştirebilir.

Emir iptalinin serbest bırakılmasıyla birlikte fiyat kötüleştirme ve miktar azaltma şeklindeki emir değiştirmeleri de yapılabilir hale gelmiştir. Emrin miktarının artırılmasına da izin verilmiş olmakla birlikte miktar artırıldığında öncelik kaybedileceği için ek kısmın yeni bir emir olarak girilmesi daha doğru olacaktır.

Fiyat iyileştirilebilmesinin yanısıra kötüleştirilebilmekte; miktar azaltılabilmekte ve artırılabilmektedir (miktar artırıldığında zaman önceliği kaybedilmektedir). Açılış/Kapanış/Tek fiyatlı emirler limit fiyatlı emre, limit fiyatlı emirler de açılış/tek fiyatlı emre çevrilememektedir. Emrin süresi kısaltılabilmektedir. Değişiklikler ExAPI aracılığıyla yapılabildiği gibi temsilci terminali ile de yapılabilmektedir.

Açılış/Kapanış/Tek Fiyat Seansı içerisinde veya Sürekli Müzayede bölümünde tekil olarak açılış sürecindeyken işleme kapatılmış paylarda da Açılış/Kapanış/Tek Fiyat Seansı emir giriş aşaması ve Sürekli Müzayede sırasında, kapalılık hali devam ederken, emir değiştirmek mümkündür. Örneklemek gerekirse, Açılış Seansı sırasında işleme kapatılmış bir paydaki emirler üzerinde Açılış süresince ve verilen aradan sonra başlayan Sürekli Müzayede bölümünde değişiklik yapmak olasıdır. Aynı şekilde Sürekli Müzayede sırasında tekil olarak açılışa alınmış bir pay işleme kapatılmışsa bu paydaki emirlerde de değişiklik yapılabilir. Bu süreçlerde emir değiştirmeyle miktar azaltılabilir, fiyat kötüleştirilebilir, tarih kısaltılabilir.

Kapanış seansı öncesinde işlemleri durdurulmuş bir pay kapanış seansına tekil olarak açıldığında bu pay kapanış seansında kabul edilir ve kapanış seansı için geçerli olan emir değiştirme, ve iptal kurallarına tabi olur.

Sürekli Müzayede / Piyasa Yapıcılı Sürekli Müzayede sürecinde pay bazında yapılan bir açılış seansının ardından sonuçların üyeler tarafından değerlendirilmesi için zaman vermek amacıyla payın sırası geçici olarak işleme kapatılmakta ve belirli bir süre sonra işleme açılmaktadır. Emir iptalinin serbest bırakılması uygulamasına paralel olarak bu özel kapalılık durumunda da emir iptali ve değişikliği isteklerine (miktar azaltma – fiyat kötüleştirme –tarih kısaltma kapsamıyla sınırlı olmak üzere) izin verilecektir; ayrıca bu durumdaki paya/fona kotasyon girilebilmesine veya bekleyen kotasyonların değiştirilebilmesine izin verilecektir.

Birinci seans Tek Fiyat bölümü seans bitişinden 5 dakika önce (12:25) sona erer, 12:25-12:30 saatleri arasında Tek Fiyat İşlem Yönteminin geçerli olduğu işlem sıralarında bulunan emirler üzerinde herhangi bir değişiklik yapılamaz. İkinci seans Tek Fiyat bölümünün bitişiyle “Tek Fiyattan İşlemler” aşamasının başlangıcı arasındaki süreçte (17:30 - 17:38) Tek Fiyat İşlem Yönteminin geçerli olduğu işlem sıralarında bulunan emirler üzerinde herhangi bir değişiklik yapılamaz.

Bu mesaj tipi ile gönderilen emir değiştirme isteklerinin ExAPI PC ya da İşlem Sistemi tarafından alındıktan sonraki durumlarını içeren bilgileri, bu mesajın cevabı olarak, senkron kanaldan 3.1.2.2 Emir Değiştirme Cevap mesajı içerisinde Üye Sistemi’ne geri döner.

Sistemdeki tüm ExAPI kullanıcıları emir değiştirme konusunda “Yönetici” yetkisinde olduklarından dolayı, kendileri tarafından girilmiş olsun olmasın, bağlı bulundukları kuruma ait olan tüm emirleri, ExAPI vasıtasıyla değiştirebileceklerdir. Bu durumda, emiri değiştiren ExAPI kullanıcısına, senkron kanaldan emirin değiştirilmesinin istendiğine dair mesaj gelirken aynı mesaj emiri girmiş olan kullanıcıya ise asenkron kanaldan gidecektir. Ancak isteğin Borsa İstanbul ana sisteminde herhangi bir sebeple red edilmesi durumunda, emir değiştirme cevap mesajı ve istek red bilgisi mesajı sadece emiri değiştirmek isteyen kullanıcıya gidecek olup emirin sahibi olan kullanıcıya ise hiçbir mesaj ulaşmayacaktır. Emiri değiştirme isteğini gönderen kullanıcıya ve emirin sahibi olan kullanıcıya gelen yanıt mesajlarının sadece log sıra numarası alanları birbirlerinden farklı olacaktır.

Burada da -yeni emir girişinde olduğu gibi- yapılan emir değiştirme isteği, İşlem Sistemi tarafından reddedilebilir. Bu takdirde, ilgili Emir Değiştirme mesajına ait bir İstek Red Bilgisi mesajı ayrıca asenkron kanaldan Üye Sistemi’ne gönderilir.

AFE/KAFE’lerin miktarları arttırılıp azaltılabilir (miktar arttırıldığında önceliği değişir), AFE/KAFE’ler istendiği an iptal edilebilir ancak fiyatları değiştirilemez (fiyatlı emre dönüştürülemez).

Kapanış fiyatından işlemler aşaması öncesinde girilerek bu aşamaya aktarılmış limit fiyatlı emirlerden, Kapanış seansı fiyatına eşit olanların fiyatları değiştirilemeyecek ancak miktarları azaltılıp arttırılabilecek ve iptal edilmeleri mümkün olacaktır;Kapanış seansı fiyatından farklı fiyatta bekleyen emirler ise miktarları azaltılıp arttırılamaz ancak fiyatları kapanış seansı fiyatına değiştirilebilir ve iptal edilmelerine izin verilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 30

Page 32: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E D: Emir Değiştirme anlamındaBÖLÜM SAYISI 1 hane nümerik E bu alan değiştirme istekleri için 0 (sıfır) olarak verilecektir.EMİR NUMARASI 16 hane nümerik E Borsa İstanbul İşlem Sistemi tarafından verilen genel emir

numarası.PAZAR KODU 1 karakter E N:Ulusal, L:İkinci Ulusal veya Yeni Ekonomi, Y: Yeni Ekonomi

veya İkinci Ulusal, W:Gözaltı K: Kurumsal Ürünler Pazarı, S: Serbest İşlem Platformu, G: Gelişen İşletmeler Piyasası

MEVCUT FİYAT 10 hane noktalı nümerik

E Üye sistemi tarafından emirin değiştirme isteğinin gönderildiği anda emrin bilinen fiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur. Açılış/kapanış fiyatlı emir değişikliğinde fiyat alanı sıfır (0000000.00) olacaktır.

MEVCUT MİKTAR 8 hane nümerik E Üye sistemi tarafından emirin değiştirme isteğinin gönderildiği anda emrin bilinen miktarı. Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

YENİ FİYAT 10 hane noktalı nümerik

E Emrin yenifiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur. Açılış/kapanış fiyatlı emir değişikliğinde fiyat alanı sıfır (0000000.00) olacaktır.

YENİ MİKTAR 8 hane nümerik E Emrin yeni miktarı.Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

GEÇERLİLİK SÜRESİ 2 hane nümerik E 00:Seanslık Emir, 01:Günlük Emir.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 57 karakter veri ve 8 karakter alanlar arası boşluk olmak üzere, toplam 65 karakterdir.

Mesaj Örnekleri

D 0 2006200012345678 N 0000027.25 00000900 0000027.25 00000880 00D 0 2006200012345679 L 0000000.85 00000010 0000000.86 00000010 01D 0 0106200400000080 N 0000004.80 00000015 0000005.00 00000010 00D 0 2006200012345680 N 0000000.00 00000100 0000000.00 00000080 00D 0 2006200012345680 K 0000005.00 00000100 0000005.05 00000080 00D 0 2006200012345680 G 0000002.00 00000100 0000001.98 00000100 00D 0 2006201112345680 S 0000002.00 00000100 0000001.98 00000100 00

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.2.2 Emir Değiştirme Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI PC’si vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne göndermiş olduğu emir değiştirme isteğinin ana sistem tarafından kabul edilmesiyle oluşan bilgiyi senkron kanaldan alır. Emiri giren ExAPI kullanıcısından başka bir kullanıcı (ExAPI ya da şef broker) tarafından yapılan değiştirme isteklerine karşı ana sistemden gelen cevap mesajları ise asenkron kanaldan üye sistemine aktarılacaktır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E D: Emir DeğiştirmeLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış Emri,MİKTAR (*) 8 hane nümerik E Değiştirilen emirde kalan miktar. Lot olarak belirtilir.PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Değiştirilen emirin yeni fiyatı.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonAÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 31

Page 33: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

D 00010000000002 10:16:45 EMİR 2006200012345678 ALIŞ 99 ANHYT.E 28.5 MÜŞ GÜN HESAPNO DEĞİŞTİRMEİSTENDİD 00010000980763 11:23:18 EMİR 2006200087654321 SATIŞ 199 ANHYT.E 28.5 PORT GÜN ACCOUNTACCOUNTA DEĞİŞTİRMEİSTENDİD 15622690073421 11:11:19 EMİR 3012200300000012 AÇSAT 20 ARAT.E 0.91 MÜŞ GÜN 123456789012345 REFRNS DEĞİŞTİRMEİSTENDİD 17960623441167 14:16:08 EMİR 0106200400000080 ALIŞ 13 ISCTR.E 4.98 MÜŞ GÜN DFGD DEĞİŞTİRMEİSTENDİD 15622690073421 14:13:29 EMİR 0511200400000214 ALIŞ 20 BORYF.F 25.1 MÜŞ GÜN HESAPNOHESAPNOH REFRNS DEĞİŞTİRMEİSTENDİD 24250310035755 15:32:10 EMİR 1210200500000153 ALIŞ 500 BJKAS.E 0.00 MÜŞ AFE 123456789012345 123456 DEĞİŞTİRMEİSTENDİD 55861800809965 17:06:14 EMİR 1309201100000176 ALIŞ 150 OZAPP.C 1.02 MÜŞ GÜN 987654321123 6543 DEĞİŞTİRMEİSTENDİ0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.2.3 Emir Değiştirme Hata Mesajı

Bu mesaj, üye sisteminden gelen emir değiştirme isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. değiştirilmek istenen emir numarasının sistemde bulunamaması, yeni fiyat ve miktar alanlarının orijinal emirdekilerle aynı olması durumu, vs.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir değişiklik isteği anlamında.AÇIKLAMA (**) 198 karakter E İlgili emrin/isteğin reddedilme nedeni. Reddedilme nedenine bağlı

olarak değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen alanlarda, emirin hatalı olduğu durumu açıklayan bilgi ile birlikte emir detay bilgisi yer alır. Tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

H Emir bulunamadı. Yanlış Emir numarası girdiniz veya Emir gerçekleşmiş.H Mesaj içeriği yanlış.H Emir bilgileri değiştirilmedi. İyileştirme yapılamaz.H Emir değişmiş. Tekrar deneyiniz.H Ulusal Pazar Icin Piyasa Kapali.Islem Yapamazsiniz.H Serbest Islem Platformu Kapali.Islem Yapamazsiniz.H İşlem kodu Y,D,I,U,K,M ya da N olabilir.H Sistem isleme kapatilmistir.H Değiştirme isteğiyle ilgili hissenin özellik kodu geçersiz!H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır. H HATA - Bu Emir size ait degil.H Ana Makina isteğinize cevap vermiyor.H Ana Sistemden alınan işlem kodu geçersizdir.Destek birimini arayınız.H Seanslık emir günlük emire çevrilemez ! EMİR: A 00000013 AKALT.E 0.00 N 01H Kalanı iptal et(KİE, OLFE, OLDE) ya da açılış fiyatlı(AFE) emirler tarihli girilemez.H Açılış fiyatlı emirler fiyatlı girilemez. EMİR: A 00000028 ISCTR.E 9.00 N M ACC000000000001 00

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 32

Page 34: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

H Açılış fiyatlı emirler limit fiyatlı emre, limit fiyatlı emirler açılış fiyatlı emre çevrilemez.H Birincil piyasada ilgili işlem yönteminde miktar artırılamaz. EMİR: A 00000010 TEST .BE 5.00 N 654321 00 H Birincil piyasada ilgili işlem yönteminde miktar azaltılamaz. EMİR: A 00000010 TEST .BE 5.00 N 654321 00 H Kapanış fiyatlı emirler limit fiyatlı emre, limit fiyatlı emirler kapanış fiyatlı emre çevrilemez. EMİR: S 00000150 EREGL.E 0.00 N 6543 00

0--------1---------2---------3---------4---------5---------6---------7---------8

Not : Değiştirme isteği sisteme gönderildiğinde piyasanın kapalı olması durumunda payın dahil olduğu piyasaya bağlı olarak başındaki ifade değişerek yukarıdaki mesaj örneklerinden beşinci sırada yer alan mesaj benzeri bir hata cevabı üye sistemine gönderilecektir.

Ayrıca tanımlı özellik kodları dışında olan paylarda ExAPI uygulaması yoluyla emir kabul edilmediğinden dolayı, bu paylara gönderilen emir değiştirme istekleri ExAPI PC’si tarafından reddedilecektir.

.

3.1.3 Emir İptal

3.1.3.1 Emir İptal Mesajı

Bu mesaj ile üye, daha önce elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletmiş olduğu emirleri emir iptal kuralları dahilinde kalarak iptal edebilir.

Açılış Seansının emir girişi aşamasında(tekil olarak pay bazında yapılan açılış bölümü de dahil) ve Tek Fiyat sisteminde emir iptali serbesttir. Emir girişi devam ettiği sürece hem Limit Fiyatlı Emir hem AFE hiçbir şarta bağlı olmaksızın iptal edilebilir. –Emir İptalinin serbest bırakılması uygulaması ile birlikte Sürekli Müzayede/Piyasa Yapıcılı Sürekli Müzayede sisteminde işlem gören payların da seans içerisinde emir iptali serbest hale gelmiştir.. Kapanış seansı, kapanış fiyatından işlemler ve tek fiyattan işlemler aşamalarında da emir iptali serbest olacaktır.

Tek Fiyat seanslarının emir girişi aşamalarında da emir iptali serbesttir. Emir girişi devam ettiği sürece hem Limit Fiyatlı Emir hem AFE/KAFE hiçbir şarta bağlı olmaksızın iptal edilebilir.

Açılış sırasında herhangi bir sebeple işleme kapatılmış ve Açılış emir girişi aşaması ve sonrasındaki Sürekli Müzayede aşamasında ve Tek Fiyat seansı sırasında kapatılan ve kapalılık hali devam eden paylarda da bu süreçlerde emir iptali yapılabilir. Müzayede içerisinde açılış yapılırken kapatılan paylarda da emir iptali yapılabilir.

Birinci seans Tek Fiyat bölümü seans bitişinden 5 dakika önce (12:25) sona erer, 12:25-12:30 saatleri arasında Tek Fiyat İşlem Yönteminin geçerli olduğu işlem sıralarında bulunan emirler üzerinde herhangi bir değişiklik yapılamaz. İkinci seans Tek Fiyat bölümünün bitişiyle “Tek Fiyattan İşlemler” aşamasının başlangıcı arasındaki süreçte (17:30 - 17:38) Tek Fiyat İşlem Yönteminin geçerli olduğu işlem sıralarında bulunan emirler üzerinde herhangi bir değişiklik yapılamaz.

İşlem görecek varantlar ve sertifikalardada son emir olma koşulu aranmaksızın emir iptali serbest olacaktır.

Sürekli Müzayede sırasında pay bazında yapılan bir açılışın ardından sonuçların üyeler tarafından değerlendirilmesi için zaman vermek amacıyla payın sırası geçici olarak işleme kapatılmakta ve belirli bir süre sonra işleme açılmaktadır. Bu özel kapalılık durumunda emir iptaline izin verilmemekteydi. Ancak Emir iptali kuralında yapılan değişiklikle iptale izin verilmesi nedeniyle bu aşamada da artık emirler iptal edilebilecektir. .

Bu mesaj tipi ile gönderilen iptal isteklerinin İşlem Sistemi tarafından alındıktan sonraki durumlarını içeren bilgileri, bu mesajın cevabı olarak senkron kanaldan Emir İptal Cevap mesajı içerisinde Üye Sistemi’ne geri döner. Yapılan emir iptal isteği İşlem Sistemi tarafından reddedildiği takdirde, bu Emir İptal mesajına ait bir İstek Red Bilgisi mesajı ayrıca asenkron kanaldan Üye Sistemi’ne gönderilir.

Sistemdeki tüm ExAPI kullanıcıları emir iptali konusunda “Yönetici” yetkisinde olduklarından dolayı, kendileri tarafından girilmiş olsun olmasın, bağlı bulundukları kuruma ait olan tüm emirleri, ExAPI vasıtasıyla iptal edebileceklerdir. Bu durumda, emir iptal isteğini gönderen ExAPI kullanıcısına, senkron kanaldan emirin iptalinin istendiğine dair mesaj gelecek ancak bu mesaj emiri girmiş olan kullanıcıya gitmeyecektir. İptal isteğinin Borsa İstanbul ana işlem sisteminde herhangi bir sebeple red edilmesi durumunda, emir iptal cevap mesajı ve istek red bilgisi mesajı sadece emiri iptal etmek isteyen kullanıcıya gidecek olup emirin sahibi olan kullanıcıya ise hiçbir mesaj ulaşmayacaktır. Emiri iptalini isteyen kullanıcıya ve emirin sahibi olan kullanıcıya gelen yanıt mesajlarının sadece log sıra numarası alanları birbirlerinden farklı olacaktır.Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 33

Page 35: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Birincil piyasada Sabit ve Değişken Fiyatla halka arz yöntemlerinde dağıtım yapıldıktan sonra emir iptali ve değişikliği yapılamaz.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E I: Emir İptali anlamındaEMİR NUMARASI 16 hane nümerik E Borsa İstanbul İşlem Sistemi tarafından verilen genel emir

numarası.PAZAR KODU 1 karakter E N:Ulusal, L: İkinci Ulusal veya Yeni Ekonomi , W:Gözaltı, Y: Yeni

Ekonomi veya İkinci Ulusal, K: Kurumsal Ürünler Pazarı, S: Serbet İşlem Platformu, G: Gelişen İşletmeler Piyasası

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 18 karakter veri ve 2 karakter alanlar arası boşluk olmak üzere, toplam 20 karakterdir.

Mesaj Örnekleri

I 2006200000001939 NI 2003200090000939 K0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.3.2 Emir İptal Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne göndermiş olduğu emir iptal isteğinin İşlem Sistemi tarafından sisteme kabul edilmesiyle oluşan bilgiyi alır. Ancak bu mesaj, emir iptali yapıldı anlamına gelmemektedir. Sadece isteğin kabul edildiğini belirtir. İptalin gerçekleşme mesajı ise, asenkron kanaldan gelecektir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E I: Emir İptali anlamındaLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI 16 hane nümerik E İptal edilmek istenen emrin emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış EmriMİKTAR (*) 8 hane nümerik E Emirde verilen miktar.. Lot olarak belirtilir.PAY İŞLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Gönderilmiş olan emirde belirtilen fiyat.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonAÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

I 00010000000002 10:16:50 EMİR 2006200000001939 ALIŞ 100 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTALİSTENDİI 00010000002562 10:16:50 EMİR 2006200000001940 SATIŞ 100 ANHYT.E 28.5 MÜŞ TAR 20 HAZ 00 ACCOUNTACCOUNTA İPTALİSTENDİ.I 15622703848430 11:14:49 EMİR 3012200300000012 AÇSAT 20 ARAT.E 0.92 MÜŞ GÜN 123456789012345 REFRNS İPTALİSTENDİI 24260624816556 11:04:29 EMİR 1210200500000155 SATIŞ 500 BJKAS.E 0.00 MÜŞ AFE 123456789012345 123456 İPTALİSTENDİ

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 34

Page 36: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

I 53233402133399 12:07:20 EMİR 1309201100000201 SATIŞ 150 EREGL.E 0.00 PORT KAFE 987654321123 6543 İPTALİSTENDİ

I 55861812972212 17:09:19 EMİR 1309201100000178 ALIŞ 101 OZAPP.C 1.03 MÜŞ GÜN 987654321123 123456 İPTALİSTENDİ

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.3.3 Emir İptal Hata Mesajı

Bu mesaj, Üye sisteminden gelen emir iptal isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. iptal edilmek istenen emrin sistemde bulunamaması, vs.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir iptal isteği anlamında.AÇIKLAMA (**) 198 karakter E İlgili emrin/isteğin reddedilme nedeni. Reddedilme nedenine bağlı

olarak değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen alanlarda, hatalı olan durumu açıklayan bilgi ile birlikte istek detay bilgisi yer alır. Tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

H Mesaj içeriği yanlış.H Emir bulunamadı. Yanlış Emir numarası girdiniz veya Emir gerçekleşmiş.H Ikinci Ulusal Pazar Icin Piyasa Kapali.Islem Yapamazsiniz.H Birincil Piyasa Kapali. Islem Yapamazsiniz.H Serbest Islem Platformu Kapali.Islem Yapamazsiniz.H İşlem kodu Y,D,I,U,K,M ya da N olabilir.H Sistem isleme kapatilmistir.H Ana Makina isteğinize cevap vermiyor.H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır. H İptal isteğiyle ilgili hissenin özellik kodu geçersiz!0--------1---------2---------3---------4---------5---------6---------7---------8

Not : Emir İptal isteğinin gönderildiği anda ilgili piyasanın kapalı olması durumunda yukarıdaki mesaj örneklerinden üçüncü sırada yer alan mesaj benzeri bir hata cevabı üye sistemine gönderilecektir.

3.1.4 Yeni Kotasyon Giriş

Kotasyon, piyasa yapıcılı yöntemde işlem gören bir menkul kıymette piyasa yapıcı olarak belirlenmiş üyenin kendi hesabına alış-satış fiyat ve miktarı bildirimidir.

Piyasa yapıcılı yöntemde işlem gören paylara/fonlara/varantlara/sertifikalara, açılış işlemlerinin tamamlanmasını takiben başlayan “Kotasyon İletimi Aşaması” süresince kotasyon girilebilecek; girilmiş kotasyonlar değiştirilebilecektir. Kotasyon İletimi sürekli müzayede seansının sonuna kadar sürecektir (ilgili piyasaların kapanma genel yayın mesajının gelmesiyle birlikte kotasyon iletimi sona erecektir).

Piyasa yapıcı üye sürekli müzayede başlamadan belirli bir sure oncesine kadar kotasyon girmediği taktirde İşlem Sistemi ilgili menkul kıymete (paya/borsa yatırım fonuna) kurallar dahilinde ilk kotasyonu atayacaktır. Bu durumda ilk kotasyon atama için üyenin Borsa’ya bildirdiği ExAPI kullanıcısına (eğer otomatik kotasyon atama yapıldığı anda Borsa İstanbul Sistemi’ne bağlı durumda ise), sadece asenkron kanaldan “Kotasyon Güncellendi Bilgisi” mesajı gelecektir. ExAPI kullanıcısı otomatik ilk kotasyon atama sırasında Borsa İstanbul Sistemi’ne bağlı değilse veya atama sonrasında tekrar Sisteme giriş yaptığında mesaj dosyasını silerse, Borsa İstanbul Sistemi’ne ilk bağlandığında mesaj indirme sırasında “Kotasyon Güncellendi Bilgisi” mesajının yanısıra “Yeni Kotasyon Giriş Cevap” mesajı da alacaktır. Sözkonusu atama işleminin yapıldığı süreç “Otomatik Kotasyon İletimi” süreci olarak adlandırılmaktadır.

Otomatik ilk kotasyon ataması İşlem Sistemi tarafından yapılamadığı durumda, pay/fon otomatik olarak işleme kapatılacaktır (varantlarda ve sertifikalarda böyle bir durum söz konusu olmayacaktır). Bu durum nedeniyle işlemleri durdurulmuş olan paya/fona, piyasa yapıcı ilk kotasyonu girdikten sonra, kotasyon girildiğine ilişkin piyasaya duyurulacak mesajda belirtilen saatte pay/fon işleme açılacaktır.Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 35

Page 37: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Varantlarda ve sertifikalarda piyasa yapıcı üyenin “Otomatik Kotasyon Atama” aşamasının başlamasına kadar ilk kotasyon girişini yapmaması durumunda, İşlem Sistemi tarafından otomatik kotasyon girişi yapılmayacaktır; bu durumda sürekli müzayede aşaması başlasa dahi, piyasa yapıcı üye tarafından ilk kotasyon girilinceye kadar emir girişine izin verilmeyecektir.

Sürekli müzayede seansı içerisinde bir payda/fonda/varantta/sertifikada bekleyen kotasyonun işlem görerek miktarının tamamen tükenmesi ve Borsa tarafından belirlenen süre içinde (3 dakika) piyasa yapıcı üye tarafından kotasyonun miktarının en az minimum kotasyon miktarına tamamlanmaması halinde Sistem ilgili paya/fona/varanta/sertifikaya ilk kotasyon girişini yapan piyasa yapıcı üye temsilcisi koduyla en son kotasyon fiyatından minimum kotasyon miktarı kadar kotasyon girişini otomatik olarak yapacaktır. Ayrıca seans bitiminde bir payda/fonda/varantta/sertifikada miktarı işlem görerek tamamen tükenmiş bir kotasyon bulunuyorsa, kotasyonun tamamen tükendiği saatten belli bir süre sonra (3 dakika) söz konusu kotasyonun miktarı Sistem tarafından otomatik olarak minimum kotasyon miktarına tamamlanacaktır; örneğin seans 12:30:00’da bitecek ancak bir paya/fona/varanta/sertifikaya Sistem tarafından 12:32:35’te otomatik kotasyon atama yapılabilecektir.

Açılış seansı öncesi veya açılış seansı emir toplama aşaması içinde işlemleri durdurulan paya/fona bu kapalılık devamı süresince kotasyon girilemeyecektir. Ayrıca sürekli müzayede içinde açılış seansına alınmış paya/fona da emir toplama aşaması süresince kotasyon girilemeyecektir. Bu durumdaki paya kotasyon girişi paydaki/fondaki açılış işlemlerinin tamamlanması sonrasında yapılabilecektir. Açılış işlemlerinin tamamlanması sonrasında –mevcut durumda olduğu gibi- pay otomatik olarak işleme kapatılacak, paya/fona açılış işlemlerinin tamamlanmasıyla birlikte Sistem tarafından otomatik olarak ilk kotasyon ataması kurallar dahilinde yapılacak ve pay Sistem tarafından otomatik olarak üretilecek mesajda belirtilen saatte (kotasyon girişinden 5 dakika sonra) işleme açılacaktır. Sistem tarafından girilen bu kotasyon payın/fonun bu kapalılık hali süresince veya sürekli müzayede için işleme açılmasından sonra piyasa yapıcı tarafından değiştirilebilecektir.

Açılış işlemlerinin tamamlanmasının ardından bir payın/fonun sırası söz konusu menkul kıymete henüz ilk kotasyon girişi yapılmadan Borsa İstanbul tarafından durdurulursa, durdurulma süresince piyasa yapıcı üye ilgili sıraya ilk kotasyon girişi yapabilecektir, ancak pay/fon durdurma sonrası Borsa İstanbul tarafından yeniden işleme açılacak, ilk kotasyonun otomatik atanması sürecindeki gibi kotasyon girişinden belli bir süre sonra otomatik olarak açılmayacaktır. Bu tür bir durdurma sırasında paya/fona piyasa yapıcı üye tarafından ilk kotasyon girişi yapılmazsa Borsa İstanbul tarafından belirlenen saate pay/fon işleme açıldığı anda ilk otomatik kotasyon atama kuralları dahilinde ilk kotasyon girişi Sistem tarafından otomatik olarak yapılır; Sistem tarafından girilen kotasyon piyasa yapıcı tarafından değiştirilebilir. Varantların veya sertifikaların ilk kotasyon girilmeden Borsa İstanbul tarafından durdurulması durumunda durdurulma süreci içinde varanta veya sertifikaya ilk kotasyon girişi yapılamayacaktır; varanta veya sertifikaya ilk kotasyon girişi ancak varant veya sertifika işleme açıldıktan sonra yapılabilecektir.

Açılış işlemleri tamamlanmış sürekli müzayede içinde işlem gören ve kotasyonu bulunan bir payın/fonun/varantın/sertifikanın işlemlerinin Borsa tarafından geçici olarak durdurulması sırasında piyasa yapıcı üye bekleyen kotasyonu üzerinde değişiklik yapabilecektir.

3.1.4.1 Yeni Kotasyon Giriş Mesajı

Bu mesaj ile üye, kotasyon emirlerini elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletebilir.

Gönderilen kotasyonların ExAPI PC veya İşlem Sistemi tarafından alındıktan sonraki durumlarını içeren bilgileri, bu mesajın cevabı olarak yine senkron kanaldan Yeni Kotasyon Giriş Cevap mesajı içerisinde Üye Sistemi’ne geri döner. Girilen kotasyon Sistem tarafından reddedildiği takdirde, bu Yeni Kotasyon Giriş mesajına ait bir İstek Red Bilgisi mesajı ayrıca asenkron kanaldan Üye Sistemi’ne gönderilir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E K: Yeni Kotasyon anlamında.SIRA NUMARASI 8 hane nümerik E Kurum içi sıra numarası. Sağa dayalı, soldaki boş haneler sıfır

olacak.PAZAR KODU 1 karakter E N:Ulusal, L: İkinci Ulusal veya Yeni Ekonomi, Y: Yeni Ekonomi

veya İkinci Ulusal, W:Gözaltı K: Kurumsal Ürünler Pazarı, S: Serbest İşlem Platformu, G: Gelişen İşletmeler Piyasası

PAY İŞLEM SIRASI KODU

5 karakter E Sola dayalı, 5’den az karakterli ise sağdaki boş alanlara boşluk karakteri gelecek.

SERİ KODU 2 karakter E Sola dayalı, 2’den az karakterli ise sağdaki boş alanlara boşluk karakteri gelecek.E(Eski),V(Varant),Y(Yeni),F(Borsa Yatırım Fonu)C(Sertifika)

ALIŞ MİKTARI 8 hane nümerik E Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 36

Page 38: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaALIŞ FİYATI 10 hane noktalı

nümerikE 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan

nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

SATIS FİYATI 10 hane noktalı nümerik

E 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

SATIS MİKTARI 8 hane nümerik E Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.REFERANS NO 6 karakter H Sola dayalıdır, 6’dan az karakterli ise sağdaki boş alanlara boşluk

karakteri gelir.HESAP NO 15 karakter E Sola dayalıdır, 15’den az karakterli ise sağdaki boş alanlara boşluk

karakteri gelir. ( Paya/fona Borsa İstanbul tarafından otomatik kotasyon ataması yapılması durumunda, üye tarafından ilgili menkul kıymete son girilen kotasyon için girilmiş olan hesap numarası veya piyasa yapıcının payda/fonda piyasa yapıcılığı yapacağı ilk seansta ilk kotasyonu girmemesi durumunda ise piyasa yapıcının kotasyon girişi için Borsaya bildirdiği hesap numarası kullanılacaktır.)

(Kotasyon girişi yapılırken bu alana ExAPI kullanıcısı tarafından hesap numarası girilmesi zorunludur)

MÜŞTERİ TİPİ 1 karakter E M:Müşteri, P:Portföy F:Fon (Paya/fona Borsa İstanbul tarafından otomatik kotasyon ataması yapılması durumunda, üye tarafından ilgili menkul kıymete son girilen kotasyonun müşteri tipi kullanılacaktır. Piyasa yapıcı üyenin bir paya/fonda piyasa yapıcılığa başladığı ilk gün Borsa İstanbul İşlem Sistemi tarafından otomatik kotasyon girişi yapılırsa piyasa yapıcı üyenin Borsa İstanbul’a bildirdiği hesap numarası ve müşteri tipi kullanılacaktır)

(Kotasyon girilirken bu alanda ExAPI kullanıcısı tarafından müşteri tipinin belirtilmesi zorunludur.)

ACENTE / FON KODU (AFK)

3 karakter H Bir banka ile acentelik sözleşmesi imzalamış olan aracı kurumlar, aracı kurumda hesabı olmayan banka müşterileri için ilettiği emirlerde hesap numarası alanına, müşterilerin acente bankada açık olan hesap numaralarını ve yeni eklenen üç haneli AFK alanına ise, hesabın ait olduğu acentenin üye kodunu gireceklerdir.Ayrıca, sisteme müşteri tipi “fon” olarak belirtilerek girilen kotasyon emirlerinde, bu fon/yatırım ortaklıklarına Borsa İstanbul tarafından verilmiş olan 3 haneli kodların AFK alanına kaydedilmesi, hesap numarası alanına ise, fon/yatırım ortaklığının sayısal hesap numarasının, sayısal hesap numarası yok ise AFK alanına girilmiş olan fon/yatırm ortaklığı kodunun yeniden girilmesi zorunludur.Sola dayalıdır, AFK bilgisinin girilmemesi durumunda boşluk karakterleri bırakılmalıdır.Paya/fona Borsa İstanbul tarafından otomatik ilk kotasyon ataması yapılması durumunda, üye tarafından ilgili menkul kıymete son girilen kotasyonda AFK girilmişse bu AFK kodu kullanılacaktır.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 78 karakter veri ve 12 karakter alanlar arası boşluk olmak üzere, toplam 90 karakterdir.

Mesaj Örnekleri

K 00000001 K AAA01 V 00003200 0000038.50 0000039.00 00001000 REFRNS HESAPNOHESAPNOH P A8FK 00000002 K ISYAT E 00001200 0000002.38 0000002.40 00002040 REFRNS 123456789012345 P 123K 00000003 K DJIST F 00001500 0000004.00 0000004.60 00001770 XYZ 123456789012345 M 123K 00000005 K VRNT5 V 00001200 0000038.50 0000039.00 00001040 REFRNS HESAPNOHESAPNOH P A8FK 00000006 K AKYO E 00000000 0000002.40 0000002.40 00001000 REFRNS 123456789012345 P (taban fiyattan satış kotasyonu verilmesi durumu)K 00000006 K DJIST F 00001000 0000012.50 0000012.50 00000000 REFRNS 123456789012345 M P12 (tavan fiyattan alış kotasyonu verilmesi durumu)0--------1---------2---------3---------4---------5---------6---------7---------8

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 37

Page 39: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.1.4.2 Yeni Kotasyon Giriş Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne göndermiş olduğu kotasyonun sisteme kabul edilmesiyle oluşan bilgiyi alır.

Buradaki önemli nokta, bu mesajın sadece ilgili emirin sisteme girildiğine dair bir mesaj olmasıdır. Kotasyon, bu aşamadan sonra sistemde herhangi bir sebeple iptal edilebilir. Bundan dolayı, yukarıda bahsedilen “İstek Red Mesajı” ayrı bir yoldan (asenkron kanal) üye sistemine ulaştırılacaktır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E K: Yeni Kotasyon emiri anlamında.LOG SIRA NUMARASI 14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına

yazılan bilgilerin sıra numarası.İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı

belirtir. HH:MM:SS formatındadır.KOTASYON NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen kotasyon numarası. Önünde sabit

“KOTASYON“ ifadesi ve 1 karakter boşluk yer alır.PAY İŞLEM SIRASI ve SERİ KODU (*)

8 karakter E Kotasyonun ait olduğu payın kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIS MİKTARI (*) 8 hane nümerik E Kotasyonda verilen Alış miktar. Lot olarak belirtilir.ALIS FİYATI (*) 8 hane noktalı

nümerikE Gönderilmiş olan kotasyon emir giriş isteğinde belirtilen alış fiyatı.

SATIS FİYATI (*) 8 hane noktalı numeric

E Gönderilmiş olan kotasyon emir giriş isteğinde belirtilen satış fiyatı.

SATIS MİKTARI (*) 8 hane nümerik E Kotasyon emrindede verilen miktar. Lot olarak belirtilir.GEÇERLİLİK SÜRESİ 2 hane nümerik E 00:Seanslık Kotasyon, 01:Günlük Kotasyon (Paya veya fona

kotasyon girişinde kotasyonun geçerlilik süresi İşlem Sistemi tarafından otomatik olarak tek seanslık, Varantta ve sertifikada ise İşlem Sistemi tarafından otomatik olarak günlük (1 işgünlük) olarak kaydedilir, ExAPI kullanıcısının kotasyonun geçerlilik süresini belirlemesine izin verilmez.)

ACENTE / FON KODU (AFK)

3 karakter H Sola dayalı olup 3 karakter uzunluğundadır

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonHESAP NO (*) 15 karakter E Sola dayalı olup maksimum 15 uzunluğundadır.REFERANS (*) 6 karakter H Sola dayalı olup maksimum 6 uzunluğundadır.ALIS EMİR NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen Alış emir numarası.SATIS EMİR NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen Satış emir numarası.SIRA NUMARASI(*) 8 hane nümerik E Kurum içi sıra numarası.AÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Kotasyon girildiğinde İşlem Sistemi tarafından kotasyona 3 tane numara verilmektedir. Bunlardan biri “Kotasyon numarası”dır. Kotasyon numarası seans boyunca hiç değişmez. Kotasyona verilen diğer iki numaradan biri “Kotasyonun Alış Tarafının Emir Numarası” diğeri ise “Kotasyonun Satış Tarafının Emir Numarası”dır. Kotasyonun alış ve satış emir numaraları kotasyonda değişiklik yapıldıkça değişmektedir. Diğer bir ifadeyle kotasyonun alış/satış tarafının miktarı ya da fiyatı değiştirildiği zaman kotasyonun fiyatı ya da miktarı değişen alış/satış tarafının emir numarası da değişmektedir. (kotasyonun alış/satış tarafının sadece miktarının azaltılması durumunda miktarı azaltılan kotasyonun alış/satış tarafının emir numarası değişmez, diğer tüm değişikliklerde kotasyonun emir numaraları değişir.)

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

K 43162082410578 10:39:11 KOTASYON 0107200900000010 EGCYO.E 2500 0.55 0.57 2500 00 A1K PORT HESAP1598754 REFREF 0107200900000008 0107200900000009 4 İSTENDİ

K 43162060065568 10:33:30 KOTASYON 0107200900000007 ISGYO.E 2500 1.00 1.03 2500 00 MÜŞ HESAP1598754 REFREF 0107200900000005 0107200900000006 3 İSTENDİ

K 43162044302734 10:29:29 KOTASYON 0107200900000004 ERC03.V 2500 5.83 5.85 2500 01 MÜŞ HESAP1598754 0107200900000002 0107200900000003 2 İSTENDİSürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 38

Page 40: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.4.3 Yeni Kotasyon Giriş Hata Cevabı

Bu mesaj, üye sisteminden gelen yeni emir isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. kotasyon emrinin 3.1.5.1’de belirtilen yapıda olmaması, fiyatın marj dışında kalması, adım hatası, Yeni kotasyon ataması istenen menkul kıymette halen kotasyon bulunması vs.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir girişi anlamında.AÇIKLAMA (**) 198 karakter E İlgili kotasyon emrinin reddedilme nedeni.

Reddedilme nedenine bağlı olarak değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmıştır. Mesaj, hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen açıklama alanında, emirin hatalı olduğu durumun açıklaması ile birlikte emir detay bilgisi bulunur.

Mesaj Örnekleri

H İMKB Ex-API İletişim Ekranı açılmamışH Mesaj içeriği yanlış.H Mesaj uzunluğu işlem kodu ile uyumlu değildir.H Açılış seansında kotasyon girilemez.H Acente/Fon kodu alanında uygun olmayan karakterler var.H Hisse seri kodu alanında uygun olmayan karakterler var.H Emir tipi M, P ya da F olmalıdır.H Hisse özellik kodu alanında uygun olmayan karakterler var.H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır.H Kurum içi emir sıra numarası alanında uygun olmayan karakterler var.H Alış Fiyat alanında uygun olmayan karakterler var.H Satış Fiyat alanında uygun olmayan karakterler var.H Alış Miktar alanında uygun olmayan karakterler var.H Satış Miktar alanında uygun olmayan karakterler var.H Minimum kotasyon miktarından büyük olmalıdır.H Maksimum kotasyon miktarından küçük olmalıdır.H Kotasyon değiştirilmedi. KOTASYON: ISGYO.E 2500 1.00 1.03 2500 H Yayılma aralığının dışında.H Yayılma aralığı sıfır olamaz.H Varant Kotasyonunda Hesap No, M/P/F alanlarına geçerli veri giriniz.H Sertifika Kotasyonunda Hesap No, M/P/F alanlarına geçerli veri giriniz.H Menkul Kıymette Geçerli Kotasyon Vardır Kotasyon Girilemez. H Bu Isleme Acilis Oncesi Izin Verilmiyor.

H Kurumsal Urunler Pazari Kapali. Islem Yapamazsiniz.H Gelismekte Olan Isletmeler Piyasasi Kapali. Islem Yapamazsiniz.H Kotasyon emriniz bulunamadi.H Menkul Kıymete kotasyon girilemez.H Menkul Kıymetin piyasa yapıcısı değilsiniz.H Yanlış işlem kodu gönderildi.H ALIŞ kotasyon fiyatı SATIŞ kotasyon fiyatına eşit olamaz.H ALIŞ kotasyon fiyatı SATIŞ kotasyon fiyatından büyük olamaz.H ALIŞ kotasyon fiyatı SATIŞ emir fiyatından büyük olamaz, SATIŞ FİYATI : 1.59 .H SATIŞ kotasyon fiyatı ALIŞ emir fiyatından küçük olamaz, ALIŞ FİYATI : 1.60 .H Fiyat 0 ya da boş olamaz.H Açılış seansında kotasyon girilemez.H Menkul Kıymete Açılış Seansında Kotasyon Girilemez.H Bu Hissenin İşlemleri Durdurulmuştur. Emir Girilemez.H Yanlış işlem kodu gönderildi.H Menkul Kıymet Kapatılmıştır. Kotasyon Girilemez.H AFK alanının uzunluğu 3’den küçük olamaz.H Kapanış seansında kotasyon girilemez.Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 39

Page 41: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.5 Kotasyon Değiştirme

Piyasa yapıcı üye tarafından veya piyasa yapıcı üye hesabına İşlem Sistemi tarafından ilk kotasyon girişi yapıldıktan sonra, işlem görüp miktarı tamamen sıfırlansa bile İşlem Sistemi’ne yeni bir kotasyon girişi yapılamayacak sadece kotasyon üzerinde değişiklik yapılabilecektir.

Piyasa yapıcı üye, kotasyonun fiyatını kurallar çerçevesinde kalmak kaydıyla iyileştirebileceği gibi kötüleştirebilecek, miktarını kotasyon miktarı sınırlarına ilişkin kurallar çerçevesinde arttırabileceği gibi azaltabilecektir.

Sürekli müzayede aşaması içinde payın/fonun işleme durdurulması sürecinde veya sürekli müzayede aşaması içinde payda/fonda yapılan açılış seansı sonrasında yapılacak otomatik işleme durdurulma süreci içinde de kurallar çerçevesinde paydaki/fondaki kotasyonun fiyatı kötüleştirilebileceği gibi iyileştirilebilecek, miktarı arttırılabileceği gibi azaltılabilecektir.

Kotasyonun miktarı işlem görerek tamamen tükenmişse ve piyasa yapıcı üye kendisine tanınan süre içinde (3 dakika içinde) miktarı tükenen kotasyonunun miktarını en az kotasyon miktarına kadar değiştirmemişse, Sistem piyasa yapıcı üye hesabına kotasyonun miktarı tükenen taraf(lar)ı için minimum kotasyon miktarı kadar kotasyonu otomatik olarak girecektir. Bu durumda kotasyonu Sistem’e ilk giren temsilciye “Kotasyon değiştirme cevap mesajı” gitmeyecek sadece “Kotasyon Güncellendi Bilgisi mesajı” gönderilecektir.

3.1.5.1 Kotasyon Değiştirme Mesajı

Bu mesaj ile üye, daha önce elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletmiş olduğu kotasyon emirlerini kotasyon değiştirme kuralları dahilinde kalarak değiştirebilir.

Burada da -yeni kotasyon girişinde olduğu gibi- yapılan kotasyon değiştirme isteği, İşlem Sistemi tarafından reddedilebilir. Bu takdirde, ilgili Kotasyon Değiştirme mesajına ait bir İstek Red Bilgisi mesajı ayrıca asenkron kanaldan Üye Sistemi’ne gönderilir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E M: Kotasyon DeğiştirmeKOTASYON NUMARASI

16 hane nümerik E Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından verilen kotasyon numarası.

PAZAR KODU 1 karakter E N:Ulusal, L: İkinci Ulusal veya Yeni Ekonomi, Y: Yeni Ekonomi veya İkinci Ulusal, W:Gözaltı, K: Kurumsal Ürünler Pazarı, S: Serbest İşlem Platformu, G: Gelişen İşletmeler Piyasası

MEVCUTALIMMİKTARI

8 hane nümerik E Üye sistemi tarafından kotasyon değiştirme isteğinin gönderildiği anda kotasyondaki alım emrinin bilinen miktarı. Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

MEVCUTALISFİYATI

10 hane noktalı nümerik

E Üye sistemi tarafından kotasyon değiştirme isteğinin gönderildiği anda alış emrinin bilinen fiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

MEVCUTSATISFİYATI

10 hane noktalı nümerik

E Üye sistemi tarafından kotasyon değiştirme isteğinin gönderildiği anda satış emrinin bilinen fiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

MEVCUTSATISMİKTARI

8 hane nümerik E Üye sistemi tarafından kotasyon değiştirme isteğinin gönderildiği anda satış emrinin bilinen miktarı. Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

YENİALIMMİKTARI

8 hane nümerik E Kotasyonun alış emrinin yeni miktarı. Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

YENİALISFİYATI

10 hane noktalı nümerik

E Kotasyonun alım emrinin yeni fiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

YENİSATISFİYATI

10 hane noktalı nümerik

E Kotasyonun satış emrinin yeni fiyatı. 10 hanenin ilk yedi hanesi lira, sekizinci hanesi kuruş ayracı olan nokta (.) ve son iki hanesi ise kuruş içindir. Fiyat bilgisi sağa dayalı olup, soldaki boş haneler sıfır olacaktır. 1 YTL’nin altındaki fiyatlar için “0000000.xx” şeklinde giriş yapılması zorunludur.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 40

Page 42: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaYENİSATISMİKTARI

8 hane nümerik E Kotasyonun satış emrinin yeni miktarı .Sağa dayalı, soldaki boş haneler sıfır olacak. Lot olarak belirtilir.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 90 karakter veri ve 10 karakter alanlar arası boşluk olmak üzere, toplam 100 karakterdir.

Mesaj Örnekleri

M 3001200900000005 K 00000580 0000036.50 0000037.00 00000010 00003080 0000036.50 0000037.00 00002000M 1903200900002082 K 00001200 0000009.80 0000010.00 00002040 00001200 0000009.80 0000010.00 00004040M 1903200900002190 K 00001200 0000001.50 0000001.54 00002000 00001200 0000001.50 0000001.54 00001000M 1903200900002190 K 00001000 0000001.53 0000001.54 00002000 00000000 0000001.53 0000001.53 00001000kotasyonun taban fiyattan satış kotasyonu olarak değiştirilmesi durumunda)M 1903200900002190 K 00001000 0000005.50 0000005.55 00001000 00001000 0000005.55 0000005.55 00000000(kotasyonun tavan fiyattan alış kotasyonu olarak değiştirilmesi durumunda)0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.5.2 Kotasyon Değiştirme Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI PC’si vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne göndermiş olduğu kotasyon değiştirme isteğinin İşlem Sistemi tarafından kabul edilmesiyle oluşan bilgiyi senkron kanaldan alır. Kotasyonu İşlem Sistemi’ne ilk giren ExAPI kullanıcısından başka bir kullanıcı (ExAPI ya da şef broker) tarafından yapılan değiştirme isteklerine karşı İşlem Sistemi’nden gelen cevap mesajları ile asenkron kanaldan “Kotasyon Bilgisi Güncelleme” mesajı olarak üye sistemine aktarılacaktır.

Örnek : A temsilcisi/ExAPI kotasyon girdi, B temsilcisi/ExAPI değiştirdi. B değişikliği yaptığı anda :

Kotasyon değiştirene (B) giden mesaj :

M 40742037091386 19:59:07 KOTASYON 1903200900002082 HDFYO.E 1200 9.80 10.00 3040 İSTENDİ

Kotasyonu ilk girene (A) giden mesaj :

P 40742037091674 19:59:07 KOTASYON 1903200900002082 HDFYO.E ALIS 1903200900002143 1200 LOT 9.80 GUNCELLENDI.

P 40742037091674 19:59:07 KOTASYON 1903200900002082 HDFYO.E SATIS 1903200900002144 3040 LOT 10.00 GUNCELLENDI.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E M: Kotasyon değiştirmeLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

KOTASYON NUMARASI

16 hane nümerik E İşlem Sistemi tarafından verilen kotasyon numarası. Önünde sabit “KOTASYON“ ifadesi ve 1 karakter boşluk yer alır.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIŞ MİKTARI (*) 8 hane nümerik E Kotasyonun alış tarafının en son güncellenmiş miktarıALIŞ FİYATI (*) 8 hane noktalı

nümerikE Kotasyonun alış tarafının en son güncellenmiş fiyatı.

SATIŞ FİYATI (*) 8 hane noktalı nümerik

E Kotasyonun satış tarafının en son güncellenmiş fiyatı.

SATIŞ MİKTARI (*) 8 hane nümerik E Kotasyonun satış tarafının en son güncellenmiş miktarıAÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 41

Page 43: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

M 40742037091386 19:59:07 KOTASYON 1903200900002082 HDFYO.E 1200 9.80 10.00 3040 İSTENDİM 40762348859870 09:42:56 KOTASYON 2503200900001051 AKYO.E 1000 32.00 33.00 2000 İSTENDİ M 43163894330706 18:19:58 KOTASYON 0107200900000004 ERC03.V 100 5.83 5.85 2500 İSTENDİM 43332863578281 11:26:22 KOTASYON 0107200900000056 ERC02.V 0 0.70 0.80 25000 İSTENDİ0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.5.3 Kotasyon Değiştirme Hata Mesajı

Bu mesaj, üye sisteminden gelen kotasyon değiştirme isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. değiştirilmek istenen kotasyon numarasının sistemde bulunamaması, yeni fiyat ve miktar alanlarının orijinal emirdekilerle aynı olması durumu, vs.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı değiştirme isteğianlamında.AÇIKLAMA (**) 198 karakter E İlgili emrin/isteğin reddedilme nedeni. Reddedilme nedenine bağlı

olarak değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen alanlarda, emirin hatalı olduğu durumu açıklayan bilgi ile birlikte emir detay bilgisi yer alır. Tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

H Kotasyon bulunamadı. Yanlış Kotasyon numarası girdiniz.H Mesaj içeriği yanlış.H Emir bilgileri değiştirilmedi. İyileştirme yapılamaz.

H Kurumsal Urunler Pazari Kapali. Islem Yapamazsiniz.H Gelismekte Olan Isletmeler Piyasasi Kapali. Islem Yapamazsiniz.H İşlem kodu Y,D,I,U,K,M ya da N olabilir.H Sistem isleme kapatilmistir.H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır.H HATA - Bu Emir size ait degil.H Kotasyon değişmiş. Tekrar deneyiniz. KOTASYON: HDFYO.E 1000 1.86 1.87 1000H Ana Makina isteğinize cevap vermiyor.H Kotasyon emriniz bulunamadi.H Ana Sistemden alınan işlem kodu geçersizdir.Destek birimini arayınız.H Kotasyon değiştirilmedi. KOTASYON: EVNYO.E 1200 0.66 0.70 10400--------1---------2---------3---------4---------5---------6---------7---------8

Not : Değiştirme isteği sisteme gönderildiğinde piyasanın kapalı olması durumunda payın dahil olduğu piyasaya bağlı olarak başındaki ifade değişerek yukarıdaki mesaj örneklerinden dördüncü sırada yer alan mesaj benzeri bir hata cevabı üye sistemine gönderilecektir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 42

Page 44: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.1.6 Terminal Durum Güncelleme

3.1.6.1 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Mesajı

ExAPI üzerinden gönderilecek “K” ve “A” işlem tiplerindeki temsilci başlatma/durdurma mesajlarıyla, ilgili üyeye ait temsilci terminallerinin durdurulması veya tekrar başlatılması mümkün olabilecektir. Bu sayede, durdurulan işlem terminalleri kodlarıyla işlem yapılması mümkün olmayacaktır.

Temsilci terminallerinden yapılan işlemlerin yönlendirildiği ExAPI terminalinin numarası İşlem Sistemi üzerinde tutulmaktadır. “G” işlem tipindeki mesajlarla üyeler, herhangi bir ExAPI üzerinden bu numarayı güncelleyebilecek ve yeni bir ExAPI terminalini bu amaçla yetkilendirebileceklerdir. Böylece, ilgili üyenin temsilcileri tarafından yapılan işlemler güncellenen ExAPI terminaline gönderilmeye başlanacaktır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E L: Terminal durumu güncelleme mesajıİŞLEM TİPİ 1 karakter E Güncelleme işlemi sırasında yapılacak işlem.

A : Temsilci terminali yeniden işleme açılacakK : Temsilci terminali durdurulacakG : Temsilci mesajlarının yönlendirileceği ExAPI kodu

güncellenecekTEMSİLCİ/ExAPI NO 4 hane nümerik E Durum güncellemesi yapılacak ExAPI veya Temsilci Numarası.

Sağa dayalı olup soldaki hanelerin sıfırla doldurulması gerekmektedir.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 6 karakter veri ve 2 karakter alanlar arası boşluk olmak üzere, toplam 8 karakterdir.

Mesaj Örnekleri

L A 0298L K 0298L G 0026

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.6.2 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Cevap Mesajı

Bu mesaj ile üye, temsilci başlatma/durdurma ve ExAPI yetkilendirme isteğinin HSP İşlem Sistemi’ne ulaştığını anlamaktadır. Bu cevap sadece isteğin kabul edildiğini belirtir. Eğer herhangi bir nedenle, istek İşlem Sistemi tarafından iptal edilirse, iptal nedeni asenkron kanaldan gönderilecektir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E L: Terminal durumu güncelleme mesajıLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

TERMİNAL NUMARASI(*)

4 hane nümerik E Durum güncellemesi yapılacak temsilci veya ExAPI terminalinin numarası. Önünde sabit “TERMİNAL“ ifadesi ve 1 karakter boşluk yer alır.

YENİ DURUM 1 karakter E A: İşleme Açılacak , K: İşleme Kapatılacak, G: ExAPI Terminali Yetkilendirilecek

AÇIKLAMA (**) X karakter E Durum güncelleme isteğinin sisteme ulaştığını gösteren “İSTENDİ” ifadesi.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

L 43212798651667 08:42:40 TERMİNAL 26 K İSTENDİL 43212830043382 08:50:39 TERMİNAL 26 A İSTENDİL 43212903344452 09:09:17 TERMİNAL 927 G İSTENDİSürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 43

Page 45: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.1.6.3 Temsilci Başlatma/Durdurma ve ExAPI Yetkilendirme Hata Mesajı

Bu mesaj, Üye sisteminden gelen terminal durum güncelleme isteklerinini, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. Durdurulmak istenilen terminalin ilgili üyeye ait olmaması durumu vb.) oluşan hata bilgisini içerir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı Temsilci Başlatma/Durdurmaisteği anlamında.AÇIKLAMA (**) 198 karakter E İlgili isteğin reddedilme nedeni. Reddedilme nedenine bağlı olarak

değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen alanlarda, hatalı olan durumu açıklayan bilgi ile birlikte istek detay bilgisi yer alır. Tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

H Mesaj uzunluğu işlem kodu ile uyumlu değildir.

H Temsilci alanında uygun olmayan karakterler var.

H İşlem Tipi alanına geçersiz karakter girilmiş.

H Kullanici Kodu Sistemde Yok.

H Hatalı Terminal Numarası.

H Hatalı Terminal Durumu.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.2 Sorgu (Inquiry) İstek ve Cevap Mesajları

3.2.1 Emir Durum Sorgusu

3.2.1.1 Emir Durum Sorgusu Mesajı

Bu mesaj ile üye, daha önce elektronik ortam üzerinden Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletmiş olduğu emirlerden (normal emir, kotasyon emri), sistemde beklemekte olanlarını sorgulayabilir.. Bu mesaj tipi ile gönderilen emirlerin İşlem Sistemi tarafından alındıktan sonraki durumlarını içeren bilgileri (bekleyen, kısmi gerçekleşme, değişme, vs.), bu mesajın cevabı olarak senkron kanaldan Emir Durum Sorgusu Cevap mesajı içerisinde Üye Sistemi’ne geri döner.

Sistemdeki tüm ExAPI kullanıcıları emir durum sorgusu yapabilme konusunda “Yönetici” yetkisinde olduklarından dolayı, kendileri tarafından girilmiş olsun olmasın, bağlı bulundukları kuruma ait olan tüm emirleri, ExAPI vasıtasıyla sorgulayabileceklerdir.

Kotasyon girişi veya değiştirme sırasında Borsa İstanbul Sistemi tarafından verilen alış ve satış emir numaraları kullanılarak, kotasyon emirlerinin durumu da sorgulanabilecektir. Ancak, kotasyon numarası kullanılarak emir durum sorgusu yapılamayacaktır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E U: Emir Durum Sorgusu anlamındaEMİR NUMARASI 16 hane nümerik E Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından verilen

genel emir numarası.PAZAR KODU 1 karakter E N:Ulusal, L: İkinci Ulusal veya Yeni Ekonomi, W:Gözaltı, Y: Yeni

Ekonomi veya İkinci Ulusal, K: Kurumsal Ürünler Pazarı, S: Serbet İşlem Platformu, G: Gelişen İşletmeler Piyasası

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 18 karakter veri ve 2 karakter alanlar arası boşluk olmak üzere, toplam 20 karakterdir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 44

Page 46: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Mesaj Örnekleri

U 2006200000001941 K0--------1---------2---------3---------4---------5---------6---------7---------8

3.2.1.2 Emir Durum Sorgusu Cevap Mesajı

Bu mesaj ile üye, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla Borsa İstanbul Pay Piyasası Alım Satım Sistemi’ne iletmiş olduğu emir durum sorgusunun İşlem Sistemi tarafından döndürülen sonucunu içeren bilgilerini alır.

Yapılan emir durum sorgusu isteği, varolan bir emir için yapıldığında, sorgulanmak istenen emir işleme girip kısmen karşılanmışsa ya da emir değiştirilmişse bu emrin durumunu açıklayan bilgileri alır. Girilen kotasyonlar için emir durum sorgusu kotasyonun alış ve satış tarafları için ayrı ayrı alış/satış emir numaraları girilerek yapılabilecektir.

Geçerli Emir Durum Sorgusu’na dönen cevap mesajı görünümü:

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E U: Emir Durum Sorgusu anlamındaEMİR NUMARASI 16 hane nümerik E Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından verilen

genel emir numarası.SORGU ZAMANI 8 karakter E İlgili emrin durumunun üyeye belirtildiği zamanı gösterir.

HH:MM:SS formatındadır.PAY ISLEM SIRASI ve SERİ KODU

8 karakter E Emrin ait olduğu işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIŞ/SATIŞ 5 karakter E “ALIŞ ”: Alış Emri, “SATIŞ”: Satış Emri, AÇSAT: Açığa Satış Emri,

MÜŞTERİ TİPİ 4 karakter E “MÜŞ “:Müşteri, “PORT”:Portföy, “FON ”:FonORİJİNAL MİKTAR 8 hane nümerik E İlgili emirde ilk girilen ya da emir değiştirilmişse değişen miktar.

Lot olarak belirtilir. Sağa dayalı olup soldaki boş haneler sıfır ile doludur.

FİYAT 10 hane noktalı nümerik

E İlgili emirde verilen fiyat Sağa dayalı olup soldaki boş haneler sıfır ile doludur. Açılış/kapanış fiyatlı emirler için ise tüm haneler sıfır ile dolu olacaktır (0000000.00).

HESAP NO 15 karakter E İlgili emirde verilen hesap numarası. 15 karakterden az ise ya da hesap numarası girilmemişse bu alan boşluk karakterleriyle 15’e tamamlanır.

REFERANS 6 karakter E İlgili emirde verilen referans bilgisi 6 karakterden az ise ya da referans numarası girilmemişse bu alan boşluk karakterleriyle 6’ya tamamlanır.

KALAN MİKTAR 8 hane nümerik E İlgili emirde karşılanmadan kalan miktar. Lot olarak belirtilir. Sağa dayalı olup soldaki boş haneler sıfır ile doludur.

GERÇEKLEŞEN MİKTAR

8 hane nümerik E İlgili emrin gerçekleşen miktarı. Lot olarak belirtilir. Sağa dayalı olup soldaki boş haneler sıfır ile doludur.

GİRİŞ TARİHİ 9 karakter E GG AAA YY formatında emrin giriş tarihi.GİRİŞ SAATİ 8 karakter E HH:MM:SS formatında emrin giriş zamanıGEÇERLİLİK BİLGİSİ 3 karakter E GÜN:Seanslık Emir, TAR:Günlük Emir.DURUM BİLGİSİ 3 karakter E BEK: Bekleyen, DEĞ: Değiştirilmiş, İPT: İptal Edilmiş anlamındaAÇIKLAMA (**) x karakter E Sorgulanan emirin özelliklerine bağlı olarak değişen uzunluklarda

olan ve çeşitli açıklama ifadelerini içeren alandır.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer boşluk karakteri ile ayrılmış haldedir.

Mesaj Örnekleri

U 2006200000001936 11:55:10 ANHYT.E ALIŞ MÜŞ 00000100 0000005.50 ACCOUNTACCOUNTA REFREF 00000100 00000000 20 HAZ 00 11:40:24 GÜN BEKU 2006200000001937 11:56:14 ANHYT.E SATIŞ PORT 00000100 0000005.50 ACCOUNTAC 00000097 00000003 20 HAZ 00 11:41:24 GÜN BEKU 2006200000001938 11:58:45 ANHYT.E ALIŞ MÜŞ 00000099 0000000.98 ACCOUNT REF 00000099 00000000 20 HAZ 00 11:42:24 TAR BLNU 2006200000001939 11:58:46 ANHYT.E ALIŞ MÜŞ 00000200 0000027.25 REF001 00000100 00000000 20 HAZ 00 11:40:24 TAR BEK U 3012200300000015 11:21:54 ARAT.E AÇSAT MÜŞ 00000010 0000009.10 123456789012345 REFRNS 00000010 00000000 05 OCA 04 11:18:43 GÜN BEKU 0106200400000087 09:56:14 ISCTR.E ALIŞ MÜŞ 00000012 0000004.96 MNY 00000012 00000000 01 TEM 04 14:50:18 GÜN BLN

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 45

Page 47: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

U 1210200500000159 11:21:29 AKBNK.E ALIŞ MÜŞ 00000100 0000000.00 123456789012345 123456 00000100 00000000 21 EKI 05 11:21:00 GÜN BEK0--------1---------2---------3---------4---------5---------6---------7---------8

3.2.1.3 Emir Durum Sorgusu Hata Mesajı

Bu mesaj, Üye sisteminden gelen emir durum sorgusu isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde (örn. durumu öğrenilmek istenen emirin gerçekleşmiş olması ya da bu sorguya karşılık sistemden kaynaklanan bir durumdan dolayı yanıt alınamaması, vs.) oluşan hata bilgisini içerir.

Geçersiz/Hatalı Emir Durum Sorgusu’na dönen cevap mesajı görünümü:

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir durum sorgusu veya sistem cevap vermiyor

anlamında.AÇIKLAMA (**) 198 karakter E İstenen Emir Durum Sorgusu’na ait emrin olmadığını ya da

karşılanmış olduğunu belirten sabit bir ifadeyi içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Mesaj Örnekleri

H Mesaj içeriği yanlış.H Emir numarası alanında uygun olmayan karakterler var.H HATA - Bu Emir size ait degil.H İşlem kodu Y,D,I,U,K,M ya da N olabilir. H Yanlış işlem kodu gönderildi.H Emir bulunamadı. Yanlış Emir numarası girdiniz veya Emir gerçekleşmiş.H Ana Makina isteğinize cevap vermiyor.H Piyasa kodu N, L, W, K, G, Y ya da S olmalıdır. H Mesaj uzunluğu işlem kodu ile uyumlu değildir.H Kapanis Seansinda Bu Sorgu Yapilamaz.0--------1---------2---------3---------4---------5---------6---------7---------8

Not : Başka bir aracı kurumun kullanıcısı tarafından girilmiş olan emirler için emir durum sorgusu yapılamayacaktır. Bu durumda yukarıdaki hata mesajı örneklerinden üçüncüsü üye sistemine iletilecektir.

3.2.2 Biriken Mesajları Üye Sistemine İndirme Mesajı

3.2.2.1 Biriken Mesajları Üye Sistemine İndirme Mesajı

Herhangi bir sebeple Borsa İstanbul ExAPI PC ile Üye Sistemi arasındaki bağlantı koptuğunda Borsa İstanbul ExAPI PC’de biriken çeşitli mesajların Üye Sistemine gönderilmesini sağlamak amacıyla kullanılır.

Bağlantı tekrar kurulduğunda, Üye Sistemi tarafında çalışan program, bağlantının kopuk durumda olduğu zaman süresince Borsa İstanbul ExAPI PC’de birikmiş olan mesajları almak için bu mesaj ile ilgili isteği senkron kanaldan Borsa İstanbul ExAPI PC’ye göndererek, Borsa İstanbul ExAPI tarafında biriken mesajların Üye Sistemi’ne indirilmesini sağlamalıdır.

Üye Sistemi, son aldığı sıra numarası bilgisini bu mesajın içeriğine yazarak senkron kanaldan Borsa İstanbul ExAPI PC’ye gönderir. Borsa İstanbul ExAPI PC ise, Üye sistemine iki aynı kanaldan cevap gönderir. Senkron kanaldan, başlayan işlemi (transaction) bitirmek amacıyla bu isteğe karşılık o an için kaç mesaj indirilebileceği bilgisini içeren bir yanıt döner. Asenkron kanaldan ise, ExAPI PC’sinin log dosyası okunarak istenilen işlemin tipine göre (istek mesajındaki İŞLEM TİPİ alanında belirtilir), biriken mesajlardan üyenin “sıra numarası” ile bildirdiği mesaj kaydından sonraki ilk kayıttan başlanarak (ki, normal olarak üye en son aldığı mesaj sıra numarasını girecektir ve ExAPI PC de, Üye Sistemi’ne gönderilmemiş olanlar içerisindeki en eski olan mesaj kaydından başlayarak) Biriken Mesajları Üye Sistemine İndirme Cevap mesajını Üye Sistemi’ne gönderir.

Bu işlemde, biriken mesajların Borsa İstanbul ExAPI PC’sinden gönderilmesi asenkron kanaldan sürekli olarak yapıldığından üye tarafında çalışan programların bu yapıya uygun olarak tasarlanmış olması gereklidir. Borsa İstanbul ExAPI PC’den Üye Sistemi’ne gönderilen mesajlar bu dökümandaki cevap mesajlarında belirtilen mesaj yapısıyla üyenin ortamına ulaştırılır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E N: Biriken mesajları iNdir anlamında

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 46

Page 48: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM TİPİ 1 karakter E Biriken mesajlardan hangilerinin Üye Sistemi’nce istendiğini

belirtir.H : HepsiY : Yeni emir giriş isteğiK : Kotasyon giriş isteğiD : Emir değiştirme İstekleriM: Kotasyon değiştirme isteğiI : Emir iptal isteği (Kullanıcı isteği)T : Emir iptali [Kullanıcı, eksper ya da sistem kaynaklı]S : İşlemP : Kotasyon Güncelleme Bilgi MesajlarıZ : İşlem ÖzetiR : İstek red cevapları (sistem kaynaklı)G: Genel yayın mesajlarıA:. Temsilci Emir GirişC: Temsilci Emir Değiştirme.F: Temsilci Emir iptaliE: Temsilci işlemiJ: Temsilci kotasyon girişiO: Kotasyon güncelleme.

LOG SIRA NUMARASI

14 hane nümerik E Üyenin en son aldığı cevap mesajındaki mesajın LOG SIRA NUMARASI bilgisi.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış olmalıdır.

Bu mesajın uzunluğu; 16 karakter veri ve 2 karakter alanlar arası boşluk olmak üzere, toplam 18 karakterdir.

Mesaj Örnekleri

N H 99341810098078 (Tüm mesajlar) (Üye 99341810098078’den itibaren tüm mesajlerı istemekte)

N S 99341810242221 (Sadece işlem mesajları)N T 99341810386980 (Sadece emir iptal mesajları)N Y 99341810565015 (Sadece yeni emir giriş mesajları)N K 99341810566057 (Sadece yeni kotasyon giriş mesajları)N M 99341810568058 (Sadece kotasyon değiştirme mesajları)N A 00000000000001 (Temsilci emir istekleri mesajları)

0--------1---------2---------3---------4---------5---------6---------7---------8

3.2.2.2 Biriken Mesajları Üye Sistemine İndirme Cevap Mesajı (senkron kanaldan)

Bu mesaj, Üye sisteminden gelen Biriken Mesajları Üye Sistemine İndirme isteği karşılığında ExAPI PC’sinden üye sistemine geri dönen cevap mesajıdır. İçeriğinde işlem kodundan sonra yer alan alanda, “log sıra numarası” bilgisine bağlı olarak hesaplanan kaç adet mesajın asenkron kanaldan gönderilebileceği bilgisi yer alır.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E N: Biriken mesajları iNdir anlamındaMESAJ SAYISI (**) 198 karakter E İstek mesajında yer alan “log sıra numarası” alanına göre ExAPI

PC’sindeki mesaj dosyasından hesaplanan, üye sistemine gönderilmeyi bekleyen mesajların sayısıdır.Bu sayı İşlem Kodu olarak ‘H’ (Hepsi) seçeneğinin aktif olması durumunda bulunan sayıdır. Bir başka deyişle Üye Sisteminin ExAPI PC’sinden kaç mesaj geride olduğunu gösterir Başka bir işlem kodu gönderildirinde burada yine hesaplanan tüm mesajların sayısı yer alırken, asenkron kanaldan üye sistemine gönderilen mesajların sayısı bundan az olacaktır.

(**) : Toplam 198 karakter olan bu alandaki 6 karakterlik “mesaj sayısı” bilgisinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer boşluk karakteri ile ayrılmış haldedir.

Mesaj Örneği

N 000125 (Üyenin 125 tane mesajı asenkron kanaldan indirilecektir [işlem kodu olarak ‘H’ seçilmişse])

N 000000 (Mesaj dosyası okunamaz ya da belirtilen şartlara [log sıra numarası, işlem kodu] uygun kayıt bulunamazsa)

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 47

Page 49: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.2.2.3 Biriken Mesajları Üye Sistemine İndirme Cevap Mesajları (asenkron kanaldan)

Bu mesaj ile üye, herhangi bir bağlantı kopukluğu sonrasında, bağlantının olmadığı süre boyunca alamadığı mesajları elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla Borsa İstanbul ExAPI PC’sinden alır.

Gelen cevap mesajının formatı, ait olduğu cevap mesajına bağlı olarak, bu dökümanda belirtilen; Yeni Emir Giriş Cevabı, Yeni kotasyon Giriş Cevabı, Emir Değiştirme Cevabı, Kotasyon Değiştirme Cevabı Emir İptal Cevabı, İşlem Bilgisi , Kotasyon Güncelleme Bilgisi İşlem Özeti Bilgisi, İstek Red Bilgisi, Temsilci Emir Giriş, Temsilci Emir Değiştirme, Temsilci Emir iptali, Temsilci işlemi, Temsilci kotasyon girişi, Kotasyon güncelleme

mesajlarının yapısındadır. Bunların dışında, seans sonlarında yapılan batch işlemleri neticesinde süresi dolan emirler için ve piyasada Pay Piyasası uzmanları tarafından kullanıcının bir emrinin iptali durumunda Emir İptal Cevap mesajı formatında bir mesaj Üye Sistemi’ne geri dönecektir. Bu yüzden aşağıdaki “Mesaj Örnekleri” kısmında sadece bu ilave durumlar için birer örnek verilmiştir.

Borsa İstanbul ExAPI PC’sinden asenkron kanal yoluyla gelen cevap mesajları en fazla senkron kanaldan gelen cevap mesajında yazılı sayı kadar gönderilir ve indirme işlemi sona erer.

Mesaj Örnekleri

T 0000010000000002 14:55:12 EMİR 2006200000001940 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN İPTAL EDİLDİ. Hisse Islemleri Durduruldu.(ilgili pay durdurulurken o paydaki tüm emirler de iptal edilmiş)T 0000010000000002 13:55:12 EMİR 2006200000001941 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN İPTAL EDİLDİ. Suresi biten emir.(seanslık girilen emir 1.seans sonu işlemlerinde iptal edilmiş)T 0000010000000002 16:25:31 EMİR 2006200000001942 SATIŞ 10 ANHYT.E 28.5 MÜŞ TAR 20 HAZ ACCOUNTACCOUNTA İPTAL EDİLDİ. Suresi biten emir.(günlük girilen emir 2.seans sonu işlemlerinde iptal edilmiş)T 0000010000000002 16:25:10 EMİR 2006200000001940 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN İPTAL EDİLDİ. GUN Emri.(seanslık girilen emir 2.seans sonu işlemlerinde iptal edilmiş)T 0000010000000002 16:25:10 EMİR 2006200000001940 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN ACC İPTAL EDİLDİ. Borsa Iptali.(HSP uzmanları tarafından ilgili emir iptal edilmiş)T 0000010000000002 16:25:11 EMİR 2006200000001940 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN İPTAL EDİLDİ. İMKB İPTAL ETTİ.T 24260624822791 11:04:29 EMİR 1210200500000155 SATIŞ 500 BJKAS.E 0.00 MÜŞ AFE 123456789012345 İPTAL EDİLDİ. Temsilci istegi.(AFE emri temsilci isteği ile iptal edilmiş)

T 53233402133785 12:07:20 EMİR 1309201100000201 SATIŞ 150 EREGL.E 0.00 PORT KAFE 987654321123 İPTAL EDİLDİ. Temsilci istegi.

T 53280317578988 17:04:13 EMİR 1309201100000284 ALIŞ 10 ETYAT.E 0.00 MÜŞ KAFE 987654321123 İPTAL EDİLDİ. KAFE Emri.

T 55861812974696 17:09:19 EMİR 1309201100000178 ALIŞ 101 OZAPP.C 1.03 MÜŞ GÜN 987654321123 İPTAL EDİLDİ. Temsilci istegi.

0--------1---------2---------3---------4---------5---------6---------7---------8

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 48

Page 50: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.2.2.4 Biriken Mesajları Üye Sistemine İndirme Hata Mesajı

Bu mesaj, Üye sisteminden gelen mesaj indirme isteklerinin, sisteme gönderilmeden önce, ExAPI PC’si üzerinde kontrollerden geçirilirken herhangi bir hata durumuyla karşılaşılması neticesinde oluşan hata bilgisini içerir. Bu durumda yukarıdaki 3.2.2.2 ve 3.2.2.3 numaralı maddelerde yer alan mesajlar üretilmediğinden dolayı üye sistemine herhangi bir geçerli mesaj gönderilmeyecektir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı emir iptal isteği anlamında.AÇIKLAMA (**) 198 karakter E İlgili isteğin reddedilme nedeni. Reddedilme nedenine bağlı olarak

değişen uzunluklardaki hata ifadesini içerir.

(**) : Toplam 198 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve hata durumunu belirtmek üzere ‘H’ karakteri ile başlar. Ardından gelen alanlarda, hatalı olan durumu açıklayan bilgi ile birlikte istek detay bilgisi yer alır. Tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

H Mesaj uzunluğu işlem kodu ile uyumlu değildir.H İşlem kodu Y,D,I,U,K,M ya da N olabilir.H Yanlış işlem kodu gönderildi.H Mesaj Tipi H, Y, I, D, T, R, S, Z, K, M, P ya da G olmalıdır. H Log sıra numarası alanında uygun olmayan karakterler var.0--------1---------2---------3---------4---------5---------6---------7---------8

3.3 İstek Red Mesajları

3.3.1 İstek Red Bilgisi

3.3.1.1 İstek Red Bilgisi Mesajı

Üyenin o anda yapmakta olduğu işlem (yeni emir giriş, emir düzeltme, emir iptal) herhangi nedenden veya hatadan ötürü İşlem Sistemi tarafından reddedilebilir. Bu durumda, Borsa İstanbul Pay Piyasası Alım Satım Sistemi’nden, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla, asenkron kanal üzerinden, sözkonusu hatayı tarif eden İstek Red Bilgisi mesajı formatında bir mesaj gönderilir.

İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Üye Sistemi’ne asenkron kanaldan gönderilmesi gereken başka bir mesaj İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye ulaşmışsa, Borsa İstanbul ExAPI PC beklemeden bu mesajı da Üye Sistemi’ne göndereceği için; Üye Sistemi’nde asenkron kanaldan bilgi alan program(lar)ın her an gelebilecek bu mesajları alabilecek şekilde hazırlanması gereklidir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E R: İstek Reddi anlamında.LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan bilgilerin sıra numarası.

İŞLEME ZAMANI 8 karakter E Mesajın İşlem Sistemi tarafındangönderildiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI 16 hane nümerik E Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından verilen genel emir numarası.

AÇIKLAMA (**) x karakter E İlgili emrin/isteğin reddedilme nedeni. Reddedilme nedenine bağlı olarak değişen uzunluklardaki hata ifadesini içerir.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 49

Page 51: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer boşluk karakteri ile ayrılmış haldedir.

Mesaj Örnekleri

R 99563289321566 11:34:52 2006200000001940 Emir Onceden Sisteme Girilmis. KISN : 10000001, OEN : 2006200000001921 R 99563686254921 11:36:17 2006200000001941 HATA – Bu Emir Baska Bir Emirden Bolunmus. Iptal Edilemez.R 99563686274139 11:38:45 2006200000001942 IPTAL GERCEKLESMEDI.Ancak Son Emirler Iptal Edilebilir.R 01350255772216 15:07:42 2006200000073074 DUZELTME GERCEKLESMEDI. Ancak Fiyat Iyilestirilebilir.R 08567649602129 15:42:51 2006200000275336 Emriniz Hissenin Blok Emir Kapsamina Ulasti, EMIR IPTAL EDILDI .R 03100303122190 16:06:25 2405200100004483 UYARI - Emir degistirilmis. Tekrar deneyiniz.R 34545687345590 09:43:54 2405200100023150 Acılıs Oncesinde hesap numarasi girisi zorunludur!R 05883805038281 10:28:52 2405200100012587 Hesap numarasi girisi zorunludur!(Bu mesaj hesap numarası verilmeden emir girilmeye çalışıldığında ExAPI kullanıcısına Borsa İstanbul Sistemi tarafından gönderilen bir mesajdır. Eğer bir piyasa yapıcı üye ExAPI kullanıcısı hesap numarasız kotasyon girişi yapmaya çalışırsa bu mesaj kotasyonun alış tarafının emir numarası ile ExAPI kullanıcısına döndürülecektir.)R 13963156031416 09:33:33 0508200300000508 Hisse Islemleri Durduruldu. Emir IPTAL EDILDI. R 13700096537866 09:36:33 0508200300000262 Bu hisse senedi acilisa dahil degil.R 24340866443380 14:44:04 1005200500000597 Acilis fiyatli emir (AFE) girisine izin verilmemektedir.R 24341001277692 14:18:22 1005200500000601 HATA - Acilis fiyatli emirler limit fiyatli emre limit fiyatli emirler acilis fiyatli emre cevrilemez.R 24341047802786 14:30:12 1005200500000606 Acilis sonrasi isleme kapatilan hissede emir girilemezR 24403491943042 14:05:22 1210200500002301 HATA - Islemi durdurulan hissede fiyat iyilestirilemez, miktar artirilamaz.R 15622815869549 11:43:18 3012200300000018 Aciga Satis Emri Iptal Edildi. Emir Fiyati Kurala uygun degil.R 17300234873214 11:07:43 UYARI - Emirler Iptal Edilmedi.R 17312303162406 14:05:59 Gonderilen istek iptal edildi. Kontrol'u arayiniz.R 37953866960114 10:42:05 2201200800000484 Emir Islem Gormeyecek. Nedeni : Miktar Sinirlamasi. .R 39740920582006 16:48:30 2612200800000281 Aciga Satis Yapilamaz . Pazar ya da Hisse Acilis Seansinda.R 40780685413078 15:04:26 2503200900001136 Bu Hissede Tek Fiyat Islemleri Tamamlandi. Islem Yapilamaz.R 41012713543020 11:22:21 2503200900002401 Kotasyon Onceden Sisteme Girilmis.R 41012714737219 11:22:39 2503200900002404 Acilis Seansinda Kotasyon Girilemez.R 43163102717148 14:58:39 0107200900000044 Kotasyon girisi yapilmadan emir giremezsiniz.R 43163869774017 18:13:44 0107200900000062 Emir Fiyati Kotasyon Fiyat Araligi Disinda. (Değiştirme isteği için bu mesaj alındığında bu isteklerin tamamen reddedildiği kabul edilmelidir.)R 43181057538632 18:43:04 0107200900000081 Emir Miktari : Tanimlanmis Tek Bir Emir Miktarini Asiyor : ().R 45984201394916 17:17:16 0504201000003345 Kotasyon fiyat araligi disinda KIE emri girilemez.R 24341001277692 14:18:22 1005200500000601 HATA - Kapanis fiyatli emirler limit fiyatli emre, limit fiyatli emirler kapanis fiyatli emre cevrilemez.R 24340866443380 14:44:04 1005200500000597 Kapanis fiyatli emir (KAFE) girisine izin verilmemektedir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 50

Page 52: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

R 13700096537866 09:36:33 0508200300000262 Bu hisse senedi kapanisa dahil degil.R 13700096537866 09:36:33 0508200300000262 Bu hisse senedi kapanis fiyatindan islemler asamasina dahil degil.

R 24000022234867 09:55:26 0508200300010151 Emir Fiyati Marj Disinda, Emir IPTAL EDILDI.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.4 Bilgi Mesajları

3.4.1 İşlem Bilgisi

3.4.1.1 İşlem Bilgisi Mesajı

Bu mesaj tipi ile üye, daha önceden girmiş olduğu emirlerin işleme girmesi sonucunda oluşan bilgileri, Borsa İstanbul Pay Piyasası Alım Satım Sistemi’nden, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla, asenkron kanal üzerinden alır. İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Üye Sistemi’ne asenkron kanaldan gönderilmesi gereken başka bir mesaj İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye ulaşmışsa, Borsa İstanbul ExAPI PC beklemeden bu mesajı da Üye Sistemi’ne göndereceği için; Üye Sistemi’nde asenkron kanaldan bilgi alan program(lar)ın her an gelebilecek bu mesajları alabilecek şekilde hazırlanması gereklidir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E S: İŞlem anlamındaLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan işlem bilgisinin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

ALIŞ/SATIŞ (*) 14 karakter E SATILDI.: Satış emrinin gerçekleşmesi.ALINDI.: Alış emrinin gerçekleşmesi.AÇIĞA SATILDI.: Açığa satış emrinin gerçekleşmesi.

İŞLEM TİPİ 3 karakter E LMT: Fiyatlı lot emirleriyle gerçekleşen işlem (Not: İşlem gören AFE için gelen mesajda da LMT kullanılacaktır.)

İŞLEM MİKTARI (*) 8 hane nümerik E İlgili emrin işleme giren miktarı.PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

İŞLEM FİYATI (*) 8 hane noktalı nümerik

E İşlemin gerçekleştiği fiyat.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonEMİR NUMARASI 16 hane nümerik E İşleme giren emirin Borsa istanbul Pay Piyasası Alım Satım

Sistemi tarafından verilen genel emir numarası.İŞLEM NUMARASI (*) 6 hane nümerik E İşleme giren emire Borsa İstanbul Pay Piyasası Alım Satım

Sistemi tarafından verilen işlem numarası.AÇIKLAMA (**) x karakter E İşleme giren emirin özelliklerine bağlı olarak değişen uzunluklarda

olan ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

(100 lotluk satış emri girilmiş ve önce 49 sonra 51 lotu işleme giriyor)S 00010000000002 10:00:02 SATILDI. LMT 49 YKBNK.E 6.5 MÜŞ 2006200000002282 52370 KLN 51 GÜN ACCOUNTACCOUNTAS 00010000000061 10:00:02 SATILDI. LMT 51 YKBNK.E 6.5 MÜŞ 2006200000002282 52371 KARŞILANDI GÜN ACCOUNTACCOUNTA 0--------1---------2---------3---------4---------5---------6---------7---------8Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 51

Page 53: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

(900 lotluk alış emri girilmiş ve 100 lotu işleme giriyor)S 00010000000125 10:00:03 ALINDI. LMT 100 ANHYT.E 30.25 MÜŞ 2006200000002283 52372 KLN 800 TAR ACCOUNTACC0--------1---------2---------3---------4---------5---------6---------7---------8

(245 lotluk KİE alış emri girilmiş ve 200 lotu işleme giriyor, 45 lotu kalıyor. Not : Bu 45 lot pasife yazılmadan iptal edilecek ve bununla ilgili ayrı bir iptal mesajı gönderilecek.)S 10681041443959 11:12:14 ALINDI. LMT 200 KARSN.E 0.92 MÜŞ 0111200200157433 80085 KLN 45 KİE0--------1---------2---------3---------4---------5---------6---------7---------8

(9 lotluk KİE alış emri girilmiş ve tamamı işleme giriyor)S 10680980518716 10:56:48 ALINDI. LMT 9 KARSN.E 0.92 MÜŞ 0111200200157431 80069 KARŞILANDI KİE0--------1---------2---------3---------4---------5---------6---------7---------8

Aşağıdaki örnek mesaj silsilesinde, bir KİE emri girildikten sonra senkron ve asenkron kanaldaki mesaj akışı gösterilmektedir. Senkron kanaldan alınan ve “İSTENDİ” ile sonlanan “Y” kodlu emir giriş cevabının ardından, bu emir neticesinde oluşan “S” kodlu işlem mesajları asenkron kanaldan üye sistemine döner. KİE emrinin kalan kısmı ise iptal edileceğinden dolayı, “T” iptal kodlu emir iptal mesajı, “S” işlem kodlu işlem mesajlarından sonra ExAPI PC’sine gelir.

(Senkron kanal)Y 11102459921893 13:48:15 EMİR 2301200300000340 SATIŞ 400 ASELS.E 16.5 MÜŞ 12345678 KIE ACCOUNT001 İSTENDİ0--------1---------2---------3---------4---------5---------6---------7---------8

(Asenkron kanal)S 11102459923382 13:48:15 SATILDI. LMT 100 ASELS.E 16.5 MÜŞ 301200300000340 59 KLN 300 KİE ACCOUNT001S 11102459923402 13:48:15 SATILDI. LMT 150 ASELS.E 16.5 MÜŞ 301200300000340 60 KLN 150 KİE ACCOUNT001T 11102459923408 13:48:15 EMİR 2301200300000340 SATIŞ 150 ASELS.E 16.5 MÜŞ KIE ACCOUNT001 İPTAL EDİLDİ. KIE Emri.

0--------1---------2---------3---------4---------5---------6---------7---------8

(10 lotluk açığa satış emri girilmiş ve tamamı işleme giriyor.)S 15622629788974 10:55:59 AÇIĞA SATILDI. LMT 10 ARAT.E 0.91 MÜŞ 3012200300000010 5 KARŞILANDI GÜN 123456789012345

(1000 lotluk açığa satış emri girilmiş 958 lotu işleme giriyor, 42 lotu pasifte kalıyor.)S 15622643567779 10:59:29 AÇIĞA SATILDI. LMT 958 ARAT.E 0.91 PORT 3012200300000011 6 KLN 42 GÜN 1234567890123450--------1---------2---------3---------4---------5---------6---------7---------8

(500 lotluk AFE alış emri girilmiş ve 20 lotu işleme giriyor)S 63131841251967 09:37:14 ALINDI. LMT 20 AYGAZ.E 3.30 MÜŞ 0912200500001760 551 KLN 480 AFE0--------1---------2---------3---------4---------5---------6---------7---------8

(4.02 YTL fiyat kademesine kadar OLFE alış emri girilmiş ve 3926 lotluk bir adet işlem gerçekleşmiş)S 38712687408878 11:14:22 ALINDI. LMT 3926 ADANA.E 4.02 MÜŞ 1809200800000318 114 KARŞILANDI KİE HESAPNO

(İşlem mesajının hemen ardından işlem özetini gösteren mesaj gelir)Z 38712687408939 11:14:22 1809200800000318 Emriniz 3926 lot Islem Gordu. Toplam Islem Degeri : 15782.52

(5000.00 YTL değerine kadar girilen OLDE alış emrine karşılık 1043 lotluk bir adet işlem olmuş)S 38712714534850 14:05:00 ALINDI. LMT 1043 DJIST.F 4.79 MÜŞ 1809200800000321 115 KARŞILANDI KİE HESAPNO

(İşlem mesajının hemen ardından işlem özetini gösteren mesaj gelir)Z 38712714534867 14:05:00 1809200800000321 Emriniz 1043 lot Islem Gordu. Toplam Islem Degeri : 4995.97Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 52

Page 54: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

0--------1---------2---------3---------4---------5---------6---------7---------8

Aşağıdaki örnek mesaj silsilesinde, OLDE türü bir satış emri girildikten sonra senkron ve asenkron kanaldaki mesaj akışı gösterilmektedir. OLDE ve OLFE türü emirler miktarsız olarak girilen emirler olduğundan KİE emirlerinin aksine iptal edilen herhangi bir kalan miktar olmayacaktır. Bu örnekte 500 YTL değerine ulaşana (ya da verilen fiyat kademesine kadar olan tüm emirler karşılanıncaya) kadar işlemler değişik fiyat kademelerinden olmaya devam etmiş (toplam üç işlem), 62 lotluk 289.48 YTL‘lik işlem değerine ulaşıldığında işlemler kesilmiştir. Bu son işlem mesajının ardından yine asenkron kanaldan bu emirle ilgili işlem mesajlarının sonuncusunun gönderildiğini ve bundan sonra daha fazla işlem mesajının gönderilmeyeceğini belirten işlem özeti mesajı gönderilmiştir.

(Senkron kanal)Y 38712757741210 11:32:15 EMİR 1809200800000325 SATIŞ 0 ISCTR.E 4.62 MÜŞ KIE HESAPNO REFRNS İSTENDİ0--------1---------2---------3---------4---------5---------6---------7---------8

(Asenkron kanal)S 38712757743577 11:32:15 SATILDI. LMT 9 ISCTR.E 4.70 MÜŞ 1809200800000325 116 KARŞILANDI KİE HESAPNO S 38712757743595 11:32:15 SATILDI. LMT 10 ISCTR.E 4.68 MÜŞ 1809200800000325 117 KARŞILANDI KİE HESAPNO S 38712757743603 11:32:15 SATILDI. LMT 43 ISCTR.E 4.66 MÜŞ 1809200800000325 118 KARŞILANDI KİE HESAPNO Z 38712757743609 11:32:15 1809200800000325 Emriniz 62 lot Islem Gordu. Toplam Islem Degeri : 289.480--------1---------2---------3---------4---------5---------6---------7---------8

S 55861770220106 16:58:27 SATILDI. LMT 100 OZAPP.C 0.01 MÜŞ 1309201100000173 4 KARŞILANDI TAR 9876543211230--------1---------2---------3---------4---------5---------6---------7---------8

3.4.1.2 İşlem Özet Bilgisi

Bu mesaj, Özel Limit Fiyatlı Emirler (OLFE) ile Özel Limit Değerli Emirlerin (OLDE) ana sistemde işleme girmesinden sonra asenkron kanaldan gelebilecek işlem mesajlarının sona erdiğininin anlaşılabilmesi amacıyla gönderilmektedir. OLFE ve OLDE haricindeki diğer emir türleri için herhangi bir işlem özeti mesajı üretilmeyecektir.

3.4.1.1 maddesinde yer alan İşlem Bilgisi Mesajı kapsamında asenkron kanaldaki mesaj akışıyla ilgili geniş açıklamalar yapılmıştır. Burada sadece bu mesajın içeriyle ilgili bilgi verilmektedir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E Z: İşlem Özeti anlamında.LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan işlem özeti bilgisinin sıra numarası.

İŞLEME ZAMANI 8 karakter E Ana sistem tarafından son işlem mesajının üretidiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI 16 hane nümerik E Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından verilmiş olan emir numarası.

AÇIKLAMA (*) 157 karakter E Emrin toplam kaç lot işlem gördüğünü ve kaç liralık işlem değerine ulaştığını belirten açıklama mesajı.

(*) : Toplam 157 karakter olan bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmıştır.

Mesaj Örnekleri

Z 38710938652445 14:19:38 1809200800000301 Emriniz 1000 lot Islem Gordu. Toplam Islem Degeri : 450.00.Z 38711103116845 14:31:28 1809200800000317 Emriniz 74 lot Islem Gordu. Toplam Islem Degeri : 297.48.

0--------1---------2---------3---------4---------5---------6---------7---------8Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 53

Page 55: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.4.2 Emir İptal Bilgisi Mesajı

Bu mesaj tipi ile üye, daha önceden girmiş olduğu emir iptal isteklerinin (kullanıcı kaynaklı) ve emir iptallerinin (Pay Piyasası kaynaklı) işleme girmesi sonucunda oluşan bilgileri, Borsa İstanbul Pay Piyasası Alım Satım Sistemi’nden, elektronik ortam üzerinden Borsa İstanbul ExAPI vasıtasıyla, asenkron kanal üzerinden alır.

İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Üye Sistemi’ne asenkron kanaldan gönderilmesi gereken başka bir mesaj İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye ulaşmışsa, Borsa İstanbul ExAPI PC beklemeden bu mesajı da Üye Sistemi’ne göndereceği için; Üye Sistemi’nde asenkron kanaldan bilgi alan program(lar)ın her an gelebilecek bu mesajları alabilecek şekilde hazırlanması gereklidir.

Not : Sistemde “Yönetici” yetkisindeki şef broker’lar ya da ExAPI kullanıcıları tarafından iptal edilen emirlerle ilgili iptal onayları (“T” işlem kodlu emir iptal bilgisi mesajları) hem emri giren hem de iptal isteğini yapan kullanıcıların her ikisine birden gönderilmektedir.

Alan AdıAlan Türü Zor. Açıklama

İŞLEM KODU1 karakter E T: İptal anlamında

LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan emir iptal mesajının sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI 16 hane nümerik E İptal edilen emrin emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E SATIŞ: Satış emrinin iptali.ALIŞ: Alış emrinin iptali.AÇSAT: Açığa satış emrinin iptali.

MİKTAR (*) 8 hane nümerik E Girilen emirin karşılanmadan kalan (pasifte kalan) miktarı. Lot olarak belirtilir.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Gönderilmiş olan emirde belirtilen fiyat.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonAÇIKLAMA (**) x karakter E İptal edilen emirin özelliklerine bağlı olarak değişen uzunluklarda

olan ve reddedilme nedeniyle ilgili çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Not: Sisteme ulaşan tüm emirler işleme aşamalarında ya reddedilirler, ya işleme girerler, ya da seans içerisinde veya bitiminde çeşitli nedenlerle iptal edilirler. Aşağıda iptal durumlarıyla ilgili örnekler verilmiştir. Emir değiştirme isteği için sisteme kabul edildiğine dair cevap mesajının dışında, sistem tarafından üretilen herhangi bir “değiştirildi” veya “bölündü” ifadeli mesaj yoktur. Bu istekler için, asenkron kanaldan gelebilecek olan mesaj, değiştirilen emirin işleme girmesi neticesinde oluşan işlem bilgisi mesajı (3.4.1.1) ya da burada olduğu gibi emir iptal bilgisi mesajıdır (3.4.2). Dolayısıyla bu mesajlar için senkron kanaldan alınan ilgili isteğin sisteme kabul edilmesi veyahut reddi ile ilgili mesaj bahsedilen iki tür istek için yeterli kontrolü sağlamaktadır. İptal istekleri için ise, ilgili istek sisteme kabul edildikten sonra iptal kurallarına uyuyorsa sistem doğrudan iptal isteğini gerçekleştirir. Ardından iptalin başarılı şekilde sonuçlandırıldığınınu ifade eden “iptal edildi” ifadeli mesaj üye sistemine ulaştırılır. Üye tarafında çalışacak programların bu durumu dikkate almaları gerekmektedir.

Mesaj ÖrnekleriSürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 54

Page 56: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

T 00010000000002 10:16:50 EMİR 2006200000001939 ALIŞ 99 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTAL EDİLDİ. Temsilci isteği.T 00010000000003 10:16:58 EMİR 2006200000001940 ALIŞ 99 ANHYT.E 28.5 MÜŞ GÜN ACCOUNTAC İPTALEDİLDİ. Temsilci isteği.T 00010000000004 14:55:12 EMİR 2006200000001941 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTAL EDİLDİ. Hisse Islemleri Durduruldu.T 00010000000005 12:55:35 EMİR 2006200000001942 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTAL EDİLDİ. Suresi biten emir.T 00010000000006 16:25:10 EMİR 2006200000001943 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTAL EDİLDİ. GUN Emri.T 00010000000007 16:25:19 EMİR 2006200000001944 SATIŞ 10 ANHYT.E 28.5 MÜŞ GÜN HESAPNO İPTAL EDİLDİ. Borsa Iptali.T 00010000000008 15:43:21 EMİR 2006200000001945 SATIŞ 10 ANHYT.E 28.5 MÜŞ KIE HESAPNO İPTAL EDİLDİ. KIE Emri.T 37960204526948 13:22:56 EMİR 2201200800000491 SATIŞ 0 ARFYO.E 1.11 MÜŞ KIE 123456789012345 İPTAL EDİLDİ. KIE Emri.T 06052501223542 12:44:05 EMİR 0901200200082619 SATIŞ 100 DARDL.E 10.83 MÜŞ TAR 09 OCA 02626.101 İPTAL EDİLDİ. Fiyat adimi uymuyor.T 06052501223542 12:44:08 EMİR 0901200200083221 SATIŞ 100 EREGL.E 10.25 MÜŞ TAR 09 OCA 02354.101 İPTAL EDİLDİ. Fiyat marj disi.T 15622656293050 11:02:43 EMİR 3012200300000011 AÇSAT 42 ARAT.E 0.91 PORT GÜN 123456789012345 İPTAL EDİLDİ. Temsilci istegi.

T 13131609214489 09:50:02 EMİR 1804200300001726 ALIŞ 14 BOSSA.E 0 MÜŞ AFE HESAPNO İPTAL EDİLDİ. AFE Emri.(Açılış fiyatlı olarak girilen emirin karşılanmadan kalan miktarı açılış işlemleri neticesinde iptal edilmiş)

T 24260624822791 11:04:29 EMİR 1210200500000155 SATIŞ 500 BJKAS.E 0.00 MÜŞ AFE 123456789012345 İPTAL EDİLDİ. Temsilci istegi.(AFE emri temsilci isteği ile iptal edilmiş)

T 40763814506648 15:55:40 EMİR 2503200900001092 ALIŞ 3110 AFMAS.E 9.00 MÜŞ TAR 26 MAR 09987654321123456 İPTAL EDİLDİ. Kotasyon Disinda.(Bir limit fiyatlı emrin kotasyondan daha iyi fiyattan girildiği ve karşısında işlem görecek miktarda emir kalmadığı için işlem görmeyen kısmının iptal edilmesi durumunda gelen mesajdır)

T 40781187256955 17:12:04 EMİR 2503200900001142 ALIŞ 1000 ACIBD.E 8.20 PORT GÜN 123456789012345 İPTAL EDİLDİ. Borsa Iptali.

T 40781187256960 17:12:04 EMİR 2503200900001143 SATIŞ 2040 ACIBD.E 8.30 PORT GÜN KOTASYON12345 İPTAL EDİLDİ. Borsa Iptali.

(Kotasyon Borsa tarafından iptal edilirse kotasyonun hem alış tarafı hem de satış tarafı emirleri için ayrı ayrı olmak üzere yukarıdaki iki mesaj kotasyonu Sistem’e giren kullanıcıya gönderilir)

T 40871989768705 17:26:33 EMİR 2503200900001331 SATIŞ 1500 ANHYT.E 2.26 PORT GÜN KOTASYON12345 İPTAL EDİLDİ. Hisse Islemleri Durduruldu. T 40871989768676 17:26:33 EMİR 2503200900001330 ALIŞ 5000 ANHYT.E 2.20 PORT GÜN KOTASYON12345 İPTAL EDİLDİ. Hisse Islemleri Durduruldu.

(Kotasyon Borsa tarafından pay durdurularak kontrolden iptal edilirse kotasyonun hem alış tarafı hem de satış tarafı emirleri için ayrı ayrı olmak üzere yukarıdaki iki mesaj kotasyonu Sistem’e giren kullanıcıya gönderilir)

ATAYO.E Kotasyon Kontrol tarafindan iptal edildi.

(Kotasyon emir aktarımı aşamasında iptal edildiğinde yukarıdaki mesaj pay için borsaya bildirilmiş olan piyasa yapıcı üye temsilcisi ExApi kullanıcısına gönderilir.)

0--------1---------2---------3---------4---------5---------6---------7---------8Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 55

Page 57: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.4.3 Kotasyon Güncelleme Bilgisi

Kotasyon Borsa İstanbul Sistemi’ne girildikten sonra, üzerinde her değişiklik yapıldığında kotasyonu İşlem Sistemi’ne ilk giren piyasa yapıcı üye temsilcisine senkron kanaldan gönderilen “Kotasyon Değiştirme Cevap Mesajı” ile aynı anda kotasyon güncelleme bilgisi mesajı gönderilir.

Kotasyonun, kotasyonu girmiş piyasa yapıcı üye temsilcisi tarafından değil, piyasa yapıcı üyenin başka bir yetkili temsilcisi tarafından değiştirilmesi durumunda üretilen , kotasyon güncellenme bilgisi mesajı sadece hem kotasyonu İşlem Sistemi’ne giren piyasa yapıcı üye temsilcisine gidecektir. hem de kKotasyonu değiştiren temsilciye ise sadece aynı anda “Kotasyon Değiştirme Cevap Mesajı” olarak gönderilecektir.

İşlem Sistemi tarafından otomatik olarak ilk kotasyon atanması durumunda, piyasa yapıcı üyenin ilk otomatik kotasyon girişi için Borsa’ya bildirmiş olduğu ExAPI terminaline asenkron kanaldan “Kotasyon Güncelleme Bilgisi Mesajı” gönderilecektir. İşlem görerek miktarı sıfırlanan kotasyonun piyasa yapıcı üye temsilcisinin kotasyonu değiştirmemesi nedeniyle Borsa İstanbul Sistemi tarafından otomatik olarak güncellenmesi durumunda da, kotasyonu Sistem’e ilk giren piyasa yapıcı üye temsilcisine kotasyon güncelleme bilgisi gönderilecektir.

Diğer taraftan, kotasyonun alış veya satış miktarının sıfıra düşmesi durumunda aynı bilgi mesaj asenkron kanaldan gönderilmekte olup, kotasyonun sistem tarafından ne zaman atanacağını belirten bir ifade açıklama bölümüne eklenmektedir. Bu süre, bütün menkul kıymetler için sabittir ve mevcut durumda 3 dakika olması planlanmaktadır.

İlk kotasyon girişinde ise kotasyonu giren kullanıcıya sadece kotasyon giriş cevap mesajı gelecek olup asenkron kanaldan kotasyon güncellendi bilgisi gönderilmeyecektir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E P: Kotasyon güncellendi anlamında.LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan kotasyon güncellenme bilgisinin sıra numarası.

İŞLEME ZAMANI 8 karakter E Ana sistem tarafından son işlem mesajının üretidiği zamanı belirtir.HH:MM:SS formatındadır.

KOTASYON DURUMU

8 karakter E KOTASYON : Kotasyon güncellendi.KOTSIFIR : Kotasyon miktarı sıfıra düştü.

KOTASYON NUMARASI

16 hane nümerik E İşlem Sistemi tarafından verilen kotasyon numarası.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Kotasyonun ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIŞ/SATIŞ (*) 5 karakter E ALIS: Alış Emri, SATIS: Satış EmriEMİR NUMARASI 16 hane nümerik Sistem tarafından verilen emir numarasıMİKTAR (*) 8 hane nümerik E Güncellenen alış/satış miktarı.MİKTAR BİRİM 3 karakter E LOT : Miktarın birimini gösterir.FİYAT (*) 8 hane noktalı

nümerikE Güncellenen alış/satış emrinin fiyatı

AÇIKLAMA (**) X karakter E Kotasyonun güncellendiğini veya kotasyonun miktarının sıfırlandığını gösterir. Ayrıca sıfırlanan kotasyonun piyasa yapıcı tarafından güncellenmemesi durumunda otomatik kotasyon atamasının kaç dakika sonra gerçekleşeceğini gösterir.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmıştır.

Mesaj Örnekleri

P 40762348860435 09:42:56 KOTASYON 2503200900001051 EMBYO.E ALIS 2503200900001052 1000 LOT 32.00 GUNCELLENDI. P 40762348860475 09:42:56 KOTASYON 2503200900001051 EMBYO.E SATIS 2503200900001053 2000 LOT 33.00 GUNCELLENDI.P 40762348860495 09:43:56 KOTSIFIR 2503200900001051 EMBYO.E SATIS 2503200900001053 0 LOT 33.00. SURE : 3 DAKIKA.P 43231252294776 14:33:56 KOTSIFIR 0107200900000153 TPP30.V ALIS 0107200900000151 0 LOT 0.56. SURE : 3 DAKIKA

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 56

Page 58: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

İlk kotasyonun sistem tarafından otomatik olarak atanması durumunda sistemde ilk otomatik kotasyon atama için Borsaya daha önceden bildirilmiş ve sistemde tanımlanmış olan ExAPI kullanıcısına aşağıdaki 2 mesaj gelir:P 43162090661535 10:41:16 KOTASYON 0107200900000022 NFIST.F ALIS 0107200900000020 250 LOT 10.95 GUNCELLENDI. P 43162090661618 10:41:16 KOTASYON 0107200900000022 NFIST.F SATIS 0107200900000021 250 LOT 11.05 GUNCELLENDI.0--------1---------2---------3---------4---------5---------6---------7---------8

3.4.4 Temsilci İşlemleri Bilgilendirme Mesajları

Temsilci terminalleri vasıtasıyla İşlem Sistemi’ne gönderilen emir giriş, iptal, değiştirme ve bölme istekleri ile gerçekleşen işlem ve kotasyon giriş/değiştirme bilgileri ilgili üyeye, üye tarafından yetkilendirilecek ExAPI terminali aracılığıyla iletilecektir. ExAPI terminali tarafından özel emir girişi mümkün olmamasına rağmen, temsilci terminalleri tarafından girilen/eşlenen özel emirler ile gerçekleştirilen işlemlerin bilgileri yetkilendirilmiş ExAPI terminaline gönderilecektir. Ek olarak, müzayede ve normal işlem sıralarında, Borsa İstanbul tarafından üye temsilcileri adına girilen emir ve gerçekleştirilen işlem bilgileri de yetkilendirilmiş ExAPI terminaline gönderilecektir. Ancak, Toptan Satışlar Pazarı’nda Borsa İstanbul tarafından aracı kurumlar adına yapılan işlemlerin bilgileri ExAPI terminaline gönderilmeyecektir. Bu istek ve işlemlerin iletileceği ExAPI terminalini, senkron kanaldan gönderilebilecek terminal durum güncelleme mesajıyla üye kendisi belirleyebilecektir.

Yetkili üye temsilcilerinin (şef broker), aynı kurumdan başka bir temsilcinin veya ExAPI terminalinin emrini değiştirmesi/bölmesi/iptali ve kotasyonunu güncellemesi durumunda , bilgilendirme mesajları yetkilendirilmiş ExAPI terminaline gönderilecek ve mesajlarda “temsilci no” alanında değişikliği yapan üye temsilcisinin kodu bulunacaktır.

3.4.4.1 Temsilci Emir Giriş Mesajı

Temsilci terminallerinden girilen emirler, asenkron kanal üzerinden bu mesaj tipi ile yetkilendirilmiş ExAPI terminaline gönderilir. İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E A: Temsilci Emir Giriş.LOG SIRA NUMARASI 14 hane

nümerikE PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına

yazılan bilgilerin sıra numarası.İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı

belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI (*) 16 hane nümerik

E İşlem Sistemi tarafından verilen emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış EmriMİKTAR (*) 8 hane

nümerikE Emirde verilen miktar. Lot olarak belirtilir.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Emir fiyatı.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonTEMSİLCİ NO(*) 4 hane

nümerikE Emri giren temsilcinin numarası

HESAP NO(*) 15 karakter E Temsilci tarafından girilen hesap numarasıREFERANS(*) 6 karakter E Temsilci tarafından girilen referans bilgisi. Referans girilmediği

durumda “0” yer alacaktır.AFK KODU(*) 3 karakter E Acente Fon Kodu. AFK kodu girilmediği durumda “0” yer alacaktır.GEÇERLİLİK SÜRESİ(*) 4 karakter E GUN : Seanslık emir, TAR : Tarihli emir (günlük), KİE: Kalanı iptal

et, AFE: Açılış Fiyatlı Emir, KAFE: Kapanış Fiyatlı EmirAÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır. Açıklama alanının en sonunda TEMSİLCİ ifadesi yer alacaktır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 57

Page 59: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Mesaj Örnekleri

A 43173547695929 11:04:05 EMİR 2606200900001018 ALIŞ 10 GARAN.E 3.78 FON 26 HESAPNO REFRNS TIB TAR 1 GÜN TEMSİLCİ

A 43212957994046 09:23:11 EMİR 2606200900001051 AÇSAT 100 EREGL.E 4.48 MÜŞ 26 123456 0 0 GÜN TEMSİLCİ

A 43212970705512 09:26:25 EMİR 2606200900001052 ALIŞ 0 EREGL.E 4.48 MÜŞ 26 HESAP123 REF1 0 KIE TEMSİLCİ

A 43212991359035 09:31:40 EMİR 2606200900001053 ALIŞ 1000 TCELL.E 0.00 PORT 26 HESAP987 REF 0 AFE TEMSİLCİ

A 43241878671344 11:25:30 EMİR 3009200900000146 ALIŞ 250000 EREGL.E 4.48 MÜŞ 1405 2 0 0 GÜN TEMSİLCİ (Özel emir girişinde gelen mesaj) A 43212991359035 09:31:40 EMİR 2606200900001053 ALIŞ 1000 TCELL.E 0.00 PORT 26 HESAP987 REF 0 KAFE TEMSİLCİ

0--------1---------2---------3---------4---------5---------6---------7---------8

3.4.4.2 Temsilci Emir Değiştirme Mesajı

Temsilci terminallerinden değiştirilen emirler, asenkron kanal üzerinden bu mesaj tipi ile ilgili ExAPI terminaline gönderilir. İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E C: Temsilci Emir Değiştirme/.LOG SIRA NUMARASI 14 hane

nümerikE PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına

yazılan bilgilerin sıra numarası.İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı

belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI (*) 16 hane nümerik

E İşlem Sistemi tarafından verilen emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 5 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış EmriMİKTAR (*) 8 hane

nümerikE Değiştirilen emir miktarı. Lot olarak belirtilir.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payınişlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Değiştirilen emir fiyatı.

TEMSİLCİ NO(*) 4 hane nümerik

E Emri değiştiren temsilcinin numarası

GEÇERLİLİK SÜRESİ(*) 3 karakter E GUN : Seanslık emir, TAR : Tarihli emir (günlük)AÇIKLAMA(*) 8 karakter E TEMSİLCİ : Emir değiştirme mesajının sonlandığını

göstermektedir

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

C 43173659035365 11:32:24 EMİR 2606200900001018 ALIŞ 100 GARAN.E 3.80 26 TAR TEMSİLCİ

C 43213054452356 09:47:43 EMİR 2606200900001056 AÇSAT 200 EREGL.E 4.48 26 GÜN TEMSİLCİ

0--------1---------2---------3---------4---------5---------6---------7---------8

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 58

Page 60: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.4.4.3 Temsilci Emir İptal Mesajı

Kurumun herhangi bir temsilcisi veya ExPI kullanıcısı tarafından girilen bir emrin, bir temsilci tarafından iptal edilmesi veya temsilci tarafından girilmiş bir emrin Borsa İstanbul tarafından iptal edilmesi durumunda (payın işleme kapatılıp emirlerinin silinmesi, 1. seans bitiminde seanslık emirlerin iptali, KİE emrin kalanının iptali gibi sebeplerle) bu işlemin bilgisi, asenkron kanal üzerinden bu mesaj tipi ile ilgili ExAPI terminaline gönderilir. İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E F: Emir iptaliLOG SIRA NUMARASI 14 hane

nümerikE PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına

yazılan bilgilerin sıra numarası.İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı

belirtir.HH:MM:SS formatındadır.

EMİR NUMARASI (*) 16 hane nümerik

E İşlem Sistemi tarafından verilen emir numarası. Önünde sabit “EMİR“ ifadesi ve 1 karakter boşluk yer alır.

ALIŞ/SATIŞ (*) 8 karakter E ALIŞ: Alış Emri, SATIŞ: Satış Emri, AÇSAT: Açığa Satış Emri, ALIŞÖZL: Alış özel emrinin iptali, SATIŞÖZL: Satış özel emrinin iptali

MİKTAR (*) 8 hane nümerik

E Emir miktarı. Lot olarak belirtilir.

HİSSE ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın kod ve seri bilgisi.HİSSE.SR formatındadır.

FİYAT (*) 8 hane noktalı nümerik

E Emir fiyatı.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonTEMSİLCİ NO(*) 4 hane

nümerikE Emri iptal eden veya emir iptal edilen (sistem tarafından yapılan

iptallerde) temsilcinin numarası.GEÇERLİLİK SÜRESİ(*) 3 karakter E GUN : Seanslık emir, TAR : Tarihli emir (günlük)AÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan

ve çeşitli açıklama ifadelerini içeren alandır. Açıklama alanının en sonunda temsilci tarafından iptal “Temsilci istegi”, Borsa İstanbul tarafından iptal “Borsa iptali” ifadesiyle, seans sonunda iptal edilen “GUN Emri”, KİE emirlerinin kalan kısmının system tarafından iptali durumunda “KİE Emri”, gün sonunda iptal edilen “Suresi biten emir”, adım uymadığında “Fiyat adimi uymuyor” ve marj dışında kaldığında “Fiyat marj disi” ifadesiyle belirtilecektir.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

F 43173763872648 11:59:04 EMİR 2606200900001021 ALIŞ 90 GARAN.E 3.86 FON 26 TAR 25 EYL 09 HESAPNO İPTAL EDİLDİ. Temsilci istegi.

F 43173779830798 12:03:07 EMİR 2606200900001020 ALIŞ 100 GARAN.E 3.84 FON 26 TAR 25 EYL 09 HESAPNO İPTAL EDİLDİ. Borsa Iptali.

F 43213092368704 09:57:21 EMİR 2606200900001057 AÇSAT 200 EREGL.E 4.48 MÜŞ 26 GÜN HESAP22 İPTAL EDİLDİ. Temsilci istegi.

F 43230424391198 11:03:23 EMİR 2606200900001074 ALIŞ 100 SAHOL.E 3.82 MÜŞ 26 GÜN 123 İPTAL EDİLDİ. GUN Emri.

F 43230424391198 11:04:25 EMİR 2606200900001019 ALIŞ 90 GARAN.E 3.82 FON 26 TAR 25 EYL 09 HESAPNO İPTAL EDİLDİ. Suresi biten emir.

F 43230424391235 11:05:26 EMİR 2606200900001106 ALIŞ 10 ARMDA.E 1.07 MÜŞ 26 GÜN 5656 İPTAL EDİLDİ. Fiyat adimi uymuyor.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 59

Page 61: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

F 43230424391243 11:10:53 EMİR 2606200900001072 ALIŞ 10 SAHOL.E 3.78 MÜŞ 26 GÜN 123 İPTAL EDİLDİ. Fiyat marj disi.

F 43230424391243 11:13:43 EMİR 2606200900001074 ALIŞ 10 SAHOL.E 3.78 MÜŞ 36 KİE HES123 İPTAL EDİLDİ. KİE Emri.

F 43230424391243 11:16:45 EMİR 2606200900001078 ALIŞ 10 VRANT.V 3.78 MÜŞ 36 TAR HES123 İPTAL EDİLDİ. Kotasyon Disinda. (Girilen emrin kotasyon fiyat sınırları dışında olması sonucu emrin iptal edilmesi durumunda gönderilecek iptal mesajı)

F 43254044380485 14:48:32 EMİR 3009200900000223 ALIŞ 550 ERTYU.E 4.38 PORT 31 GÜN 111111111111111 İPTAL EDİLDİ. Hisse Islemleri Durduruldu. F 43254044380485 14:48:32 EMİR 3009200900000224 SATIŞ 250 ERTYU.E 4.40 PORT 31 GÜN 111111111111111 İPTAL EDİLDİ. Hisse Islemleri Durduruldu. (Son iki mesaj, payın işlem sırasının Borsa İstanbul tarafından işleme kapatılarak emirlerin silinmesi durumunda, kotasyon emirlerinde hem alış hem satış tarafı için gönderilecek iptal mesajlarıdır)

F 43340330608170 18:54:28 EMİR 0610200900000121 SATIŞÖZL 30000 VRANT.V 5.00 MÜŞ 31 GÜN 2 İPTAL EDİLDİ. Temsilci istegi.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.4.4.4 Temsilci Gerçekleşen İşlem Mesajı

Temsilci terminallerinden gerçekleştirilen işlemler, asenkron kanal üzerinden bu mesaj tipi ile üyenin yetkilendirilmiş ExAPI terminaline gönderilir. İlgili mesaj, İşlem Sistemi’nden ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E E: Temsilci işlemiLOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan işlem bilgisinin sıra numarası.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

ALIŞ/SATIŞ (*) 14 karakter E SATILDI.: Satış emrinin gerçekleşmesi.ALINDI.: Alış emrinin gerçekleşmesi.AÇIĞA SATILDI.: Açığa satış emrinin gerçekleşmesi.

İŞLEM TİPİ 3 karakter E LMT: Fiyatlı lot emirleriyle gerçekleşen işlem (Not: İşlem gören AFE/KAFE için gelen mesajda da LMT kullanılacaktır.)OZL: Özel emir işlemleri

İŞLEM MİKTARI (*) 8 hane nümerik E İlgili emrin işleme giren miktarı.PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Emrin ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

İŞLEM FİYATI (*) 8 hane noktalı nümerik

E İşlemin gerçekleştiği fiyat.

MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonEMİR NUMARASI 16 hane nümerik E İşleme giren emirin Borsa İstanbul Pay Piyasası Alım Satım

Sistemi tarafından verilen genel emir numarası.İŞLEM NUMARASI (*) 6 hane nümerik E İşleme Borsa İstanbul Pay Piyasası Alım Satım Sistemi tarafından

verilen inumara.TEMSİLCİ NO(*) 4 hane nümerik E Emri giren temsilcinin numarasıAÇIKLAMA (**) x karakter E İşleme giren emirin özelliklerine bağlı olarak değişen uzunluklarda

olan ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

E 43173791524666 12:06:06 ALINDI. LMT 10 GARAN.E 3.82 FON 2606200900001019 62 26 KLN 90 TAR HESAPNO

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 60

Page 62: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

E 43173791524660 12:06:06 SATILDI. LMT 10 GARAN.E 3.82 MÜŞ 2606200900001022 62 26 KARŞILANDI GÜN HESNO12345

E 43212970705521 14:30:00 ALINDI. LMT 100 EREGL.E 4.48 MÜŞ 2606200900001052 64 26 KARŞILANDI KİE HESAP123

E 43340402962685 21:30:00 SATILDI. ÖZL 10000 VRANT.V 4.00 MÜŞ 0610200900000123 21 31 KARŞILANDI GÜN 2

0--------1---------2---------3---------4---------5---------6---------7---------8

3.4.4.5 Temsilci Kotasyon Giriş Mesajı

Temsilci terminallerinden girilen kotasyonlar, asenkron kanal üzerinden bu mesaj tipi ile ilgili ExAPI terminaline gönderilir. İlgili mesaj, İşlem Sistemi’nden ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC’si de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E J: Temsilci kotasyon girişiLOG SIRA NUMARASI 14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına

yazılan bilgilerin sıra numarası.İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı

belirtir. HH:MM:SS formatındadır.KOTASYON NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen kotasyon numarası. Önünde sabit

“KOTASYON“ ifadesi ve 1 karakter boşluk yer alır.PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Kotasyonun ait olduğu payın işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIS MİKTARI (*) 8 hane nümerik E Kotasyonda verilen Alış miktar. Lot olarak belirtilir.ALIS FİYATI (*) 8 hane noktalı

nümerikE Gönderilmiş olan kotasyon emir giriş isteğinde belirtilen alış fiyatı.

SATIS FİYATI (*) 8 hane noktalı numeric

E Gönderilmiş olan kotasyon emir giriş isteğinde belirtilen satış fiyatı.

SATIS MİKTARI (*) 8 hane nümerik E Kotasyonda verilen Satış miktar. Lot olarak belirtilir.GEÇERLİLİK SÜRESİ 2 hane nümerik E 00:Seanslık Kotasyon, 01:Günlük KotasyonAFK KODU(*) 3 karakter H Acente Fon Kodu. AFK kodu girilmediği durumda “0” yer alacaktır.MÜŞTERİ TİPİ (*) 4 karakter E MÜŞ:Müşteri, PORT:Portföy, FON:FonHESAP NO (*) 15 karakter E Sola dayalı olup maksimum 15 uzunluğundadır.REFERANS (*) 6 karakter H Sola dayalı olup maksimum 6 uzunluğundadır. Referans girilmezse

bu alana “0” değeri basılacaktır.ALIS EMİR NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen Alış emir numarası.SATIS EMİR NUMARASI 16 hane nümerik E İşlem Sistemi tarafından verilen Satış emir numarası.TEMSİLCİ NO(*) 4 hane nümerik E Kotasyonu giren temsilcinin numarası

AÇIKLAMA (**) x karakter E Girilen emirin özelliklerine bağlı olarak değişen uzunluklarda olan ve çeşitli açıklama ifadelerini içeren alandır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

J 43173850363717 12:21:03 KOTASYON 2606200900001025 PT22T.V 1000 5.00 10.00 2000 01 0 PORT HESAPNO123 0 2606200900001023 2606200900001024 1225 İSTENDİ

J 43213160471844 10:14:40 KOTASYON 2606200900001062 YK01D.V 1000 1.00 2.00 2000 01 TIB PORT HESAPKOTA111 REF 2606200900001060 2606200900001061 26 İSTENDİ

J 43230705544105 12:14:53 KOTASYON 3009200900000023 SP05T.V 1000 5.00 10.00 2000 01 0 PORT HES 0 3009200900000021 3009200900000022 26 İSTENDİ

0--------1---------2---------3---------4---------5---------6---------7---------8

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 61

Page 63: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.4.4.6 Temsilci Kotasyon Güncelleme Mesajı

ExAPI veya bir temsilci tarafından girilen kotasyon üzerinde, ilgili üyenin bir temsilcisi değişiklik yaptığında, güncelleme mesajı kotasyonu ilk giren temsilciye gönderilmektedir. Tanımlanan bu mesajla, temsilci terminaline gönderilen güncelleme mesajı ilgili üyenin yetkilendirilmiş ExAPI terminaline de gönderilecektir. Ayrıca ilk kotasyonun bir temsilci tarafından girilmiş olduğu durumda, kotasyonun miktarının sıfıra düşmesi sonrasında otomatik olarak güncellenmesi durumunda hem kotasyonun sahibi temsilciye, hem de yetkilendirilmiş ExAPI terminaline kotasyon güncelleme mesajı gönderilecektir.

İlgili mesaj, İşlem Sistemi’nden Borsa İstanbul ExAPI PC’ye tek yönlü olarak gönderilir. Borsa İstanbul ExAPI PC de bu mesajı Üye Sistemi’ne tek yönlü olarak ve asenkron kanal üzerinden gönderir. Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden bu mesajın cevabını veya alındığını belirtir nitelikte herhangi bir mesaj beklemez.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E O: Kotasyon güncelleme.LOG SIRA NUMARASI

14 hane nümerik E PC’lerde “tüm mesaj alanı” olarak adlandırılan mesaj dosyasına yazılan kotasyon güncellenme bilgisinin sıra numarası.

İŞLEME ZAMANI 8 karakter E İşlem sistem tarafından son işlem mesajının üretidiği zamanı belirtir.HH:MM:SS formatındadır.

KOTASYON DURUMU

8 karakter E KOTASYON : Kotasyon güncellendi.

KOTASYON NUMARASI

16 hane nümerik E İşlem Sistemi tarafından verilen kotasyon numarası.

PAY ISLEM SIRASI ve SERİ KODU (*)

8 karakter E Kotasyonun ait olduğu işlem sırasının kod ve seri bilgisi.HİSSE.SR formatındadır.

ALIŞ/SATIŞ (*) 5 karakter E ALIS: Alış Emri, SATIS: Satış EmriEMİR NUMARASI 16 hane nümerik Sistem tarafından verilen emir numarasıMİKTAR (*) 8 hane nümerik E Güncellenen alış/satış miktarı.MİKTAR BİRİM 3 karakter E LOT : Miktarın birimini gösterir.FİYAT (*) 8 hane noktalı

nümerikE Güncellenen alış/satış emrinin fiyatı

TEMSİLCİ NO(*) 4 hane nümerik E Kotasyonu güncelleyen temsilcinin numarasıAÇIKLAMA (**) X karakter E Açıklama alanında sadece “GUNCELLENDI.” Ifadesi yer alacaktır.

(*) : Bu alanlar değişken uzunluklu veri taşıyan alanlardır. Yukarıdaki tablodaki “Alan Türü” kolonunda verilen değerler, ilgili alanların maksimum uzunluklarını belirtir.

(**) : Bu alandaki açıklama ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Bu mesajın uzunluğu 200 karakterdir ve tüm alanlar birbirlerinden birer ayraç (boşluk ya da tab karakteri) ile ayrılmış haldedir.

Mesaj Örnekleri

O 43180408122626 15:57:55 KOTASYON 2606200900001025 PT22T.V ALIS 2606200900001049 2000 LOT 6.00 26 GUNCELLENDI.

O 43213188001442 10:21:41 KOTASYON 2606200900001062 YK01D.V ALIS 2606200900001060 0 LOT 1.00 26 GUNCELLENDI.

O 43213193572730 10:23:06 KOTASYON 2606200900001062 YK01D.V SATIS 2606200900001061 1200 LOT 2.00 26 GUNCELLENDI.

0--------1---------2---------3---------4---------5---------6---------7---------8

3.4.5 Genel Yayın Mesajı

Bu mesaj ile üye, sistemde yer alan tüm kullanıcıları ilgilendiren mesajları kendi sistemlerine alabileceklerdir.

Bu tür mesajlar, sistemde üretilen pazar açılış ve kapanışlarını, emir girişi ve işlem gerçekleşmesi durumunda oluşan ve tüm kullancıları ilgilendiren mesajları (payın işlem sırasının durdurulması gibi) ve kontrol kullancıları tarafından girilen bilgilendirme amaçlı mesajları (şirketlerle ilgili bilgiler) içerirler.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E G: Genel yayın mesajı anlamında

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 62

Page 64: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Alan Adı Alan Türü Zor. AçıklamaLOG SIRA NUMARASI

14 hane nümerik E Üyenin en son aldığı cevap mesajındaki mesajın LOG SIRA NUMARASI bilgisi.

İŞLEME ZAMANI 8 karakter E Gönderilen mesajın İşlem Sistemi tarafından işlendiği zamanı belirtir.HH:MM:SS formatındadır.

AÇIKLAMA (**) x karakter E Sistemden temsilci ekranlarına gönderilen genel yayın mesajının boyuna bağlı olarak değişen uzunluklarda olan haber bilgisini içermektedir.

(**) : Bu alandaki genel yayın bilgisinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Mesaj Örnekleri

G 00010000000150 10:00:00 ULUSAL PIYASA ACILDI.G 00010000001489 15:00:00 GOZALTI PAZARI KAPANDI.G 00010000021345 11:54:03 OZEL EMIR ISLEMI VAR, Hisse : ANHYT.E. 7000000 Fiyat 30.G 00010000042157 15:10:51 *** Devam Eden R.H.K.P.: FACF.R (15.11.2000,MAKBUZ, Rüçhan Hakkı Kuponları 1-YTL nominal G 00010000042157 değerli bir hisse için 1-YTL’den kullandırılacaktır). Kapanış tarihi parantez içerisinde G 00010000042157 belirtilmiştir. ***G 00010072619914 14:57:24 EREGL.E : ACILIYOR Saat : Simdi.G 00010079841044 14:58:02 ADANA.E : ISLEMLERI DURDURULACAK Saat : Simdi. (Not: Sürekli müzayede içinde tekrar açılışa alınmayıp girilmiş olan emirlerin iptal edilmesi gerektiği durumda mükerrer olarak gelebilecektir.)G 00010456789993 16:35:48 SISTEM GUN SONU ISLEMLERINI YAPIYOR.G 13991849198354 16:18:00 ALCTL.E : ACILIS SEANSI BASLIYOR Saat : Simdi(Not: Açılış aşamasına sonradan katılma veya Müzayede içerisinde pay bazında açılış yapılması durumunda payda açılışın başladığını gösteren mesaj)G 24341090318444 14:41:00 ALCTL.E : ACILIS ISLEMLERI TAMAMLANMISTIR.Simdi(Not : Müzayede seansı içerisinde pay bazında açılış yapılması durumunda ya da açılış seansına sonradan katılan payda emirler girilip açılış işlemleri tamamlandığı anda bu mesaj gelecektir.)

G 43173456664540 10:40:56 PEGYO.E ISLEMLERI DURDURULACAK. Saat : Simdi Kotasyon Atanamadi.(Not: Paya/fona ilk kotasyon girişi yapılamamış, payda kotasyon yok)G 40871365898344 14:47:53 ADEL.E Isleme acilacak. Saat 14:50:53. Kotasyon girilmistir. (Not: İlk kotasyon girilmediği için işlemleri durdurulmuş bir paya /fona piyasa yapıcının ilk kotasyon girmesi sonrasında payın açılması)G 40871377694951 14:50:53 ADEL.E ISLEME ACILIYOR Saat : SimdiG 40740922306732 15:15:37 MIGRS.E : ISLEMLERI DURDURULACAK Saat : Simdi Ilgili Hissedeki Tum Emirler Iptal Edildi. G 40446365897896 15:17:23 PT22T.V kotasyon girilmistir. (Not: Varant ve sertifika sıralarına ilk kotasyon girişi yapıldığında bilgilendirme amaçlı olarak bu mesaj bütün kullanıcılara gönderilir.)

G 53421080345725 17:30:30 ULUSAL PIYASA : EMIR AKTARIMI BASLADI.

G 53421080345744 17:30:30 IKINCI ULUSAL PAZAR : EMIR AKTARIMI BASLADI.

G 53421080345748 17:30:30 KURUMSAL URUNLER PAZARI : EMIR AKTARIMI BASLADI.

G 53421080345750 17:30:30 GELISEN ISLETMELER PIYASASI : EMIR AKTARIMI BASLADI.

G 53421080345754 17:30:30 SERBEST ISLEM PLATFORMU : EMIR AKTARIMI BASLADI.

G 53421080345756 17:30:30 GOZALTI PAZARI : EMIR AKTARIMI BASLADI.

G 53421080545625 17:30:31 ULUSAL PIYASA : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 63

Page 65: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

G 53421080545687 17:30:32 IKINCI ULUSAL PAZAR : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

G 53421080545730 17:30:33 KURUMSAL URUNLER PAZARI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

G 53421080545766 17:30:34 GELISEN ISLETMELER PIYASASI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

G 53421080545792 17:30:35 SERBEST ISLEM PLATFORMU : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

G 53421080545803 17:30:36 GOZALTI PAZARI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

G 53421080563637 17:32:00 KAPANIS SEANSI MODU BASLADI.

G 53421100222100 17:33:00 KAPANIS SEANSI ULUSAL PIYASA ACILDI.

G 53421100222556 17:33:00 KAPANIS SEANSI IKINCI ULUSAL PAZAR ACILDI.

G 53421100223451 17:33:00 KAPANIS SEANSI KURUMSAL URUNLER PAZARI ACILDI.

G 53421100224088 17:33:00 KAPANIS SEANSI GELISEN ISLETMELER PIYASASI ACILDI.

G 53421100225498 17:33:00 KAPANIS SEANSI SERBEST ISLEM PLATFORMU ACILDI.

G 53233278897184 17:33:00 KAPANIS SEANSI GOZALTI PAZARI ACILDI.

G 53421898465409 17:34:00 DOHOL.E : KAPANIS SEANSI BASLIYOR Saat : Simdi

G 53421906331480 17:36:00 DOHOL.E : KAPANIS ISLEMLERI TAMAMLANMISTIR.Simdi

G 53421159204860 17:36:00 KAPANIS SEANSI ULUSAL PIYASA KAPANDI.

G 53421159205359 17:36:00 KAPANIS SEANSI IKINCI ULUSAL PAZAR KAPANDI.

G 53421159205864 17:36:00 KAPANIS SEANSI KURUMSAL URUNLER PAZARI KAPANDI.

G 53421159206716 17:36:00 KAPANIS SEANSI GELISEN ISLETMELER PIYASASI KAPANDI.

G 53421159207500 17:36:00 KAPANIS SEANSI SERBEST ISLEM PLATFORMU KAPANDI.

G 53421159207500 17:36:00 KAPANIS SEANSI GOZALTI PAZARI KAPANDI.

G 53421159270407 17:36:01 ULUSAL PIYASA KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159339761 17:36:02 ULUSAL PIYASA KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159404351 17:36:03 IKINCI ULUSAL PAZAR KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159471360 17:36:04 IKINCI ULUSAL PAZAR KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159536589 17:36:05 KURUMSAL URUNLER PAZARI KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159602459 17:36:06 KURUMSAL URUNLER PAZARI KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159667807 17:36:07 GELISEN ISLETMELER PIYASASI KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159733402 17:36:08 GELISEN ISLETMELER PIYASASI KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159798914 17:36:09 SERBEST ISLEM PLATFORMU KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159864508 17:36:10 SERBEST ISLEM PLATFORMU KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159866372 17:36:11 GOZALTI PAZARI KAPANIS SEANSI ISLEMLERI BASLIYOR.

G 53421159866436 17:36:11 GOZALTI PAZARI KAPANIS SEANSI ISLEMLERI BITTI.

G 53421159865117 17:36:12 KAPANIS SEANSI MODU BITTI.

G 53421198526472 17:38:00 ULUSAL PIYASA KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 64

Page 66: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

G 53421198527295 17:38:00 IKINCI ULUSAL PAZAR KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

G 53421198527478 17:38:00 KURUMSAL URUNLER PAZARI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

G 53421198528334 17:38:00 GELISEN ISLETMELER PIYASASI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

G 53421198529114 17:38:00 SERBEST ISLEM PLATFORMU KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

G 53421198527478 17:38:00 GOZALTI PAZARI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

G 53421316491282 17:40:00 ULUSAL PIYASA KAPANIS FIYATINDAN ISLEMLER BITTI.

G 53421316492109 17:40:00 IKINCI ULUSAL PAZAR KAPANIS FIYATINDAN ISLEMLER BITTI.

G 53421316492292 17:40:00 KURUMSAL URUNLER PAZARI KAPANIS FIYATINDAN ISLEMLER BITTI.

G 53421316493152 17:40:00 GELISEN ISLETMELER PIYASASI KAPANIS FIYATINDAN ISLEMLER BITTI.

G 53421316493932 17:40:00 SERBEST ISLEM PLATFORMU KAPANIS FIYATINDAN ISLEMLER BITTI.

G 53421198527478 17:40:00 GOZALTI PAZARI KAPANIS FIYATINDAN ISLEMLER BITTI.0--------1---------2---------3---------4---------5---------6---------7---------8

Not : Yukarıda 00010000042157 log sıra numaralı mesaj örneğinde olduğu gibi bir satıra sığmayan mesajlar asenkron kanaldan gönderilecek olan birden fazla mesaj ile üye sistemine ulaştırılacaktır. Bu tür mesajların “log sıra numarası” alanlarında aynı değer bulunur ve “işleme zamanı” alanı ise sadece ilk satır için doldurulmuş olarak gönderilir. Ayrıca ExAPI uygulamasının çalıştığı PC’nin ekran ayarlarına bağlı olarak bir satırda gösterilebilecek karakter sayısı değişeceğinden, bu şekilde bir satırdan fazla uzunlukta gönderilen genel yayın mesajları farklı PC’lerdeki ekran çözünürlüklerine bağlı olarak farklı sayıda satırla üye sistemine ulaştırılabilecektir.

Aşağıdaki listede piyasa açılış ve kapanışlarının kullanıcılara bildirilmesi için sistem tarafından üretilen genel yayın mesajlarının tümü yer almaktadır.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

ULUSAL PIYASA ACILDI. Ulusal Pazarda sürekli müzayede aşamasında emir iletimi başlatılabilir.

ULUSAL PIYASA KAPANDI. Ulusal Pazarda sürekli müzayede aşamasında emir iletimi sona erdi.

IKINCI ULUSAL PAZAR ACILDI. İkinci Ulusal Pazarda sürekli müzayede aşamasında emir iletimi başlatılabilir.

IKINCI ULUSAL PAZAR KAPANDI. İkinci Ulusal Pazarda sürekli müzayede aşamasında emir iletimi sona erdi.

GOZALTI PAZARI ACILDI. Gözaltı Pazarında sürekli müzayede aşamasında emir iletimi başlatılabilir.

GOZALTI PAZARI KAPANDI. Gözaltı Pazarında sürekli müzayede aşamasında emir iletimi sona erdi.

BIRINCIL PIYASA ACILDI. Birincil Piyasada emir iletimi başlatılabilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 65

Page 67: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

BIRINCIL PIYASA KAPANDI. Birincil Piyasada emir iletimi sona erdi.

KURUMSAL URUNLER PAZARI ACILDI. Kurumsal Ürünler Pazarı’nda sürekli müzayede, piyasa yapıcılı sürekli müzayede ve tek fiyat yönteminde işlem gören menkul kıymetler için emir iletiminin başladığını bildiren mesajdır.

KURUMSAL URUNLER PAZARI KAPANDI. Kurumsal Ürünler Pazarı’nda sürekli müzayede, piyasa yapıcılı sürekli müzayede ve tek fiyat yönteminde işlem gören menkul kıymetler için emir iletiminin sona erdiğini bildiren mesajdır.

SERBEST ISLEM PLATFORMU ACILDI. Serbest İşlem Platformunda sürekli müzayede, piyasa yapıcılı sürekli müzayede ve tek fiyat yönteminde işlem gören menkul kıymetler için emir iletiminin başladığını bildiren mesajdır.

SERBEST ISLEM PLATFORMU KAPANDI. Serbest İşlem Platformunda sürekli müzayede, piyasa yapıcılı sürekli müzayede ve tek fiyat yönteminde işlem gören menkul kıymetler için emir iletiminin sona erdiğini bildiren mesajdır.

GELISEN ISLETMELER PIYASASI ACILDI. Gelişen İşletmeler Piyasası’nda piyasa yapıcılı sürekli müzayede ve tek fiyat belirleme aşamasında emir iletimi başladı.

GELISEN ISLETMELER PIYASASI KAPANDI. Gelişen İşletmeler Piyasası’nda piyasa yapıcılı sürekli müzayede ve tek fiyat belirleme aşamasında emir iletiminin sona erdi.

ACILIS SEANSI ULUSAL PIYASA ACILDI. Ulusal Piyasada açılış seansının emir toplama aşaması başladı.

ACILIS SEANSI ULUSAL PIYASA KAPANDI. Ulusal Piyasada açılış seansının emir toplama aşaması sona erdi.

ACILIS SEANSI IKINCI ULUSAL PAZAR ACILDI. İkinci Ulusal Pazarda açılış seansının emir toplama aşaması başladı.

ACILIS SEANSI IKINCI ULUSAL PAZAR KAPANDI. İkinci Ulusal Pazarda açılış seansının emir toplama aşaması sona erdi.

ACILIS SEANSI GOZALTI PAZARI ACILDI. Gözaltı Pazarında açılış seansının emir toplama aşaması başladı.

ACILIS SEANSI GOZALTI PAZARI KAPANDI. Gözaltı Pazarında açılış seansının emir toplama aşaması sona erdi.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 66

Page 68: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi AçıklamaACILIS SEANSI KURUMSAL URUNLER PAZARI ACILDI. Kurumsal Ürünler Pazarında açılış

seansının emir toplama aşaması başladı.

ACILIS SEANSI KURUMSAL URUNLER PAZARI KAPANDI. Kurumsal Ürünler Pazarında açılış seansının emir toplama aşaması sona erdi.

ACILIS SEANSI SERBEST ISLEM PLATFORMU ACILDI. Serbest İşlem Platformunda açılış seansının emir toplama aşaması başladı.

ACILIS SEANSI SERBEST ISLEM PLATFORMU KAPANDI. Serbest İşlem Platformunda açılış seansının emir toplama aşaması sona erdi.

ACILIS SEANSI GELISEN ISLETMELER PIYASASI ACILDI. Gelişen İşletmeler Piyasasında açılış seansının emir toplama aşaması başladı.

ACILIS SEANSI GELISEN ISLETMELER PIYASASI KAPANDI. Gelişen İşletmeler Piyasasında açılış seansının emir toplama aşaması sona erdi.

ULUSAL PIYASA ACILIS SEANSI ISLEMLERI BASLIYOR. Ulusal Piyasa’da açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesaj ilgili pazarın açılış emir toplamaaralığının kapandığına dair mesajdan sonra gelir.

ULUSAL PIYASA ACILIS SEANSI ISLEMLERI BITTI. Ulusal Pazar’da açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

IKINCI ULUSAL PAZAR ACILIS SEANSI ISLEMLERI BASLIYOR. İkinci Ulusal Pazar’da açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesaj ilgili pazarın açılış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

IKINCI ULUSAL PAZAR ACILIS SEANSI ISLEMLERI BITTI. İkinci Ulusal Pazar’da açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 67

Page 69: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

GOZALTI PAZARI ACILIS SEANSI ISLEMLERI BASLIYOR. Gözaltı Pazarı’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesaj ilgili pazarın açılış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

GOZALTI PAZARI ACILIS SEANSI ISLEMLERI BITTI. Gözaltı Pazarı’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

KURUMSAL URUNLER PAZARI ACILIS SEANSI ISLEMLERI BASLIYOR.

Kurumsal Ürünler Pazarı’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir.

KURUMSAL URUNLER PAZARI ACILIS SEANSI ISLEMLERI BITTI.

Kurumsal Ürünler Pazarı’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

SERBEST ISLEM PLATFORMU ACILIS SEANSI ISLEMLERI BASLIYOR. Serbest İşlem Platformunda açılış

seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir.

SERBEST ISLEM PLATFORMU ACILIS SEANSI ISLEMLERI BITTI. Serbest İşlem Platformunda açılış

seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

KURUMSAL URUNLER PAZARI KOTASYON ILETIMI BASLADI. Kurumsal Ürünler Pazarı’nda piyasa yapıcılı yönteminde işlem gören menkul kıymetlerde piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

ULUSAL PIYASA KOTASYON ILETIMI BASLADI. Ulusal Pazar’da piyasa yapıcılı yöntemde işlem gören menkul kıymetlerde piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 68

Page 70: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

IKINCI ULUSAL PAZAR KOTASYON ILETIMI BASLADI. İkinci Ulusal Pazar’da piyasa yapıcılı yöntemde işlem gören menkul kıymetlerde piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

GOZALTI PAZARI KOTASYON ILETIMI BASLADI. Gözaltı Pazarı’nda piyasa yapıcılı yöntemde işlem gören menkul kıymetlerde piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

SERBEST ISLEM PLATFORMU KOTASYON ILETIMI BASLADI. Serbest İşlem Platformunda piyasa yapıcılı yöntemde işlem gören menkul kıymetlerde, piyasa yapıcılı işlem menkul kıymet varsa, piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

GELISEN ISLETMELER PIYASASI ACILIS SEANSI ISLEMLERI BASLIYOR.

Gelişen İşletmeler Piyasası’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girmeye başladığını bildirir.

GELISEN ISLETMELER PIYASASI ACILIS SEANSI ISLEMLERI BITTI.

Gelişen İşletmeler Piyasası’nda açılış seansında toplanan emirlerin belirlenen açılış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

GELISEN ISLETMELER PIYASASI KOTASYON ILETIMI BASLADI. Gelişen İşletmeler Piyasası’nda

piyasa yapıcılı yönteminde işlem gören menkul kıymetlerde piyasa yapıcı üyeler tarafından kotasyon girilmeye başlanabileceğini bildiren mesajdır. Bu mesaj pazarda açılış işlemlerinin bittiğine ilişkin mesajın hemen ardından gelir.

ACILIS SEANSI MODU BASLADI. Bazı sorguların ve piyasa izleme ekranının kapalı hale geldiği, daha sonra başlayacak olan emir iletimi aşaması için sistemin modunu değiştiren mesaj.

ACILIS SEANSI MODU BITTI. Açılış öncesi seansında toplanan emirlerin işleme girmesi sonrasında piyasa izleme ekranının, sorguların ve yayının başladığını bildirmek amacıyla gönderilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 69

Page 71: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi AçıklamaTEK FIYAT EMIR ILETIM MODU BASLADI. Tek fiyat yönteminde işlem gören

menkul kıymetler için bazı sorgu ekranlarının ve piyasa izleme ekranının kapalı hale geldiği, daha sonra başlayacak olan tek fiyat emir iletimi aşaması için sistemin modunu değiştiren mesaj

ULUSAL PIYASA TEK FIYAT ISLEMLERI BASLIYOR. Ulusal Pazarda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda pazarda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

ULUSAL PIYASA TEK FIYAT ISLEMLERI BITTI. Ulusal Pazarda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

IKINCI ULUSAL PAZAR TEK FIYAT ISLEMLERI BASLIYOR. İkinci Ulusal Pazarda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda pazarda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

IKINCI ULUSAL PAZAR TEK FIYAT ISLEMLERI BITTI. İkinci Ulusal Pazarda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 70

Page 72: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi AçıklamaKURUMSAL URUNLER PAZARI TEK FIYAT ISLEMLERI BASLIYOR. Kurumsal Ürünler Pazarı’nda tek

fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda pazarda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

KURUMSAL URUNLER PAZARI TEK FIYAT ISLEMLERI BITTI. Kurumsal Ürünler Pazarı’nda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

GOZALTI PAZARI TEK FIYAT ISLEMLERI BASLIYOR. Gözaltı Pazarında tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda pazarda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

GOZALTI PAZARI TEK FIYAT ISLEMLERI BITTI. Gözaltı Pazarında tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

SERBEST ISLEM PLATFORMU TEK FIYAT ISLEMLERI BASLIYOR.

Serbest İşlem Platformunda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda platformda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 71

Page 73: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

SERBEST ISLEM PLATFORMU TEK FIYAT ISLEMLERI BITTI. Serbest İşlem Platformunda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

GELISEN ISLETMELER PIYASASI TEK FIYAT ISLEMLERI BASLIYOR.

Gelişen İşletmeler Piyasası’nda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin belirlenen tek fiyat üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanacaktır. Bu mesajla birlikte aynı zamanda pazarda tek fiyat yöntemiyle işlem gören menkul kıymetlerde emir toplama aşaması sona erer.

GELISEN ISLETMELER PIYASASI TEK FIYAT ISLEMLERI BITTI. Kurumsal Ürünler Pazarı’nda tek fiyat yöntemiyle işlem gören menkul kıymetler için tek fiyat emir toplama aşamasında toplanan emirlerin, belirlenen tek fiyat üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir

OTOMATIK KOTASYON ATAMA BASLADI. Piyasa yapıcılı işlem yönteminde işlem gören ve piyasa yapıcı üyesi tarafından sürekli müzayede öncesinde belirlenen sure içinde kotasyon girilmeyen payda/fonlarda Borsa İstanbul Sistemi tarafından otomatik ilk kotasyon atamasının başladığını bildirir.

OTOMATİK KOTASYON ILETIMI BITTI. Piyasa yapıcılı işlem yönteminde işlem gören ve piyasa yapıcı üyesi tarafından sürekli müzayede öncesinde belirlenen süre içinde kotasyon girilmeyen paylarda/fonlarda Borsa İstanbul Sistemi tarafından otomatik ilk kotasyon ataması yapılma sürecinin bittiğini bildirir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 72

Page 74: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

KOTASYON ILETIMI BASLADI. Açılış seansı bittikten sonra herhangi bir nedenle seansın durdurulması durumunda, seansın sürekli müzayede bölümü başlamadan once piyasa yapıcılı menkul kıymetlerde kotasyon giriş ve değişikliğine imkan veren “Kotasyon İletimi” periyodunun başladığını bildiren mesajdır.

Bu mesaj sonrasında sırasıyla “OTOMATIK KOTASYON ATAMA BASLADI.”, “OTOMATIK KOTASYON ILETIMI BITTI.” Mesajları gelecek ardından pazarlar emir girişine açılacaktır.

KAPANIS SEANSI MODU BASLADI. Bazı sorguların ve piyasa izleme ekranının kapalı hale geldiği, daha sonra başlayacak olan emir iletimi aşaması için sistemin modunu değiştiren mesaj.

KAPANIS SEANSI ULUSAL PIYASA ACILDI. Ulusal Piyasada kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI IKINCI ULUSAL PAZAR ACILDI. İkinci Ulusal Pazarda kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI KURUMSAL URUNLER PAZARI ACILDI. Kurumsal Ürünler Pazarında kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI GELISEN ISLETMELER PIYASASI ACILDI.

Gelişen İşletmeler Piyasası kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI SERBEST ISLEM PLATFORMU ACILDI. Serbest İşlem Platformu kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI GOZALTI PAZARI ACILDI. Gözaltı Pazarı kapanış seansının emir toplama aşaması başladı.

KAPANIS SEANSI ULUSAL PIYASA KAPANDI. Ulusal Piyasa kapanış seansının emir toplama aşaması sona erdi.

KAPANIS SEANSI IKINCI ULUSAL PAZAR KAPANDI. İkinci Ulusal Pazar kapanış seansının emir toplama aşaması sona erdi.

KAPANIS SEANSI KURUMSAL URUNLER PAZARI KAPANDI. Kurumsal Ürünler Pazarı kapanış seansının emir toplama aşaması sona erdi.

KAPANIS SEANSI GELISEN ISLETMELER PIYASASI KAPANDI.

Gelişen İşletmeler Piyasası kapanış seansının emir toplama aşaması sona erdi.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 73

Page 75: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

KAPANIS SEANSI SERBEST ISLEM PLATFORMU KAPANDI. Serbest İşlem Platformu kapanış seansının emir toplama aşaması sona erdi.

KAPANIS SEANSI GOZALTI PAZARI KAPANDI. Gözaltı Pazarı kapanış seansının emir toplama aşaması sona erdi.

ULUSAL PIYASA KAPANIS SEANSI ISLEMLERI BASLIYOR. Ulusal Piyasada kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

ULUSAL PIYASA KAPANIS SEANSI ISLEMLERI BITTI. Ulusal Pazarda kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

IKINCI ULUSAL PAZAR KAPANIS SEANSI ISLEMLERI BASLIYOR.

İkinci Ulusal Pazarda kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

IKINCI ULUSAL PAZAR KAPANIS SEANSI ISLEMLERI BITTI.

İkinci Ulusal Pazarda kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

KURUMSAL URUNLER PAZARI KAPANIS SEANSI ISLEMLERI BASLIYOR.

Kurumsal Ürünler Pazarı kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

KURUMSAL URUNLER PAZARI KAPANIS SEANSI ISLEMLERI BITTI.

Kurumsal Ürünler Pazarında kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 74

Page 76: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

GELISEN ISLETMELER PIYASASI KAPANIS SEANSI ISLEMLERI BASLIYOR.

Gelişen İşletmeler Piyasası kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

GELISEN ISLETMELER PIYASASI KAPANIS SEANSI ISLEMLERI BITTI.

Gelişen İşletmeler Piyasası kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

SERBEST ISLEM PLATFORMU KAPANIS SEANSI ISLEMLERI BASLIYOR.

Serbest İşlem Platformu kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

SERBEST ISLEM PLATFORMU KAPANIS SEANSI ISLEMLERI BITTI.

Serbest İşlem Platformu kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

GOZALTI PAZARI KAPANIS SEANSI ISLEMLERI BASLIYOR. Gözaltı Pazarı kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girmeye başladığını bildirir. İşlem mesajları bu başlangıç mesajından sonra PC’ye gönderilmeye başlanır. Bu mesaj ilgili pazarın kapanış emir toplama aralığının kapandığına dair mesajdan sonra gelir.

GOZALTI PAZARI KAPANIS SEANSI ISLEMLERI BITTI. Gözaltı Pazarı kapanış seansında toplanan emirlerin belirlenen kapanış fiyatı üzerinden işleme girme sürecinin tamamlanmış olduğunu bildirir.

KAPANIS SEANSI MODU BITTI. Kapanış seansın işlemlerinin tamamlanması ile birlikte piyasa izleme ekranının, sorguların ve yayının başladığını bildirmek amacıyla gönderilir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 75

Page 77: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

ULUSAL PIYASA KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Ulusal Piyasa için kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

ULUSAL PIYASA KAPANIS FIYATINDAN ISLEMLER BITTI. Ulusal Piyasa kapanış fiyatından işlemler bölümü sona erdi.

IKINCI ULUSAL PAZAR KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

İkinci Ulusal Pazar için kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

IKINCI ULUSAL PAZAR KAPANIS FIYATINDAN ISLEMLER BITTI.

İkinci Ulusal Pazar kapanış fiyatından işlemler bölümü sona erdi.

KURUMSAL URUNLER PAZARI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Kurumsal Ürünler Pazarı için kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

KURUMSAL URUNLER PAZARI KAPANIS FIYATINDAN ISLEMLER BITTI.

Kurumsal Ürünler Pazarı kapanış fiyatından işlemler bölümü sona erdi.

GELISEN ISLETMELER PIYASASI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Gelişen İşletmeler Piyasası kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

GELISEN ISLETMELER PIYASASI KAPANIS FIYATINDAN ISLEMLER BITTI.

Gelişen İşletmeler Piyasası kapanış fiyatından işlemler bölümü sona erdi.

SERBEST ISLEM PLATFORMU KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Serbest İşlem Platformu kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 76

Page 78: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

Piyasa Açılış ve Kapanışlarıyla İlgili Genel Yayın Mesajları Listesi Açıklama

SERBEST ISLEM PLATFORMU KAPANIS FIYATINDAN ISLEMLER BITTI.

Serbest İşlem Platformu kapanış fiyatından işlemler bölümü sona erdi.

GOZALTI PAZARI KAPANIS FIYATINDAN ISLEMLER BASLIYOR.

Gözaltı Pazarı kapanış seansında belirlenmiş olan kapanış fiyatı ile sınırlı olarak Sisteme iletilebilecek yeni alış ve satış emirleri ile Sistemde bu fiyatlardan beklemekte olan pasif emirlerin karşılaşarak belirlenmiş fiyattan işlemlerin gerçekleşeceği aşamanın başladığını belirtir.

GOZALTI PAZARI KAPANIS FIYATINDAN ISLEMLER BITTI. Gözaltı Pazarı kapanış fiyatından işlemler bölümü sona erdi.

ULUSAL PIYASA : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için Ulusal Piyasa emir aktarımı sona erdi.

IKINCI ULUSAL PAZAR : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için İkinci Ulusal Pazar emir aktarımı sona erdi.

KURUMSAL URUNLER PAZARI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için Kurumsal Ürünler Pazarı emir aktarımı sona erdi.

GELISEN ISLETMELER PIYASASI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için Gelişen İşletmeler Piyasası emir aktarımı sona erdi.

SERBEST ISLEM PLATFORMU : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için Serbest İşlem Platformu emir aktarımı sona erdi.

GOZALTI PAZARI : EMIR AKTARIM ISLEMLERI TAMAMLANMISTIR.

Kapanış seansı için Gözaltı Pazarı emir aktarımı sona erdi.

ULUSAL PIYASA : EMIR AKTARIMI BASLADI. Kapanış seansı için Ulusal Piyasa emir aktarımı başladı.

IKINCI ULUSAL PAZAR : EMIR AKTARIMI BASLADI. Kapanış seansı için İkinci Ulusal Pazar emir aktarımı başladı.

KURUMSAL URUNLER PAZARI : EMIR AKTARIMI BASLADI. Kapanış seansı için Kurumsal Ürünler Pazarı emir aktarımı başladı.

GELISEN ISLETMELER PIYASASI : EMIR AKTARIMI BASLADI.

Kapanış seansı için Gelişen İşletmeler Piyasası emir aktarımı başladı.

SERBEST ISLEM PLATFORMU : EMIR AKTARIMI BASLADI. Kapanış seansı için Serbest İşlem Platformu emir aktarımı başladı.

GOZALTI PAZARI : EMIR AKTARIMI BASLADI. Kapanış seansı için Gözaltı Pazarı emir aktarımı başladı.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 77

Page 79: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

3.4.6 ExAPI Durum Bilgisi Mesajı

Bu mesaj tipiyle üye sistemine, ExAPI PC’sinin durumu ile ilgili bilgiler aktarılacaktır. ExAPI Durum Bilgisi Mesajlarının aktarılması asenkron kanal üzerinden gerçekleştirilecektir. Bu mesaj tipinin tanımlanmasındaki esas amaç, üye tarafında çalışan programların, ExAPI PC’lerinin mesajlaşmaya hazır olup olmaması gibi durumlarını kurulan asenkron bağlantı üzerinden otomatik olarak algılamasını sağlamaktır. ExAPI PC’si ile üye sistemi arasında sağlıklı bir şekilde senkron ve asenkron bağlantı kurulduktan sonra ExAPI PC’lerininde “API Başlat” butonuna basılmasıyla ya da mesajlaşmanın belli bir anında “Vazgeç/Kapat” butonuna basılmasıyla değişik tipteki bilgi mesajları asenkron kanaldan üye sistemine ulaştırılacaktır. Böylece üye sisteminin ExAPI PC’lerine mesaj göndermeye başlaması ya da mesaj göndermeyi durdurması kullanıcı gözlemlerine bağlı olmaksızın sağlanabilecektir.

Not : API Durum Bilgisi Mesajı sistem tarafından üretilmeyip ExAPI PC’si tarafından üretildiği için herhangi bir log sıra numarasına sahip değildir (ExAPI PC’sinin sabit diskine loglanmamaktadır). Dolayısıyla, diğer bilgi mesajlarında olduğu gibi (örn.3.4.1, 3.4.2) üye sisteminden gönderilecek “Biriken Mesajları İndirme” isteğiyle daha önce alınabilen bu tipteki bilgi mesajlarının, sonraki aşamalarda kontrol amaçlı olarak üyelerin kendi sistemlerine indirilmesi mümkün olmayacaktır.

Borsa İstanbul ExAPI PC’den Üye Sistemi’ne gönderilen ExAPI Durum Bilgisi Mesajı aşağıda belirtilen mesaj yapısıyla üyenin ortamına gönderilecektir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E B: ExAPI Durum Bilgisi Mesajı anlamındaİŞLEM TİPİ 2 hane nümerik E ExAPI Durum Bilgi Mesajlarını birbirinden ayırmak için kullanılır.

01 : ExAPI uygulaması çalıştırılmış ve mesaj bekleme moduna geçirilmiş.Üye sisteminden mesaj gönderilebilir.

02 : ExAPI PC’sinde “ExAPI Mesaj Ekranı”ndan çıkılmış. Üye sisteminden gönderilecek mesajlar kabul edilmeyecektir.

03…99 : Gelecekte ihtiyaç duyulması durumunda kullanılacaktır. (*)

KULLANICI KODU 4 hane nümerik E ExAPI PC’sinden sisteme “login” olan temsilcinin kulanıcı koduAÇIKLAMA (**) x karakter E ExAPI PC’sinin durumuna bağlı olarak değişen uzunluklarda olan ve

çeşitli açıklama ifadelerini içeren alandır.

Tüm alanlar, birbirlerinden birer boşluk karakteri ile ayrılmış durumdadır.

(*) : Gelecekte üye tarafını bilgilendirme amacıyla oluşturulabilecek ExAPI PC’si kaynaklı yeni bilgi mesajları da Durum Bilgisi Mesajı’nın belirlenecek yeni “işlem tipi” değerleriyle gönderilecektir.

(**) : Bu alandaki açıklama bilgisinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır. Dolayısıyla yukarıdaki tabloda verilen “Alan Türü” kolonundaki uzunluk bilgisi “x” ile gösterilmektedir.

Mesaj Örnekleri

B 01 0150 İMKB Ex-API uygulaması çalıştırıldı. Mesajlaşma başlatılabilir.B 02 1125 İMKB Ex-API uygulaması kapatıldı. Yeni istek mesajları kabul edilmeyecektir.0--------1---------2---------3---------4---------5---------6---------7---------8

4. İŞLETİM AKIŞI VE ZAMANLAMALARIBorsa İstanbul ExAPI’nin işletimi, aşağıdaki tabloda belirtilen zamanlamalar ve kurallar içerisinde yapılmalıdır:

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 78

Page 80: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

İşlem Açıklama

Borsa İstanbul ExAPI Başlatma

Borsa İstanbul ExAPI’nin üzerinde çalıştığı PC sabah en erken saat 09:00’da, öğle en erken saat 13:15’te açılır ve Borsa İstanbul ExAPI uygulaması aşağıda belirtilen şekilde başlatılır:1. Öncelikle Borsa İstanbul ExAPI PC açılır ve gelen login ekranına temsilci ekranlarında olduğu

gibi kullanıcı kodu ve şifresi yazılarak Borsa İstanbul ExAPI PC’nin İşlem Sistemi’ne bağlanması sağlanır.

2. Borsa İstanbul ExAPI PC’nin İşlem Sistemi’nden ilk bilgi yükleme (download) işlemi bittikten sonra, ekrana piyasa ile ilgili bilgiler gelir.

3. Bu aşamadan sonra, “MENU” tuşuna basmak suretiyle Menü ekranına girilir. Gelen ekrandan “API Bağlantısı” seçilir.

4. Bu seçeneğin seçilmesi ile açılan ekrandan “API Başlat” butonuna basmak suretiyle Borsa İstanbul ExAPI uygulaması çalıştırılır. Bu noktadan itibaren Borsa İstanbul ExAPI PC’si, Üye Sistemi’nden gelecek olan bağlantı isteklerini karşılamaya hazırdır.Bu ekranda “Vazgeç/Kapat” butonuna basılması durumunda, Borsa İstanbul ExAPI uygulaması sona erer ve PC “Temsilci Ekranı” durumuna geçer.

5. Bu işlemin de tamamlanmasını takiben, Üye Sistemi’ndeki Borsa İstanbul ExAPI ile iletişim kuran program(lar) çalıştırılabilir.

Artık Borsa İstanbul ExAPI uygulaması devrededir.

Öğle Arası ExAPI’ler en erken seans bitiminden 5 dakika sonra kapatılmalıdır (otomatik kotasyon sebebiyle). Saat 13:00 ile 13:15 arasında, İşlem Sistemi tarafında yapılan işlemler nedeniyle, ExAPI PC’si ile İşlem Sistemi arasındaki bağlantı kapanacağından, bu saatler arasında herhangi bir mesaj gönderimi yapılmamalıdır. Ayrıca, bu saatler arasında Borsa İstanbul ExAPI PC İşlem Sistemi sisteme login durumda olmamalıdır. Bir sonraki seans için saat 13:15’ten sonra, Borsa İstanbul ExAPI PC’si kapatılıp sisteme login olunduktan sonra, “Borsa İstanbul ExAPI Başlatma” seçeneğindeki işlemler tekrar yapılmalıdır.

Borsa İstanbul ExAPI Durdurma

Borsa İstanbul ExAPI PC, sabah en geç saat 13:00’de öğleden sonra en geç saat 17:45’de aşağıda belirtilen şekilde kapatılır:1. Daha önce de bahsedildiği gibi ExAPI uygulamasının bileşenleri belirli bir sıra dahilinde

çalıştırılmalıdır. Bu nedenle bileşenlerin kapatılması da bir sıra dahilinde olur. Zaten XAPIFACE.EXE uygulamsının çalıştırılması ile gelen ara yüz, bu sırayı zorunlu kılacak şekildedir.

2. Öncelikle, kendi tarafınızdaki uygulamaları düzenli bir şekilde kapatmalısınız. Senkron ve Asenkron bağlantılarınızı düzenli bir şekilde kapattığınızda ExAPI Yönetim ekranı size bir mesaj verecektir. Bu mesaj bağlantınızı düzenli olarak kapattığınızı ve ExAPI uygulamsının da bağlantılarını düzenli olarak kapatacağını söyler. Bu mesajlara “Tamam” diye cevap verdikten sonra aşağıdaki işlemleri yapınız.

3. ExAPI Uygulamasının ekranında bulunan “API Bağlantısı” penceresinden “Vazgeç/Kapat” butonuna basmak suretiyle Borsa İstanbul EXAPI uygulamasını durdurunuz.

4. Sistem çıkış tuşuna basarak uygulamadan log-out olunuz. ( IMKB Ana Sisteminden çıkınız. )5. Sonra Ekspres API Yönetim Ekranına (XAPIFACE.EXE) dönüp, sıra ile XAPI

UYGULAMASINI BİTİR, ASENKRON KANALI KAPAT ve SENKRON KANALI KAPAT butonlarına basınız. Eğer işlemleri başarı ile tamamladı iseniz. ÇALIŞIYOR bölümündeki RX, TX ve TCAM butonları pasifi hale geçecektir. Eğer bu aşamalardan herhangi birinde sorun çıkar ise bir mesaj ile uyarılacaksınız. Bu durumda NT Task Manager’den NTVDM’in altındaki ilgili process’leri ( exapirx.exe, expaitx.exe gerekirse isectdr.exe ) öldürmeniz gerekecektir.

Bu işlemlerin de tamamlanmasını takiben, Borsa İstanbul ExAPI uygulaması durdurulmuş olur.

5. MESAJLAŞMA SORUNLARI

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 79

Page 81: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

5.1 Sorgulara Yanıt AlınamamasıBorsa İstanbul ExAPI PC’sinin ana sistemle mesajlaşması sırasında, sistemden ya da iletişim altyapısından kaynaklanan birtakım sorunlardan ötürü yanıt alamaması durumu söz konusu olabilir. Emir giriş, değiştirme, iptal istekleri ile emir durum sorgusu için rastlanabilecek olan bu olay, ExAPI PC’lerindeki tüm mesaj ekranlarına “Ana Makina isteğinize cevap vermiyor.” şeklinde bir mesaj gelmesiyle belirir. Bu durumu daha iyi açıklamak gerekirse, emir giriş, değiştirme, iptal istekleri için arka planda, ExAPI PC’si ile sistem arasında bazı sorgular (pay durum, emir durum sorguları) yapılmakta, bu sorgulara karşılık alınan cevaplar ile üye sisteminden gelen istek mesajındaki bilgiler birleştirilerek, ilgili istek (yeni emir giriş, emir iptal, emir değiştirme, vs.) ana sisteme iletilmektedir. Bir başka ifadeyle, Üye Sisteminden ExAPI PC’sine senkron kanaldan gelen her istek mesajı için ExAPI PC’si ile sistem arasında en az bir kere de ilave bir sorgu mesajlaşması olmaktadır. Bu mekanizma şu şekilde çalışmaktadır. Cevabının mutlaka alınması gerekli olan sorgular için sorgunun ilk gönderildiği andan itibaren oniki (12) saniyelik bir bekleme süresi vardır. Bu sürenin ilk üç saniyesi içinde yanıt alınamazsa sorgu mesajı sisteme üçer (3’er) saniye aralıklarla üç (3) kere daha gönderilmektedir. Toplam olarak bu dört (4) gönderme denemesinin ardından hiçbir yanıt alınamamışsa oniki (12) saniye sonunda “Ana makina isteğinize cevap vermiyor.” şeklinde bir uyarı verilerek kullanıcılar uyarılmaktdır. ExAPI PC yazılımı hata mesajını üye sistemine senkron kanaldan gönderecektir. Aşağıda mesajın görünümü verilmiştir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı mesajlaşma durumu. (sistem cevap vermiyor anlamında)AÇIKLAMA (**) 198 karakter E “Ana Makina isteğinize cevap vermiyor.” Ifadesini içerir.

(**) : Bu alandaki hata ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Mesaj Örneği

H Ana Makina isteğinize cevap vermiyor.0--------1---------2---------3---------4---------5---------6---------7---------8

Yukarıda bahsedilen durum ile tüm istek mesajları (emir giriş, düzeltme, iptal) ve sorgu mesajları (emir durum) için karşılaşmak olasıdır. Üye sisteminde çalışacak programların senkron kanaldan gelebilecek olan bu mesajı dikkate alması gerekmektedir. İstek mesajlarına karşılık bu içerikte bir mesaj alınması durumunda yapılmakta olan son isteğin yenilenmesi gereklidir.

5.2 İnteraktif Bağlantının KopmasıBorsa İstanbul ExAPI PC’nin sisteme gönderdiği istek mesajları için kullandığı interaktif kanalın, iletişim kademelerinden kaynaklanan bir sorundan dolayı kapanması durumunda, PC, “Interactive connection lost” şeklinde bir mesaj vererek “login” ekranına dönmekdedir. Bu mesajın alınması için, ilgili istek mesajının (emir giriş, değiştirme, iptal gibi sorgu amacı olmayan iş mesajları) sisteme ilk defa gönderilmesinden itibaren 45 sn’lik bir sürenin geçmesi (ilk gönderim süresi + tekrar mesajlarının süresi) gerekmekdedir. Bu süre zarfında ExAPI PC’lerinde çalışan iletişim yazılımı, önceden belirlenmiş parametrik değerleri dikkate alarak, belli aralıklarla ve belli sayıda olmak üzere, sisteme ilgili istek mesajını tekrar tekrar göndermeye çalışır. Buradaki çalışma mekanizması şu şekildedir. PC’den sisteme gönderilen istek mesajına karşılık yanıt alınamaması durumunda PC, sekiz (8) kere daha sisteme ilgili mesajı göndermeye çalışır. Bunun için onay cevabını bekler. Beklenen onay beş (5) saniye kadar süre içinde gelmez ise sekiz deneme sayısına ulaşana kadar ilgili isteği gönderme işini tekrarlar. Kırk (40) saniyelik sürenin dolması durumunda ise yukarıdaki hata mesajı ile “login” ekranına dönülür. Bu PC uygulamasının kapatılıp sisteme tekrar login olunması ve üye sistemi ile senkron ve asenkron API bağlantısının yeniden kurulması gerekmektedir.

Mesajın yola çıkamaması durumunda ise üç(3) kere sisteme göndermeye çalışılır. İletişim yazılımının alacağı hata mesajına bağlı olarak da winnrs.ini içinde yazılan yollardan bir sonraki yol kullanılarak sisteme mesaj gönderilmeye çalışılır. Fakat uzaktan erişim PC’lerinde bir sonraki yolun kullanılmasına izin verilmemektedir.

Yukarıda anlatılan durumda, ExAPI PC’sinin ana sistemle bağlantısının kapandığına dair bir hata mesajı asenkron kanaldan üye sistemine üye sistemine iletilecektir.

Üye sistemine asenkron kanaldan gönderilecek olan mesaj görünümü aşağıda verilmiştir.

Alan Adı Alan Türü Zor. AçıklamaİŞLEM KODU 1 karakter E H: Hatalı mesajlaşma durumu. (sistem iş isteğine cevap vermiyor

anlamında)AÇIKLAMA (**) 198 karakter E “İMKB sistemiyle karşılıklı bağlantı kesildi.” ifadesini içerir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 80

Page 82: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

(**) : Bu alandaki hata ifadesinin bitiminden sonraki kısımlarda mesajı 200 karaktere tamamlamak amacıyla boşluk karakterleri yer almaktadır.

Mesaj Örneği

H İMKB sistemiyle karşılıklı bağlantı kesildi.0--------1---------2---------3---------4---------5---------6---------7---------8

Kullanıcılar bu durumla emir gönderme gibi kritik bir aşamada karşılaşmışlarsa, bağlantılarını tekrar kurduktan sonra ilgili emiri aynı “kurum içi sıra numarası” ile sisteme yeniden göndermeyi deneyeceklerdir. Eğer bir önceki aşamada emir sisteme ulaşabildiyse, “R 06530712010603 14:57:52 1202200200005834 Emir Onceden Sisteme Girilmis. KISN : 10120559, OEN : 1202200200005833” şeklinde bir hata cevabını alacaklardır.

5.3 Mesaj Dosyasının BozulmasıBorsa İstanbul Ex-PC’sinden üye sistemine gönderilen tüm mesajlar PC üzerindeki bir log dosyasında tutulmaktadır. Bu dosya c:\isectdr\logs dizini altında trdr????.dat (örn. trdr0150.dat) adıyla yer almaktadır. Sabit diskte çıkabilecek sorunlar neticesinde sık olmamakla beraber bu dosyanın bozulması mümkündür. Bu durumda PC’ye gelen mesajlar dosyaya yazılamaz ve okunamaz. Log dosyanının okunamaması durumunda temsilcilerin “Tüm Mesaj Ekranları”nda sorunlar yaşanabilir ve “Pozisyon Özeti” gibi log dosyası üzerinde çalışan sorgular hatalı çalışabilir. Bu durumda uygulamadan çıkılarak (“Sistem Çıkış” tuşuyla) ilgili dizindeki dosyanın tamamen silinmesi gerekir. Log dosyası silinen PC’lerde tekrar sisteme login olunduğunda, bu dosya İşlem Sistemi’ne gönderilen istek mesajı doğrultusunda yeniden oluşturulacaktır.

ExAPI uygulaması çalışmakta iken mesaj dosyasının bozulması durumunda Üye sistemine gönderilmesi gereken mesajlarda bir kesinti olmayacaktır. Çünkü hazırlanan mesaj, log dosyasına yazılma işleminden önce Üye sistemine yönlendirilmektedir. Ancak ExAPI uygulaması başlatıldıktan sonra Üye sisteminden gönderilen Biriken Mesajları Üye Sistemine İndirme Mesajı (3.2.2.1) ile istekte bulunulduğunda, ExAPI PC’de yer alan log dosyasının okunamaması ya da hatalı okunması durumunda senkron ve asenkron kanallardan gelen mesajlarda sorunlar yaşanabilir. Bu durumda yukarıda anlatılan log dosyasının silinmesi işlemi yapıldıktan sonra Borsa İstanbul ExAPI Başlatma işlemleri takip edilmelidir.

ExAPI PC’lerinde üye sisteminden alınan ve üye sistemine gönderilen mesajların yazıldığı dialog ekranındaki listeleme alanına yazılabilecek mesaj sayısı sınırlıdır. Sistem kaynaklarına ve yazılan mesajların boyuna bağlı olmakla beraber bu liste bir seansta üretilen tüm mesajları alabilecek boyuttadır. Mesajlar bu ekrana yazılamamaya başladığında ExAPI ekranına “Liste sınırı aşıldı! Bundan sonra listeleme yapılmaksızın mesajlaşma devam edecektir.” ifadesini içeren bir uyarı gelir. Bu aşamadan sonra, ExAPI PC’lerine gelen tüm mesajlar (üye sisteminden ya da İşlem Sistemi’nden) bu listeye yazılmaz ancak mesajlaşma devam eder.

5.4 Genel Yayın Mesajının KaybolmasıUzaktan erişim terminallerinden ya da uzaktan erişim altyapısından kaynaklanan sorunlar nedeniyle zaman zaman genel yayın kanalının (broadcast/multicast kanal) kurulamaması, genel yayın mesajı trafiğinin kesilmesi ya da bazı mesajların kaybolması sözkonusu olabilmektedir. Kesinti sonrasında ExAPI terminali belirli aralıklarla bu kanalı tekrar açmayı denemekte, sorun çözümlendiğinde genel yayın mesajlarını işlemeye devam etmektedir. Buradaki çalışma şu şekildedir. Kanalın mesaj alamaması nedeniyle bekleme (idle) durumuna geçmesinden yüz (100) saniye sonra bu kanal kapatılır. Uygulama kullanıcıyı "Genel yayın mesajı kayboldu. Lütfen Kontrole haber veriniz." şeklinde uyarır. Yirmi (20) saniyelik bir beklemenin ardından kanal tekrar açılır. Broadcast/multicast kanaldaki bu çalışmalar interactive kanaldaki mesajlaşmayı etkilemez. PC interaktif kanaldan emir göndermeye ve onay mesajlarını almaya devam eder. Ancak sorun anında piyasa açılış/kapanış veya pay durum bilgilerindeki değişikliği içeren genel yayın mesajlarının kaçırılması durumunda bu mesajların ana sistemden tekrar indirilebilmesi için mesaj dosyasının silinmesi ve PC’nin mesajları ana sistemden tekrar indirmeye yönlendirilmesi gerekebilmektedir. Bunun dışındaki durumlarda kaybolan genel yayın mesajları (örneğin piyasa izleme ekranındaki fiyat güncellemeleri vb.) zaten üye sistemine gönderilmediğinden işleyişe herhangi bir etkisi olmamaktadır. Dolayısı ile normal işleyiş içerisinde alınabilecek genel yayın mesajlarının kesildiği bilgisi, ExAPI üzerinden interaktif çalışmayı engellememektedir.

Uzaktan erişim PC’lerindeki “log” dosyalarını silinmesi ancak bu şekilde piyasa veya pay açılış ya da kapanışlarıyla ilgili kritik mesajların alınamaması durumunda yapılmalıdır. “Log” dosyalarının seans başlamadan önce silinip piyasa açılış mesajlarının beklenmesi, bu mesajların PC’lere sağlıklı bir şekilde ulaşmasını sağlamaz. Aksine, log dosyalarının bu şekilde silinmesi, kullanıcıların yoğun anlarda sisteme giriş sürelerini uzattığından ve ana sisteme ilave sorgu yükü getirdiğinden tavsiye edilmemektedir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 81

Page 83: İMKB ExAPI İletişim Yöntemleri ve Veri Formatları · Web view3.1.5 nolu Yeni Kotasyon Girişi başlığına otomatik kotasyon atama sürecinde atanan kotasyonlarla ilgili gönderilecek

ÜYEYE ÖZEL GİZLİ BİLGİDİR.

İlgili seans saatlerinin gelmesiyle birlikte sistem tarafından üretilen ve “piyasa açıldı” bilgisini içeren multicast paket uzaktan erişim noktalarına herhangi bir sorundan dolayı gelmese bile, ExAPI PC'lerine üye sisteminden bir emir ulaşırsa, PC'ler bu emir için PC ile ana sistem arasında arka planda yapılan pay sorgu mesajlaşmasında piyasaların durum bilgisini de almaktadır. Bu şekilde, ilgili PC kendi durumunu güncelleyip üye sisteminden gelen emiri reddetmeyecek ve ana sisteme yönlendirecektir. Ancak, bu mekanizmanın sorunsuz çalışabilemesi için üye sistemindeki yazılımın pazar açılışıyla ilgili haber mesajı gelmese bile emir göndermeyi sağlayacak şekilde hazırlanmış olması gerekmektedir.

Sürüm 3.2.116/05/23

İMKB ExAPI İletişim Yöntemleri ve Veri Formatları – Gizli Bilgi 82