Spesifikasi Pesan Peringatan Bot Sinyal Trading 2.0

Dipublikasikan Pada 30 Agu 2023Diperbarui Pada 3 Jul 2024Baca 16 mnt

Daftar Isi

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™".

Bag A - ringkasan singkat 1

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.

Bag A - ringkasan singkat 2

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

Parameter
Diperlukan
Nilai
id
Diperlukan
  • {{strategy.order.id}} dari TradingView

action
Diperlukan
  • {{strategy.order.action}} dari TradingView

marketPosition
Diperlukan
  • {{strategy.market_position}} dari TradingView

prevMarketPosition
Diperlukan
  • {{strategy.prev_market_position}} dari TradingView

instrument
Diperlukan
  • {{ticker}} dari TradingView

  • Format Instld dari OKX

signalToken
Diperlukan
Disediakan oleh OKX pada saat pembuatan sinyal
timestamp
Diperlukan
{{timenow}} dari TradingView
maxLag
Opsional
Nilai bilangan bulat positif antara [1, 3600]. Default ke 60.
investmentType
Opsional*


  • base (UNTUK SINYAL MASUK DAN KELUAR) Jumlah dalam mata uang dasar

  • margin (KHUSUS SINYAL MASUK) Margin yang diinvestasikan dalam mata uang kutipan

  • contract (KHUSUS SINYAL MASUK) Kontrak dalam jumlah tetap

  • percentage_balance (KHUSUS SINYAL MASUK) Berdasarkan % Saldo Tersedia (yaitu., margin yang tersedia untuk membuka order baru)

  • percentage_investment (KHUSUS SINYAL MASUK) Berdasarkan persentase Investasi Aktif dalam bot Anda. Investasi Aktif biasanya merupakan margin yang Anda investasikan pada saat pembuatan bot dan tetap tetap hingga Anda menambahkan lebih banyak margin dan memilih untuk meningkatkan nilai ini.

  • percentage_position (KHUSUS SINYAL KELUAR) Berdasarkan % posisi terbuka

amount
Diperlukan
  • base (bilangan pecahan positif)

  • margin (bilangan pecahan positif)

  • contract (bilangan bulat positif)

  • percentage_balance (nilai pecahan antara [0.01, 100] dalam bentuk %)

  • percentage_investment (nilai pecahan antara [0.01, 100] dalam bentuk %)

  • percentage_position (nilai pecahan antara [0.01, 100] dalam bentuk %)

* investmentType akan default ke "percentage_investment" jika sinyal dianggap merupakan sinyal entri dan "percentage_position" jika sinyal dianggap merupakan sinyal keluar. Namun, Anda sangat disarankan untuk mengatur nilai ini menjadi "base" dan amount menjadi "{{strategy.order.contracts}}" untuk mendapatkan kompatibilitas yang maksimal dengan strategi TradingView Anda.

1. Spesifikasi Pesan Peringatan - id

Bag A - 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

Bag A - action

action - Beli atau Jual?

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

3. Spesifikasi Pesan Peringatan - marketPosition

Bag A - 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

Bag A - 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

Bag A - 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

Bag A - 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

Bag A - temukan signalToken 1

  1. Temukan signalToken Anda di bagian pesan peringatan yang disarankan

Bag A - temukan signalToken 2

7. Spesifikasi Pesan Peringatan - timestamp

Bag A - 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

Bag A - 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

Bag A - investmenttype dan 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

Parameter Diperlukan Nilai
action Diperlukan
  • ENTER_LONG

  • ENTER_SHORT

  • EXIT_LONG

  • EXIT_SHORT

instrument Diperlukan
  • {{ticker}} dari TradingView

  • Format Instld dari OKX

signalToken Diperlukan Disediakan oleh OKX pada saat pembuatan sinyal
timestamp Diperlukan {{timenow}} dari TradingView
maxLag Opsional Nilai bilangan bulat positif antara [1, 3600]. Default ke 60.
orderType Opsional. Parameter diperlukan jika orderType = Limit
  • market

  • limit

orderPriceOffset Opsional. Parameter diperlukan jika tidak ada pengaturan yang dikonfigurasikan pada saat pembuatan Bot Sinyal OKX Nilai pecahan antara [0, 100] dalam bentuk %
investmentType Opsional. Parameter diperlukan jika orderType = Limit
  • margin (KHUSUS SINYAL MASUK) Margin yang diinvestasikan dalam mata uang kutipan

  • contract (KHUSUS SINYAL MASUK) Kontrak dalam jumlah tetap

  • percentage_balance (KHUSUS SINYAL MASUK) Berdasarkan % Saldo Tersedia (yaitu., margin yang tersedia untuk membuka order baru)

  • percentage_investment (KHUSUS SINYAL MASUK) Berdasarkan persentase Investasi Aktif dalam bot Anda. Investasi Aktif biasanya merupakan margin yang Anda investasikan pada saat pembuatan bot dan tetap tetap hingga Anda menambahkan lebih banyak margin dan memilih untuk meningkatkan nilai ini.

  • percentage_position (KHUSUS SINYAL KELUAR) Berdasarkan % posisi terbuka

amount Opsional. Parameter diperlukan jika orderType = Limit
  • margin (bilangan pecahan positif)

  • contract (bilangan bulat positif)

  • percentage_balance (nilai pecahan antara [0.01, 100] dalam bentuk %)

  • percentage_investment (nilai pecahan antara [0.01, 100] dalam bentuk %)

  • percentage_position (nilai pecahan antara [0.01, 100] dalam bentuk %)

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
Untuk Jenis Order
Order Pasar (Bot) ✅
Order Terbatas (Sinyal) ❌
  1. Aturan 2: Salah satu Bot/Sinyal menentukan bidang
Untuk Jenis Investasi dan Jumlah
T/A (Bot) ❌
Saldo Tersedia 100% (Sinyal) ✅

T&J

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