Spesifikasi Pesan Peringatan Bot Sinyal Trading 2.0

Daftar Isi

• Pendahuluan

• Bagian A - bagi Pengguna Strategi Pine Script™

• Bagian B - Kompatibel Secara Universal

• T&J

Pendahuluan

Dengan diluncurkannya Bot Sinyal, pengguna TradingView kini dapat menerbitkan sinyal mereka dan membuat Bot Sinyal di OKX. Dalam panduan ini, kita akan menelusuri berbagai spesifikasi pesan peringatan yang didukung oleh OKX bagi pengguna.

Bagi pengguna yang menguasai Pine Script™ dan mengandalkan skrip strategi secara khusus untuk mengirim sinyal, tersedia format spesifikasi eksklusif yang kami rancang dengan cermat. Format ini mengintegrasikan placeholder strategi Pine Script™ dengan mulus sehingga Anda dapat mengirim sinyal trading dengan sangat mudah. Jika Anda pengguna strategi Pine Script™ asli, format ini cocok bagi Anda karena memberikan pendekatan yang efisien untuk menggabungkan skrip strategi Anda dengan placeholder strategi TradingView. Jika Anda adalah seorang penulis strategi dan menggunakan fungsi strategy.*() untuk membangun sinyal trading, silakan baca Bagian A - bagi Pengguna Strategi Pine Script™ di bawah.

Di sisi lain, kami memahami bahwa tidak semua orang hanya mengandalkan skrip strategi Pine Script™. Dalam B - Kompatibel Secara Universal dari panduan ini, kami memberikan serangkaian spesifikasi serbaguna dengan fungsi yang melampaui metode pembuatan skrip. Spesifikasi ini berfungsi untuk semua pendekatan pembuatan sinyal. Kerangka kerja yang ampuh ini cocok bagi orang yang menggunakan indikator kustom, berbagai teknis charting, atau bahkan peringatan manual.

Ringkasan Singkat Tentang Pine Script™: "Strategi" vs "Indikator"

Strategi Pine Script™ mencapai tujuan melaksanakan backtesting terhadap data historis serta forward testing dalam pasar langsung. Selain melakukan perhitungan indikator, strateginya mencakup panggilan ke fungsi strategy.*() yang mengirim order trading ke emulator broker Pine Script™. Kemudian, emulator ini dapat menyimulasikan eksekusi order tersebut. Hasil backtesting divisualisasikan dalam tab "Penguji Strategi” yang berada di bagian bawah grafik dekat tab "Editor Pine Script™".

Di sisi lain, indikator Pine Script™ juga meliputi perhitungan, tetapi tidak dimaksudkan untuk digunakan dalam skenario backtesting. Karena tidak bergantung pada emulator broker, indikator memakai lebih sedikit sumber daya dan dieksekusi dengan lebih cepat.

Harap diperhatikan bahwa Anda memiliki fleksibilitas untuk memanfaatkan format dalam Bagian A atau Bagian B. Keduanya sama-sama kompatibel. Berdasarkan pesan yang dikirim, sistem akan membedakan format yang digunakan dengan cerdas, lalu menguraikan pesan Anda. Pemrosesan cerdas ini memastikan pengalaman yang lancar terlepas dari pendekatan yang dipilih.

Bagian A (Pengguna Strategi Pine Script™)

Spesifikasi berikut disesuaikan khusus bagi pengguna yang menyusun algoritmanya menggunakan strategi Pine Script™ dan utamanya dengan fungsi strategy.*. Format ini dikhususkan untuk mengakomodasi nilai placeholder strategi tersebut untuk memastikan adaptabilitas yang lancar. Untuk lebih memahami skrip strategi dan proses mengirim peringatan menggunakan variabel placeholder strategi, Anda dapat menemukan informasi tambahan di tautan ini.

Jika konsep ini asing bagi Anda, Bagian B memberikan pendekatan alternatif untuk membangun peringatan Anda yang dapat diterapkan pada berbagai macam skenario.

Ringkasan Spesifikasi Pesan Peringatan

1. Spesifikasi Pesan Peringatan - id

id - Pengenal order

{{strategy.order.id}} - menghasilkan ID dari order yang dieksekusi (string yang digunakan sebagai parameter pertama dalam salah satu panggilan fungsi yang membuat order: strategy.entry, strategy.exit, atau strategy.order).

2. Spesifikasi Pesan Peringatan - action

action - Beli atau Jual?

{{strategy.order.action}} - menghasilkan string "beli" atau "jual" untuk order yang dieksekusi.

3. Spesifikasi Pesan Peringatan - marketPosition

marketPosition - Status posisi yang dimaksudkan (pada saat eksekusi order)

{{strategy.market_position}} - menghasilkan posisi strategi saat ini dalam bentuk string: "beli", "netral", atau "jual".

4. Spesifikasi Pesan Peringatan - prevMarketPosition

prevMarketPosition - Status posisi sebelumnya (sebelum eksekusi order)

{{strategy.prev_market_position}} - menghasilkan posisi strategi sebelumnya dalam bentuk string: "beli", "netral", atau "jual".

5. Spesifikasi Pesan Peringatan - instrument

Format 1: ticker - Nilai placeholder TradingView

'Placeholder standar'* adalah potongan teks literal yang dikelilingi oleh tanda kurung ganda dan disertakan di dalam pesan peringatan.

"{{ticker}}" akan mengembalikan Ticker instrumen yang digunakan untuk membuat peringatan.

Misalnya: "BTCUSDT.P", "ETHUSDT.P".

* Placeholder Standar untuk mengakses variabel dalam Pine Script™. Pelajari selengkapnya di sini.

Format 2: Format Instrumen OKX

ID Instrumen atau "instId" di API OKX. Detail selengkapnya dapat ditemukan di tautan ini

Misalnya: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

6. Spesifikasi Pesan Peringatan - signalToken

signalToken -- Autentikasi untuk Sinyal

Token adalah tindakan keamanan untuk memastikan bahwa permintaan yang masuk sah dan diotorisasi. signalToken akan dibuat secara otomatis ketika pengguna berhasil membuat sinyal baru di platform kami dan sinyal tersebut harus disalin ke Pesan Peringatan TradingView.

Bagaimana cara menemukan signalToken Anda untuk sinyal yang sudah aktif?

1. Baca bagian Detail dari sinyal Anda

2. Temukan signalToken Anda di bagian pesan peringatan yang disarankan

7. Spesifikasi Pesan Peringatan - timestamp

timenow - nilai placeholder TradingView

'Placeholder standar'* adalah potongan teks literal yang dikelilingi oleh tanda kurung ganda dan disertakan di dalam pesan peringatan.

"{{timenow}}" akan menghasilkan waktu tepat saat ini ketika peringatan dibuat dalam waktu UTC dan format yyyy-MM-ddTHH: mm: ssZ.

Misalnya: "2023-06-01T17:38:10Z"

* Placeholder Standar untuk mengakses variabel dalam Pine Script. Pelajari selengkapnya di sini.

8. Spesifikasi Pesan Peringatan - maxLag

maxLag - Keterlambatan Maksimum yang Dapat Diterima

Istilah "maxLag” berkaitan dengan keterlambatan atau latensi maksimum yang dapat diterima sebelum sinyal trading dianggap hangus. Nilai ini dihitung dalam detik. Perhitungan maxLag mencakup penentuan perbedaan waktu antara saat sinyal dikirim dari TradingView (menggunakan bidang "timestamp” dalam pesan peringatan) dan saat sinyal tersebut diterima di OKX untuk tujuan eksekusi order.

Secara default, nilainya diatur menjadi 60 detik. Menetapkan nilai maxLag membantu memastikan bahwa Bot Sinyal beroperasi tepat waktu dengan tidak bertindak berdasarkan sinyal yang sudah usang atau berpotensi tidak akurat yang mungkin tidak lagi menunjukkan kondisi pasar saat ini.

9. Spesifikasi Pesan Peringatan - investmentType & amount

Catatan Penting: Untuk memastikan kompatibilitas yang optimal dengan strategi TradingView Anda, kami sangat menyarankan Anda untuk mengonfigurasi investmentType menjadi "base" dan mengatur amount menjadi "{{strategy.order.contracts}}". Dengan mengikuti pendekatan ini, jumlah order di OKX akan selaras dengan jumlah order lain yang ditentukan dalam strategi TradingView Anda.

investmentType dan Amount

(KHUSUS SINYAL MASUK)

• base: Jumlah dalam mata uang dasar (Pilihan yang disarankan)

• margin: Margin yang diinvestasikan dalam mata uang kutipan

• contract: Kontrak dalam jumlah tetap

• percentage_balance: Berdasarkan % Saldo Tersedia (yaitu., margin yang tersedia untuk membuka order baru)
• percentage_investment: Berdasarkan persentase Investasi Aktif dalam bot Anda. Investasi Aktif biasanya merupakan margin awal yang Anda investasikan pada saat pembuatan bot dan tetap tetap hingga Anda menambahkan lebih banyak margin dan memilih untuk meningkatkan nilai ini. Contohnya, jika Anda membuat bot dengan margin awal 1000 USDT, Investasi Aktif Anda akan diatur menjadi 1000 USDT. Untuk sinyal yang masuk, ini adalah nilai yang akan digunakan untuk perhitungan ukuran pesanan Anda. Misalnya, setelah beberapa hari menjalankan bot Anda, Anda memutuskan bahwa performanya baik dan menginvestasikan kembali margin tambahan sebesar 1000 USDT dan menambahkannya ke Investasi Aktif Anda. Setelah itu, Investasi Aktif Anda akan meningkat menjadi 2000 USDT dan ini adalah nilai baru yang akan digunakan untuk perhitungan ukuran pesanan Anda. Jika Anda tidak yakin dengan nilai Investasi Aktif bot Anda saat ini, Anda selalu dapat memeriksanya di bagian Rincian Bot Anda.

(KHUSUS SINYAL KELUAR)

• base: Jumlah dalam mata uang dasar (Pilihan yang disarankan)
• percentage_position: Berdasarkan % posisi terbuka

Bagian B (Kompatibel Secara Universal)

Spesifikasi yang diberikan di bawah ini bersifat serbaguna dan dapat disesuaikan dengan skenario apa pun. Spesifikasi ini tetap mudah diadaptasi dan dikustomisasi, baik saat Anda memanfaatkan Pine Script™ untuk membuat strategi atau indikator (skrip studi) maupun saat memasukkan peringatan secara manual ke dalam antarmuka pengguna Peringatan TradingView.

Ringkasan Spesifikasi Pesan Peringatan

1. Spesifikasi Pesan Peringatan - action

Mode Posisi:

Bot Sinyal beroperasi dalam mode One-Way (yaitu, Beli/Jual). Bot hanya akan memiliki posisi dalam satu arah untuk instrumen tertentu.

Buka Order

• ENTER_LONG: Buka posisi Beli dengan ekspektasi bahwa harganya akan naik.
• ENTER_SHORT: Buka posisi Jual dengan ekspektasi bahwa harganya akan turun.

Tutup Order

• EXIT_LONG: Tutup posisi Beli sebagian atau sepenuhnya dengan menjual posisi yang dimiliki.
• EXIT_SHORT: Tutup posisi Jual sebagian atau sepenuhnya dengan membeli kembali kontrak.

2. Spesifikasi Pesan Peringatan - instrument

Format 1: ticker - Nilai placeholder TradingView

'Placeholder standar'* adalah potongan teks literal yang dikelilingi oleh tanda kurung ganda dan disertakan di dalam pesan peringatan.

"{{ticker}}" akan mengembalikan Ticker instrumen yang digunakan untuk membuat peringatan.

Misalnya: "BTCUSDT.P", "ETHUSDT.P".

* Placeholder Standar untuk mengakses variabel dalam Pine Script. Pelajari selengkapnya di sini.

Format 2: Format Instrumen OKX

ID Instrumen atau "instId" di API OKX. Detail selengkapnya dapat ditemukan di tautan ini

Misalnya: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

3. Spesifikasi Pesan Peringatan - signalToken

signalToken - Autentikasi untuk Sinyal

Token adalah tindakan keamanan untuk memastikan bahwa permintaan yang masuk sah dan diotorisasi. signalToken akan dibuat secara otomatis ketika pengguna berhasil membuat sinyal baru di platform kami dan sinyal tersebut harus disalin ke Pesan Peringatan TradingView.

4. Spesifikasi Pesan Peringatan - timestamp

timenow - nilai placeholder TradingView

'Placeholder standar'* adalah potongan teks literal yang dikelilingi oleh tanda kurung ganda dan disertakan di dalam pesan peringatan.

"{{timenow}}" akan menghasilkan waktu tepat saat ini ketika peringatan dibuat dalam waktu UTC dan format yyyy-MM-ddTHH: mm: ssZ.

Format yang Dimungkinkan (waktu UTC, format ISO 8061)

• Format yyyy-MM-ddTHH:mm:ssZ Contoh: "2023-06-01T17:38:10Z"
• Format yyyy-MM-ddTHH:mm:ss.SSSZ Contoh: "2023-06-01T17:38:10.836Z"
• Format yyyy-MM-ddTHH:mm:ss+0000 Contoh: "2023-06-01T17:38:10+0000"

Misalnya: "2023-06-01T17:38:10Z"

* Placeholder Standar untuk mengakses variabel dalam Pine Script. Pelajari selengkapnya di sini.

5. Spesifikasi Pesan Peringatan - maxLag

maxLag - Keterlambatan Maksimum yang Dapat Diterima

Istilah "maxLag” berkaitan dengan keterlambatan atau latensi maksimum yang dapat diterima sebelum sinyal trading dianggap hangus. Nilai ini dihitung dalam detik. Perhitungan maxLag mencakup penentuan perbedaan waktu antara saat sinyal dikirim dari TradingView (menggunakan bidang "timestamp” dalam pesan peringatan) dan saat sinyal tersebut diterima di OKX untuk tujuan eksekusi order.

Secara default, nilainya diatur menjadi 60 detik. Menetapkan nilai maxLag membantu memastikan bahwa Bot Sinyal beroperasi tepat waktu dengan tidak bertindak berdasarkan sinyal yang sudah usang atau berpotensi tidak akurat yang mungkin tidak lagi menunjukkan kondisi pasar saat ini.

6. Spesifikasi Pesan Peringatan - order

orderType

• Market: Tempatkan order pasar untuk Membuka (jika action =ENTER_XX) atau Menutup (jika action = EXIT_XX) posisi. Tidak perlu memberikan orderPriceOffset
• Limit: Tempatkan order terbatas untuk Membuka (jika action =ENTER_XX) atau Menutup (jika action = EXIT_XX) posisi.

orderPriceOffset (HANYA berlaku untuk order LIMIT)

• ENTER_LONG: [1-(orderPriceOffset/100)] * Penawaran-1
• ENTER_SHORT: [1+(orderPriceOffset/100)] * Permintaan-1
• EXIT_LONG: [1+(orderPriceOffset/100)] * Permintaan-1
• EXIT_SHORT: [1-(orderPriceOffset/100)] * Penawaran-1

7. Spesifikasi Pesan Peringatan - investmentType & amount

investmentType dan Amount

(KHUSUS SINYAL MASUK)

• Margin: Margin yang diinvestasikan dalam mata uang kutipan

• Contract: Kontrak dalam jumlah tetap

• Percentage_balance: Berdasarkan % Saldo Tersedia (yaitu., margin yang tersedia untuk membuka order baru)

• Percentage_investment: Berdasarkan persentase Investasi Aktif dalam bot Anda. Investasi Aktif biasanya merupakan margin awal yang Anda investasikan pada saat pembuatan bot dan tetap tetap hingga Anda menambahkan lebih banyak margin dan memilih untuk meningkatkan nilai ini. Contohnya, jika Anda membuat bot dengan margin awal 1000 USDT, Investasi Aktif Anda akan diatur menjadi 1000 USDT. Untuk sinyal yang masuk, ini adalah nilai yang akan digunakan untuk perhitungan ukuran pesanan Anda. Misalnya, setelah beberapa hari menjalankan bot Anda, Anda memutuskan bahwa performanya baik dan menginvestasikan kembali margin tambahan sebesar 1000 USDT dan menambahkannya ke Investasi Aktif Anda. Setelah itu, Investasi Aktif Anda akan meningkat menjadi 2000 USDT dan ini adalah nilai baru yang akan digunakan untuk perhitungan ukuran pesanan Anda. Jika Anda tidak yakin dengan nilai Investasi Aktif bot Anda saat ini, Anda selalu dapat memeriksanya di bagian Rincian Bot Anda.

(KHUSUS SINYAL KELUAR)

• Percentage_position: Berdasarkan % posisi terbuka

Bagian B Contoh

Contoh 1: Entri Beli -> Keluar Beli (Tutup Penuh) tanpa Multientri

Contoh 2: Entri Beli -> Entri Jual (Pembalikan Satu Langkah) tanpa Multientri

Contoh 3: Entri Beli -> Keluar Beli (Sebagian) -> Keluar Beli (Tutup Penuh)

Contoh 4: Menggunakan Multientri

Multientri adalah fitur dalam Bot Sinyal yang memungkinkan eksekusi beberapa titik entri untuk instrumen tertentu. Trader dapat mengoptimalkan pendekatan trading mereka dengan mendiversifikasi titik entri (dengan kata lain, melakukan DCA), sehingga berpotensi meningkatkan peluang mendapatkan trading yang menguntungkan dalam lingkungan pasar yang dinamis.

Contoh 5: Hanya Menggunakan Sinyal Pemicu (Tanpa Bidang Terkait Order)

Penyedia sinyal dapat mengecualikan parameter opsional tertentu mengingat pengguna telah mengonfigurasinya dalam bot. Hal ini tentunya sangat berguna bagi penyedia yang berfokus HANYA dalam menawarkan sinyal pemicu Beli/Jual. Setiap pelanggan bebas memutuskan jumlah yang akan diinvestasikan.

Contoh 6: Hanya Menggunakan Sinyal Pemicu (Tanpa Bidang Terkait Order)

Jika konfigurasi sinyal dan bot tidak menentukan detail order, maka nilai default akan digunakan.

• Sinyal ENTER akan membuka X%* dari investasi secara default menggunakan order pasar.
• Sinyal EXIT akan menutup 100% posisi terbuka secara default saat menerima sinyal.

*** X = 100 untuk Pair Tunggal. X = 50 untuk Multi-Pair

Contoh 7: Prioritas Urutan Bidang

Parameter Bot lebih diprioritaskan daripada Parameter Sinyal. Terdapat dua aturan yang perlu diperhatikan:

1. Aturan 1: Bot dan Sinyal menentukan bidang

2. Aturan 2: Salah satu Bot/Sinyal menentukan bidang

T&J

Apabila ada pertanyaan terkait Bot Sinyal, Anda dapat meninjau sejumlah pertanyaan yang sering diajukan oleh pengguna kami dalam artikel ini.