Untuk bermula¶

cTrader Open API adalah perkhidmatan yang boleh anda gunakan untuk membangunkan aplikasi tersuai yang disambungkan ke sistem bahagian belakang cTrader. Dokumentasi ini menyediakan semua yang anda perlu ketahui termasuk maklumat tentang SDK, tutorial berstruktur, coretan kod dan banyak lagi.

Apakah Open API? ¶

cTrader Open API adalah perkhidmatan yang membolehkan sesiapa sahaja yang mempunyai cTrader ID (cTID) untuk mencipta aplikasi yang menghantar dan menerima maklumat ke dan dari sistem bahagian belakang cTrader. Anda boleh menggunakan API ini untuk membangunkan aplikasi atau perkhidmatan berorientasikan dagangan atau mengintegrasikan sistem bahagian belakang cTrader dengan sebarang penyelesaian sedia ada yang anda mungkin ada.

Menggunakan API ini melibatkan penghantaran dan penerimaan mesej ke dan dari sistem bahagian belakang cTrader. Ini dilakukan dengan menghantar dan menerima sama ada objek JSON atau Google Protocol Buffers (Protobufs). Kedua-dua cara serialisasi dan deserialisasi data ini adalah neutral bahasa, bermakna anda boleh menggunakan sebarang bahasa pengaturcaraan yang anda mahukan untuk berinteraksi dengan API.

Nama mesej

Apabila dokumentasi ini merujuk kepada mesej tertentu (contohnya, ProtoOAApplicationAuthReq), ia menggunakan notasi Protobuf dengan ProtoOA... pada permulaan nama mesej.

cTrader Open API tersedia untuk sesiapa sahaja yang berdaftar dengan broker yang berkaitan dengan cTrader.

Kes penggunaan

Berikut adalah beberapa aplikasi yang mungkin anda cipta apabila berinteraksi dengan cTrader Open API:

Aplikasi dagangan tersuai yang mengarahkan pengguna baharu untuk membuat akaun baharu dengan broker tertentu.
Bot Telegram yang secara automatik memaklumkan pengikut anda tentang sebarang dagangan baharu yang mungkin telah anda lakukan.
Aplikasi untuk peranti boleh pakai yang memaparkan P&L semasa bagi lima posisi terbaharu yang dibuka oleh pengguna.
Aplikasi mudah alih yang memberikan gambaran pasaran dengan menggunakan perkhidmatan AI generatif.

Seperti yang anda lihat, cTrader Open API adalah sempurna untuk pedagang profesional yang ingin terlibat secara sosial dan berinteraksi dengan pengikut mereka.

Fungsi penting ¶

Berikut adalah senarai tidak lengkap tentang apa yang cTrader Open API membolehkan kod anda lakukan:

Akses data pasaran secara masa nyata.
Melakukan semua jenis operasi dagangan yang dibenarkan dalam aplikasi rasmi cTrader.
Mengambil dan memproses maklumat tentang operasi lepas, semasa dan tertangguh (termasuk urus niaga, pesanan dan posisi).

Seperti yang ditunjukkan dalam Terma penggunaan kami, API boleh diakses oleh sesiapa sahaja yang mempunyai cTID, dan, secara lalai, ia disokong oleh semua akaun dagangan mana-mana broker yang berkaitan dengan cTrader.

Had kadar

Perhatikan bahawa terdapat beberapa had tentang seberapa kerap anda boleh melakukan permintaan tertentu ke sistem bahagian belakang cTrader.

Anda boleh melakukan maksimum 50 permintaan sesaat setiap sambungan untuk sebarang permintaan data bukan sejarah.
Anda boleh melakukan maksimum 5 permintaan sesaat setiap sambungan untuk sebarang permintaan data sejarah.

Dagangan demo dan langsung ¶

Anda boleh menggunakan cTrader Open API untuk berdagang bagi pihak kedua-dua akaun demo dan langsung.

Kami mengesyorkan penggunaan akaun demo untuk pembangunan dan pengujian, dan kemudian beralih ke akaun langsung setelah memastikan bahawa integrasi anda dengan cTrader Open API berfungsi seperti yang diharapkan. Walau bagaimanapun, tiada sekatan keras, dan anda boleh memilih untuk memulakan pembangunan dan pengujian di bawah akaun langsung secara bebas.

SDKs ¶

Apabila berintegrasi dengan Open API, anda boleh menggunakan sama ada JSON atau Protobufs untuk data penyirian dan penyahserian.

Anda boleh menggunakan sebarang bahasa untuk melaksanakan cTrader Open API. Walau bagaimanapun, jika anda berniat untuk menggunakan Protobufs, kami sangat mengesyorkan penggunaan bahasa yang mempunyai sokongan SDK rasmi dari Spotware. Sehingga kini, bahasa-bahasa tersebut adalah seperti berikut.

Setiap SDK rasmi yang disenaraikan di atas mengandungi kaedah dan kelas bantuan yang menjadikan pelaksanaan cTrader Open API semudah mungkin.

Jika anda berniat untuk menggunakan JSON, tidak perlu menggunakan SDK kami kerana mengendalikan penyirian dan penyahserian dalam kes ini agak mudah.