Memulai¶

Open API cTrader adalah layanan yang dapat Anda gunakan untuk mengembangkan aplikasi kustom yang terhubung ke backend cTrader. Dokumentasi ini menyediakan semua yang perlu Anda ketahui termasuk informasi tentang SDK, tutorial terstruktur, cuplikan kode, dan banyak lagi.

Apa itu Open API? ¶

Open API cTrader adalah layanan yang memungkinkan siapa pun dengan cTrader ID (cTID) untuk membuat aplikasi yang mengirim dan menerima informasi ke dan dari backend cTrader. Anda dapat menggunakan API ini untuk mengembangkan aplikasi atau layanan yang berorientasi pada trading atau mengintegrasikan backend cTrader dengan solusi yang sudah ada yang mungkin Anda miliki.

Menggunakan API ini melibatkan pengiriman dan penerimaan pesan ke dan dari backend cTrader. Ini dilakukan dengan mengirim dan menerima objek JSON atau Google Protocol Buffers (Protobufs). Kedua cara serialisasi dan deserialisasi data ini bersifat netral bahasa, artinya Anda dapat menggunakan bahasa pemrograman apa pun yang Anda inginkan untuk berinteraksi dengan API.

Nama pesan

Ketika dokumentasi ini merujuk pada pesan tertentu (misalnya, ProtoOAApplicationAuthReq), ia menggunakan notasi Protobuf dengan ProtoOA... di awal nama pesan.

Open API cTrader tersedia untuk siapa pun yang terdaftar dengan broker yang berafiliasi dengan cTrader.

Kasus penggunaan

Berikut adalah beberapa aplikasi yang mungkin Anda buat saat berinteraksi dengan Open API cTrader:

Aplikasi trading kustom yang mengarahkan pengguna baru untuk membuat akun baru dengan broker tertentu.
Bot Telegram yang secara otomatis memberi tahu pengikut Anda tentang perdagangan baru yang mungkin Anda lakukan.
Aplikasi untuk wearable yang menampilkan P&L saat ini dari lima posisi terbaru yang dibuka oleh pengguna.
Aplikasi mobile yang memberikan gambaran pasar dengan menggunakan layanan AI generatif.

Seperti yang Anda lihat, Open API cTrader sangat cocok untuk trader profesional yang ingin terlibat secara sosial dan berinteraksi dengan pengikut mereka.

Fungsionalitas penting ¶

Berikut adalah daftar tidak lengkap tentang apa yang memungkinkan Open API cTrader untuk dilakukan oleh kode Anda:

Mengakses data pasar secara real-time.
Melakukan semua jenis operasi trading yang diizinkan dalam aplikasi cTrader resmi.
Mengambil dan memproses informasi tentang operasi masa lalu, saat ini, dan yang tertunda (termasuk deal, order, dan posisi).

Seperti yang ditunjukkan dalam Syarat Penggunaan kami, API dapat diakses oleh siapa pun dengan cTID, dan, secara default, didukung oleh semua akun trading dari broker yang berafiliasi dengan cTrader.

Pembatasan tingkat

Perhatikan bahwa ada beberapa batasan tentang seberapa sering Anda dapat melakukan permintaan tertentu ke backend cTrader.

Anda dapat melakukan maksimum 50 permintaan per detik per koneksi untuk permintaan data non-historis apa pun.
Anda dapat melakukan maksimum 5 permintaan per detik per koneksi untuk permintaan data historis apa pun.

Demo dan trading riil ¶

Anda dapat menggunakan Open API cTrader untuk trading atas nama akun demo dan riil.

Kami merekomendasikan penggunaan akun demo untuk pengembangan dan pengujian, dan kemudian beralih ke akun riil setelah memastikan bahwa integrasi Anda dengan cTrader Open API berfungsi sebagaimana mestinya. Namun, tidak ada batasan yang ketat, dan Anda dapat dengan bebas memilih untuk memulai pengembangan dan pengujian di bawah akun riil.

SDKs ¶

Saat mengintegrasikan dengan Open API, Anda dapat menggunakan JSON atau Protobufs untuk serialisasi dan deserialisasi data.

Anda dapat menggunakan bahasa apa pun untuk mengimplementasikan cTrader Open API. Namun, jika Anda berniat menggunakan Protobufs, kami sangat merekomendasikan penggunaan bahasa yang memiliki dukungan SDK resmi dari Spotware. Hingga saat ini, bahasa-bahasa tersebut adalah sebagai berikut.

Setiap SDK resmi yang tercantum di atas berisi metode dan kelas pembantu yang membuat implementasi cTrader Open API semudah mungkin.

Jika Anda berniat menggunakan JSON, tidak perlu menggunakan SDK kami karena penanganan serialisasi dan deserialisasi dalam kasus ini relatif sederhana.