Model komunikasi¶

Pengantar ¶

FIX API menggunakan komunikasi berbasis sesi. Sesi didefinisikan sebagai komunikasi antara dua pihak: inisiator (klien), pihak yang memulai komunikasi, dan akseptor (server), pihak yang menerima permintaan koneksi dari inisiator.

Server memvalidasi permintaan klien menggunakan pesan Logon.

Protokol sesi FIX ¶

Setiap sesi mempertahankan pesan dua arah antara klien dan server cTrader. Sesi dapat mencakup beberapa koneksi fisik dan dipertahankan menggunakan nomor urut.

Setiap pesan baru dalam satu sesi menerima nomor urut unik dimulai dari 1 (satu). Kedua pihak bergantung pada nomor urut untuk mempertahankan komunikasi yang teratur. Pesan yang hilang dikirim ulang dengan kesepakatan bilateral antara kedua pihak.

Alur sesi tipikal:

1. Klien memulai sesi dengan pesan Logon.
2. Klien bertukar pesan aplikasi dengan server.
3. Sesi berakhir dengan pesan Logout.

Kategori pesan protokol FIX cTrader ¶

Sebagaimana didefinisikan dalam Protokol FIX, server FIX cTrader menggunakan 2 level data yang berbeda: sistem dan aplikasi.

Harap dicatat bahwa ini adalah set minimum pesan yang diperlukan untuk mendukung alur kerja yang diperlukan dan dapat berubah seiring waktu seiring dengan perkembangan kebutuhan bisnis dan standar FIX.

Pesan sistem (admin) ¶

• Heartbeat (klien ↔ cTrader) – digunakan untuk memeriksa tautan komunikasi antara dua pihak.
• Test request (klien ↔ cTrader) – digunakan untuk menguji kesehatan tautan komunikasi.
• Logon (klien → cTrader) – pesan autentikasi klien.
• Logon (klien → cTrader) – penghentian normal sesi.
• Resend request (klien ↔ cTrader) – permintaan untuk mengirim ulang pesan aplikasi tertentu.
• Reject (klien ↔ cTrader) – kegagalan validasi tingkat sesi.
• Sequence reset (klien ↔ cTrader) – dalam kasus masalah komunikasi, pesan yang hilang dipulihkan atau urutan diatur ulang untuk mengabaikan pesan yang hilang.

Pesan aplikasi ¶

• Market data request (klien → cTrader) – permintaan umum untuk data pasar.
• Market data incremental refresh (klien ← cTrader) – respons terhadap pesan permintaan data pasar.
• New order single (klien → cTrader) – digunakan untuk mengirimkan order secara elektronik ke broker untuk dieksekusi.
• Execution report (klien ← cTrader) – digunakan untuk mengirim informasi status order ke klien FIX, seperti konfirmasi, pengisian, dan perubahan yang tidak diminta.
• Business message reject (klien ← cTrader) – digunakan untuk menolak permintaan klien FIX karena alasan non-sesi.

Struktur pesan FIX ¶

Bagian ini menjelaskan bagaimana pesan FIX API disusun, menjelaskan format pesan FIX, dan membantu pengguna memahami konsep pasangan tag dan nilai.

Setiap pesan harus berisi 3 bagian:

• Header – setiap pesan administratif atau aplikasi didahului oleh header standar. Header mengidentifikasi jenis pesan, versi FIX, panjang pesan, tujuan, nomor urut, asal, dan waktu.
• Body – konten dalam body pesan ditentukan oleh jenis pesan yang didefinisikan dalam header.
• Footer – setiap pesan, administratif atau aplikasi diakhiri dengan footer standar. Footer digunakan untuk memisahkan pesan dan berisi representasi karakter tiga digit dari nilai CheckSum <10>.

Format pesan FIX ¶

Pesan FIX adalah kumpulan field. Setiap field adalah pasangan tag-nilai yang diformat sebagai {tag}={value}. Misalnya, 54=2, yang berarti jenis order adalah jual.

Tag ¶

• FIX menggunakan tag yang telah ditentukan sebelumnya.
• Setiap tag mewakili field tertentu.
• Setiap tag diberikan nomor yang telah ditentukan sebelumnya.
• Spesifikasi FIX cTrader menyediakan daftar field dan nomor tag yang sesuai.

Nilai ¶

• Nilai mewakili nilai dari tag yang ditetapkan padanya.
• Nilai hanya dapat berupa salah satu dari tipe data berikut: integer, floating point, karakter, waktu, tanggal, data, atau string.

Semua pesan dalam cTrader FIX API dimulai dengan 8=FIX.x.y, di mana x.y adalah versi Protokol FIX. Di akhir setiap pesan harus ada field 10=xyz, di mana xyz mewakili jumlah semua nilai biner dalam pesan yang disebut checksum.

Checksum membantu mengidentifikasi masalah transmisi, khususnya kehilangan paket dengan memungkinkan penerima mengetahui jika ada bagian pesan yang hilang.

Jika tag Symbol(55) digunakan dalam pesan FIX ke cTrader/cServer, Anda harus menentukan ID simbol FIX. Nilai tersebut dapat berbeda antar broker. Anda dapat menemukan field ID Simbol FIX dari aplikasi cTrader broker tersebut di jendela informasi simbol.

Contoh pesan ¶

8=FIX.4.4|9=126|35=A|34=1|49=theBroker.12345|57=TRADE|50=any_string|52=20170117-08:03:04|56=CSERVER|98=0|108=30|553=12345|554=passw0rd!|10=131|