Lewati ke isi

Cara menggunakan referensi dan panduan cTrader Algo

cTrader dilengkapi dengan serangkaian materi pelengkap termasuk dokumentasi lengkap (yang sebagian sedang Anda baca saat ini) dan video edukasi. Dalam artikel ini, kami menjelaskan bagaimana Anda dapat menggunakan kumpulan informasi berharga ini secara efektif. API algo memiliki banyak anggota, dan mengetahui cara mendapatkan informasi dengan cepat tentang apa yang Anda butuhkan sangatlah penting.

Pembaruan dokumentasi

Dokumentasi diperbarui secara teratur agar sesuai dengan rilis cTrader terbaru. Dalam beberapa kasus, Anda mungkin melihat dokumentasi yang membahas peningkatan API yang belum dapat Anda akses di cTrader. Anda dapat menganggap kasus seperti itu sebagai cuplikan dari apa yang akan datang di versi cTrader mendatang.

Mengakses dokumentasi dan panduan

Anda dapat dengan mudah menemukan materi edukasi langsung di cTrader Windows. Untuk melakukannya, buka aplikasi Algo dan pilih algoritma apa pun. Di kolom sebelah kanan jendela editor kode, Anda seharusnya melihat dokumentasi API yang sepenuhnya terintegrasi di dalam platform.

Image title

Bahkan, ada kemungkinan besar Anda mungkin sedang membaca artikel ini saat berada di dalam cTrader.

Atau, Anda dapat mengunjungi Pusat Bantuan cTrader dan membuka bagian yang membahas trading algo. Di dalamnya, Anda akan melihat antarmuka dan struktur yang sama seperti yang Anda lihat di cTrader Windows biasa. Terakhir tapi tidak kalah penting, Anda dapat mengunjungi saluran YouTube kami di mana Anda dapat menonton panduan video yang membahas algoritma cTrader. Perhatikan bahwa semua panduan ini juga tersedia sebagai video yang disematkan di Pusat Bantuan dan dalam dokumentasi API terintegrasi.

Dokumentasi ini berisi beberapa bagian penting.

Dasar-dasar C# dan .NET. Pengantar singkat tentang prinsip-prinsip utama C# dan .NET ini sangat cocok bagi siapa pun yang ingin memulai membuat algoritma kustom.

cBot dan Indikator. Panduan ini membahas proses pembuatan cBot dan indikator dari awal dan menyediakan beberapa cuplikan kode yang dapat Anda gunakan kembali secara bebas saat membuat algo Anda sendiri.

Fitur API. Dokumentasi di bagian ini menjelaskan secara rinci bagaimana Anda dapat bekerja dengan beberapa fitur utama Algo API, terutama akses jaringan dan penyimpanan lokal. Panduan Operasi cBot lanjutan dan Operasi indikator lanjutan berisi cuplikan kode untuk jenis algo cTrader yang kompleks seperti indikator bersarang.

Referensi. Referensi API berisi deskripsi setiap anggota API, yang berarti Anda dapat membaca informasi tentang apa yang dapat Anda dapatkan atau atur melalui properti tertentu, nilai-nilai yang mungkin dari berbagai enum, dan apa yang dikembalikan oleh metode tertentu. Informasi yang sama disediakan di jendela editor kode ketika Anda mengarahkan kursor ke anggota API tertentu.

Gunakan cuplikan kode

Cuplikan kode yang ekstensif adalah salah satu fitur utama dari dokumentasi ini. Terlepas dari jenis algoritma yang ingin Anda buat, ada kemungkinan besar bahwa dokumentasi ini berisi kode yang dapat Anda gunakan kembali secara bebas. Untuk mendemonstrasikan hal ini, kita dapat membuat cBot sederhana yang hampir sepenuhnya berjalan dengan kode yang diambil dari dokumentasi dengan beberapa modifikasi kecil.

Untuk melakukannya, pertama-tama kita akan membuat cBot baru. Ini dilakukan dengan mengeklik tombol New cBot atau, jika Anda tidak dapat melihatnya, buka menu dropdown di bagian atas daftar algoritma dan pilih opsi yang sama.

Image title

Kita akan membuat cBot sederhana yang melakukan trading beberapa simbol. Kita ingin melakukan trading berita, jadi masuk akal untuk memiliki algoritma yang melakukan trading semua simbol yang terkait dengan berita tersebut.

Untuk melakukannya, kita akan membuka dokumentasi Algo API terintegrasi dan mengetikkan "multiple symbols" ke dalam kotak pencariannya. Seperti yang ditunjukkan oleh hasil pencarian, ada sub-bagian yang membahas trading simbol lain dalam panduan Operasi lanjutan dengan cBot. Jika kita mengeklik hasil spesifik ini, kita akan langsung dibawa ke cuplikan kode yang relevan serta beberapa informasi tambahan. Kita dapat langsung menyalin dan menempelkan cuplikan tersebut ke dalam cBot kita.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
  [Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbol = Symbols.GetSymbol("GBPUSD");

        if (symbol is not null)
        {
            _ = ExecuteMarketOrder(TradeType.Sell, symbol.Name, symbol.VolumeInUnitsMin);
        }
    }
  }

Informasi di atas cuplikan kode memberi tahu kita bahwa kita dapat menggunakan koleksi Symbols untuk menemukan simbol yang kita inginkan. Misalkan Departemen Keuangan AS sedang menyampaikan pidato lain tentang siklus suku bunga dan kita ingin membuka posisi jual pada awal untuk beberapa indeks berbasis AS (tetapi bukan untuk simbol yang terhubung dengan cBot kita).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[Robot()]
  public class Sample_cBot : Robot
  {
    protected override void OnStart()
    {
        var symbolOne = Symbols.GetSymbol("US 500");

        var symbolTwo = Symbols.GetSymbol("US 30");

        var symbolThree = Symbols.GetSymbol("US TECH 100");

        if (symbolOne is not null && symbolTwo is not null && symbolThree is not null)
        {
            ExecuteMarketOrder(TradeType.Sell, symbolOne.Name, symbolOne.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolTwo.Name, symbolTwo.VolumeInUnitsMin);
            ExecuteMarketOrder(TradeType.Sell, symbolThree.Name, symbolThree.VolumeInUnitsMin);
        }
    }
  }

Pada awal, cBot kita akan mengeksekusi operasi yang diperlukan. Merujuk pada dokumentasi API telah memungkinkan kita untuk menghemat banyak waktu dengan menggunakan kembali kode yang ada dan hanya sedikit memodifikasinya agar sesuai dengan kebutuhan kita.

Ringkasan

cTrader memungkinkan Anda untuk mengakses dokumentasi API di beberapa tempat berbeda, terutama di dalam platform itu sendiri. Ini adalah cara yang sangat nyaman untuk memberdayakan algo Anda karena Anda dapat dengan mudah menggunakan kembali cuplikan kode dari dokumentasi setelah memperkenalkan modifikasi yang diperlukan. Kami juga sangat menyarankan Anda untuk berlangganan saluran YouTube kami agar Anda selalu diperbarui setiap kali kami merilis video edukasi baru.