Cara membuat indikator kustom di cTrader

Dalam artikel ini dan video terkaitnya, kami akan membahas bagaimana Anda dapat membuat indikator kustom baru di cTrader. Kami akan membuat indikator moving average sederhana dan menunjukkan kepada Anda cara menyesuaikan parameter indikator dengan cepat.

Sebelum mengikuti instruksi kami, pastikan Anda telah mengunduh dan menginstal aplikasi cTrader Windows atau cTrader Mac dari situs web resmi. Jalankan, dan navigasikan ke bagian cTrader Algo. Cari tab Algo di panel kiri dan klik. Anda sekarang harus melihat antarmuka Algo cTrader.

Menambahkan indikator kustom baru

Untuk membuat indikator kustom baru, kita perlu mengklik tombol Baru dan memilih Kosong. Indikator baru akan muncul di bagian bawah daftar indikator bersama dengan template kode di panel kanan.

Selanjutnya, ubah nama indikator dari nama defaultnya. Untuk melakukannya, klik kanan dan klik Ganti nama, atau pilih dan tekan F2. Kita akan mengetik Simple moving average sebagai nama baru indikator kita. Setelah selesai, tekan Enter. Pada titik ini, kita siap untuk mulai mengkodekan logika dan rumus untuk indikator kustom.

Melihat struktur indikator

Sebelum kita mulai, kita akan melihat sekilas struktur kode indikator yang ditampilkan di jendela editor kode. Struktur ini mencakup pengaturan parameter default dan metode untuk menghitung dan menampilkan indikator pada grafik.

Untuk memulai, setiap indikator memiliki bagian yang berisi atribut kelasnya. Di sinilah Anda dapat mengonfigurasi hak akses yang dimiliki indikator, di mana indikator akan ditampilkan pada grafik, zona waktu yang digunakan oleh indikator, penskalaan indikator dan beberapa pengaturan lanjutan lainnya.

Anda juga akan melihat bahwa setiap template kode indikator baru mendefinisikan kelas bernama NewIndicator yang berisi semua event indikator dan metode kustom apa pun. Deklarasi nama kelas diikuti oleh : Indicator. Ini berarti bahwa kelas NewIndicator mewarisi dari kelas dasar Indicator yang, pada gilirannya, berisi semua objek yang telah ditentukan sebelumnya yang akan kita akses saat membangun indikator kustom kita.

Tinjauan lebih rinci tentang struktur kode indikator dan prinsip pewarisan dalam pemrograman berorientasi objek disediakan dalam dokumentasi teknis kami.

Di bagian di bawah ini, Anda akan melihat blok kode yang berisi semua pengaturan indikator default. Awalnya, bagian ini hanya akan berisi kode berikut.

1
2
3
4
5

[Parameter(DefaultValue = "Hello world!")]
public string Message { get; set; }

[Output("Main")]
public IndicatorDataSeries Result { get; set; }

Tepat di bawah deklarasi parameter, Anda harus melihat metode-metode indikator. Pikirkan metode sebagai peristiwa tertentu yang dijalankan ketika indikator dimulai dan juga ketika data harga baru dimasukkan ke indikator. Tabel berikut mendefinisikan tiga metode indikator utama.

Menulis kode indikator

Kita sekarang akan melanjutkan dengan menambahkan kode kustom ke indikator simple moving average kita. Indikator kita akan ditampilkan pada grafik trading sebagai overlay di atas tipe grafik saat ini.

Pertama, kita harus mendeklarasikan atribut kelas indikator seperti yang dibahas sebelumnya. Kita akan menambahkan pengaturan atribut berikut ke indikator.

1

[Indicator(IsOverlay = true, TimeZone = TimeZones.UTC, AutoRescale = false, AccessRights = AccessRights.None)] 

Anda dapat menafsirkan kode di atas sebagai berikut:

• IsOverlay = true - indikator akan diplot pada grafik di atas lilin, batang Range, batu bata Renko atau elemen lainnya tergantung pada tipe grafik yang dipilih.
• TimeZone = TimeZones.UTC - indikator akan menggunakan Waktu Universal Terkoordinasi yang merupakan nilai default untuk semua indikator. Mengubah nilai atribut ini hanya direkomendasikan jika indikator Anda menggunakan fitur tanggal dan waktu dalam perhitungannya.
• AutoRescale = false - atribut ini mendefinisikan apakah indikator harus secara otomatis mengubah skala grafik yang ditambahkan. Karena nilai atribut ini sama dengan false, indikator kita tidak akan mengubah skala grafik.
• AccessRights = AccessRights.None - indikator tidak akan diizinkan untuk mengakses Internet atau memanipulasi file di mesin lokal.

Kita sekarang dapat mendefinisikan parameter indikator kita. Ini adalah pengaturan yang dapat disesuaikan di panel pengaturan setelah menambahkan indikator ke grafik. Kita akan membuat kode parameter berikut:

• Sumber data untuk rumus indikator.
• Periode yang digunakan dalam rumus.
• Hasil output indikator yang diplot pada garis.

Tambahkan cuplikan berikut ke indikator.

1
2
3
4
5
6
7
8

[Parameter("Source")]
public DataSeries Source { get; set; }

[Parameter("Periods", DefaultValue = 14)]
public int Periods { get; set; }

[Output("Main", LineColor = "Turquoise")]
public IndicatorDataSeries Result { get; set; }

Kita akan menetapkan 14 sebagai nilai default parameter Periods dan turquoise sebagai warna garis default. Namun, Anda dapat menetapkan parameter ini ke hampir semua nilai default yang didukung oleh cTrader.

Sekarang kita dapat menambahkan kode yang akan memplot output indikator pada grafik dengan menggunakan metode peristiwa Calculate().

1
2
3
4
5
6
7
8
9

public override void Calculate(int index)
{
    var sum = 0.0;

    for (var i = index - Periods + 1; i <= index; i++)
    sum += Source[i];

    Result[index] = sum / Periods;
}

Kode ini menetapkan hasil perhitungan indikator ke parameter Result yang telah kita definisikan sebelumnya.

Membangun dan menguji indikator

Segera setelah kita selesai menulis kode indikator kita, kita dapat mengklik tombol Build yang terletak di bilah paling atas UI cTrader. Atau, klik kanan indikator Anda dan pilih Build di menu yang baru dibuka atau tekan Ctrl + B.

Jika build berhasil, Anda akan melihat pesan hijau di area Build result di bagian bawah editor kode.

Namun, jika ada masalah dengan kode Anda, Anda akan melihat pesan merah dan ringkasan rinci dari semua kesalahan build.

Setelah berhasil membangun indikator Anda, kita sekarang dapat melanjutkan dengan membuat instance. Cara termudah untuk melakukannya adalah dengan mengklik kanan indikator dan memilih opsi Add an instance.

Ini akan membuat instance indikator baru untuk grafik h1 untuk EURUSD. Namun, Anda dapat mengubah tipe grafik, rentang waktu, dan simbol dengan mengklik instance dan membuka menu yang relevan.

Tab Parameter yang baru muncul harus menampilkan tiga parameter yang dapat disesuaikan yang telah kita kodekan sebelumnya. Anda dapat membiarkannya apa adanya atau mengubah nilainya langsung di UI cTrader.

Grafik trading sekarang harus menampilkan output indikator. Dalam kasus kita, ini akan menjadi garis berwarna turquoise yang menampilkan simple moving average.

Jika Anda mengklik kanan garis tersebut, Anda akan melihat jendela baru yang memungkinkan untuk menyesuaikan parameter indikator. Misalnya, kita dapat mengubah warna garis output dari turquoise menjadi biru. Kita juga dapat menyesuaikan ketebalan garis. Untuk menyimpan perubahan Anda, klik OK.

Menambahkan indikator ke grafik langsung

Kita sekarang akan beralih ke tab Trade di cTrader untuk menambahkan indikator kustom kita ke grafik langsung. Buka grafik untuk simbol yang ingin Anda analisis.

Di menu di bagian atas, klik ikon Indicators untuk membuka bagian baru.

Setelah itu, pilih Custom dan, di menu yang baru muncul, pilih indikator kustom yang telah kita buat (Simple moving average).

Anda akan melihat jendela baru yang memungkinkan Anda untuk menyesuaikan parameter indikator. Setelah memilih nilai yang Anda sukai, klik OK untuk menambahkan indikator ke grafik untuk simbol yang dipilih.

Untuk kembali ke jendela pengaturan indikator, klik kanan output indikator. Dalam kasus kita, kita dapat mengklik kanan garis berwarna turquoise. Atau, klik ikon Properties yang muncul ketika Anda mengarahkan kursor ke nama indikator pada grafik.

Jendela pengaturan indikator akan muncul, dan Anda akan dapat mengubah warna garis yang diplot serta ketebalannya.