ÇOK ÖNEMLİ NOTLAR!
Sinyal botunuzdan gelen JSON mesajını herkese açık olarak PAYLAŞMAYIN. Yanlışlıkla paylaştıysanız, lütfen bu botu silin ve yeni bir tane oluşturun - bu durumda güvende olacaksınız.
Bu makalede açıklanmadığı sürece JSON dosyasına ek parametreler veya kod EKLEMEYİN. Aksi takdirde, stratejinizden gelen sinyalleri işlerken hatalarla karşılaşabilirsiniz.
Çift küme parantezi içine alınmış değerler TradingView placeholder değerleridir. Signal Bot TradingView Stratejisi için, strateji uyarılarında yalnızca “strateji” ön ekine sahip placeholderlar kullanılır.
{
"secret": "token",
"max_lag": "300",
"timestamp": "{{timenow}}",
"trigger_price": "{{close}}",
"tv_exchange": "{{exchange}}",
"tv_instrument": "{{ticker}}",
"action": "{{strategy.order.action}}",
"bot_uuid": "signal-bot-uuid",
"strategy_info": {
"market_position": "{{strategy.market_position}}",
"market_position_size": "{{strategy.market_position_size}}",
"prev_market_position": "{{strategy.prev_market_position}}",
"prev_market_position_size": "{{strategy.prev_market_position_size}}"
},
"order": {
"amount": "{{strategy.order.contracts}}",
"currency_type": "base"
}
}
Alan açıklamaları.
Bu spesifikasyonda açıklanmayan parametreleri içeren bir sinyal alınırsa, sinyal işleme sırasında bu parametrelerin okunmayacağına dikkat etmek önemlidir.
"secret" - kullanımı zorunludur. Belirli bir bot ve bir kullanıcı çerçevesinde gelen isteklerin kimliğini doğrulamak için benzersiz bir 3Commas belirteci. Belirteç, bir Signal Bot oluşturulurken otomatik olarak oluşturulur.
Önemli güvenlik notu: Webhook kurarken ve gönderirken, iletilen bu alanları herkese açıklamadığınızdan emin olun.
"timestamp" - isteğe bağlı olarak kullanılır ve bu sinyalin üretildiği zamanı temsil eder.
Zaman damgası, verileri senkronize etmek, zaman trendlerini analiz etmek ve piyasadaki olayların sırasını anlamak için kullanılabilir.
Alarm tetikleme zamanı ISO8601 formatında kabul edilir.
{{timenow}} verileri bu alana TradingView'den gelir.
"max_lag" - isteğe bağlı olarak kullanılır ve stratejinizin yürütülmesi sırasında meydana gelebilecek maksimum gecikmeyi temsil eder. Gecikme, ağ gecikmeleri veya veri işleme süresi gibi çeşitli nedenlerle ortaya çıkabilir. Kontrol, bot emir vermeye çalışmadan ÖNCE gerçekleştirilir.
Maksimum gecikmenin belirlenmesi, stratejinizin performansını değerlendirmek ve alım satım zamanlamasını yönetmek için faydalı olabilir. Gecikme bu eşiği aşarsa, alım satım stratejisinde veya uygulamasında dikkate alınması ve muhtemelen çözülmesi gereken sorunlara işaret edebilir.
İzin verilen maksimum sinyal işleme gecikmesi: 10 ile 86400 arasında bir tamsayı değeri.
Varsayılan: 300. Saniye cinsinden ölçülür.
"max_lag" değeri, "timestamp" sinyalinin gönderilmesi ile botun bu sinyali ilk işlediği an arasındaki süre karşılaştırılarak hesaplanır. Eğer JSON kodunda "max_lag": "300" ise, bu izin verilen gecikmenin 300 saniye veya 5 dakika olduğu anlamına gelir. Gecikme değeri belirtilen sınırı aşarsa, sinyal geçersiz kabul edilebilir veya bir hata ile işlenebilir.
"trigger_price" - kullanımı zorunludur. Alım satım sinyalini tetikleyen olayın veya koşulun oluşturulduğu fiyatı temsil eder.
Bu, hareketli bir ortalamayı, destek veya direnç seviyesini geçme fiyatı veya sisteminizde belirli bir stratejiyi yürütmek için bir seviyeye ulaşan fiyat gibi bir varlığın fiyatı olabilir.
Tetikleme fiyatı hakkındaki bilgiler, hangi olayların veya koşulların alım satım sinyallerini tetiklediğini ve bu sinyallere yanıt olarak hangi eylemlerin gerçekleştirilebileceğini anlamak için önemlidir.
{{close}} verileri bu alana TradingView'den gelir.
"tv_exchange" - kullanımı zorunludur. Bu alım satım sinyali veya verisi ile ilişkili borsa hakkındaki bilgileri temsil eder. Bu alan, alım satım verilerinin alındığı hizmeti veya borsayı gösterir.
Örneğin, "tv_exchange" değeri, alım satım verilerinin nereden geldiğine bağlı olarak BINANCE, OKX, BYBIT vb. olabilir.
Bu bilgiler, alım satım verilerinin kaynağını belirlemek ve izlemek için önemlidir ve ayrıca belirli borsalardan veya hizmetlerden gelen verileri analiz etmek için de kullanılabilir.
{{exchange}} verileri bu alana TradingView'den gelir.
"tv_instrument" - kullanımı zorunludur. Bu alım satım sinyalinin veya verisinin ilgili olduğu varlık hakkındaki bilgileri temsil eder. Bu alan, alım satım verilerinin alındığı vadeli işlemler, pariteler gibi belirli bir finansal aracı gösterir.
Örneğin, Binance Vadeli İşlemlerinde BTC/USDT paritesi için - "BTCUSDT.P" vb.
Bu bilgiler, işlem gören varlığın tanımlanması ve alım satım faaliyetinin ve özelliklerinin analiz edilmesi için önemlidir.
{{ticker}} verileri bu alana TradingView'den gelir.
"action" - kullanımı zorunludur. Alınan işlem sinyaline veya koşuluna yanıt olarak gerçekleştirilmesi gereken eylemi temsil eder.
"action" değerlerine örnek olarak şunlar verilebilir:
"buy" - bir varlık satın alın veya long bir pozisyona girin
"sell" - bir varlık satın veya mevcut pozisyondan çıkın.
{{strategy.order.action}} verileri bu alana TradingView'den gelir.
Lütfen dikkat edin:
Strateji Signal botundan önce başlatılmışsa ve bu strateji çerçevesinde bir pozisyona giriş veya bir pozisyondan çıkış zaten yapılmışsa, strateji ile geçici bir veri desenkronizasyonu olabilir. Örneğin, TradingView grafiğinde yürütülen bir emir, 3Commas tarafındaki Signal bot tarafından yürütülemez.
Stratejinin farklı aşamalarında sinyal verilerini alırken bot davranış tablosu:
strategy.order.action ("action" alanı) - TradingView JSON'dan alınan sinyalde, stratejiniz tarafından gerçekleştirilen eylem hakkındaki bilgileri temsil eder. Bu, aşağıdakilerden biri olabilir:
“buy” - stratejinizin bir varlığı satın almaya karar verdiğini gösterir.
“sell” - stratejinizin bir varlığı satmaya karar verdiğini gösterir.
“close” - stratejinizin mevcut pozisyonu (satın alınan veya satılan) kapatmaya karar verdiğini gösterir.
Bu değerler, TradingView JSON'dan alınan verilere dayalı olarak stratejinizde hangi eylemlerin gerçekleştirildiğini anlamanıza olanak tanır.
strategy.market_position (“market_position” alanı) - stratejiniz tarafından yönetilen mevcut pozisyonu gösterir. Bu değer, hangi pozisyonun açık olduğuna bağlı olarak farklı biçimler alabilir:
“ long ” - stratejinizin şu anda long bir pozisyonu yönettiği, yani bir varlığı satın almak için açık pozisyonlarınız olduğu anlamına gelir.
“ short ” - stratejinizin şu anda short bir pozisyon yönettiği, yani bir varlığı satmak için açık pozisyonlarınız olduğu anlamına gelir.
“ flat” - stratejinizin şu anda herhangi bir açık pozisyon yönetmediği, yani long veya short pozisyon tutmadığınız anlamına gelir.
Bu bilgiler, stratejinizin mevcut durumunu izlemek ve mevcut pazar konumuna göre daha sonraki adımlar hakkında karar almak için önemlidir.
strategy.prev_market_position (“prev_market_position” alanı) - stratejiniz tarafından yönetilen önceki pozisyonu gösterir. Bu değer, stratejinizde son eylem gerçekleştirilmeden önceki pozisyonun durumunu temsil eder. Değer örnekleri:
“long” - önceki durumdaki stratejinizin long bir pozisyon yönettiği anlamına gelir;
“short” - önceki durumdaki stratejinizin short bir pozisyon yönettiği anlamına gelir;
“flat” - önceki durumdaki stratejinizin herhangi bir açık pozisyon yönetmediği anlamına gelir.
Bu bilgiler, pozisyonlarındaki değişiklikleri izlemek ve stratejinizin farklı piyasa koşullarında pozisyonlara girme ve çıkma konusunda nasıl kararlar aldığını analiz etmek için kullanışlıdır.
Gönderilen bir sinyal örneği:
Sinyalde hangi komutların bulunduğuna bağlı olarak, bot aşağıdaki eylemleri gerçekleştirecektir:
İmkansız parametre kombinasyonları Signal botunun bir hata görüntülemesine ve sinyali 'Başarısız' durumuna taşımasına neden olacaktır. Kullanıcılar bu başarısız sinyalleri botun sinyal tablosunda görüntüleyebilirler.
Sinyalin 'Başarısız' olarak işaretlenmesine neden olacak parametre kombinasyonlarına bazı örnekler aşağıda verilmiştir:
“bot_uuid” - kullanımı zorunludur. 3Commas sistemindeki Sinyal Botunun tanımlama kodu.
Önemli güvenlik notu: Webhook yapılandırırken ve gönderirken, iletilen bu alanları herkese ifşa etmediğinizden emin olun.
“market_position” - kullanımı zorunludur. Mevcut piyasa konumunu belirtir. Bu, aşağıdaki değerlerden biri olabilir:
“long”: Bu, açık bir long pozisyonunuz olduğu, yani varlığı yükseliş beklentisiyle elinizde tuttuğunuz anlamına gelir.
“short”: Bu, açık bir short pozisyonunuz olduğu, yani düşüş beklentisiyle varlığı sattığınız anlamına gelir.
“flat”: Bu, açık pozisyonunuz olmadığı, yani long veya short pozisyon tutmadığınız anlamına gelir.
Bu bilgiler, yatırımcıların mevcut piyasa durumunu anlamaları ve yeni pozisyonlar açmak, mevcut pozisyonları kapatmak veya piyasa koşullarına bağlı olarak stratejilerini değiştirmek gibi uygun kararlar almaları için yararlıdır.
{{strategy.market_position}} verileri bu alana TradingView'den gelir.
“market_position_size” - kullanımı zorunludur. Mevcut piyasa pozisyonunun boyutunu temsil eder. Bu sayı, şu anda piyasada açık bir pozisyonda sahip olduğunuz varlık sayısını gösterir.
Örneğin, “market_position_size” 100'e eşitse, bu 100 birim açık varlığınız olduğu anlamına gelir.
Bu bilgi, piyasadaki pozisyonlarınızın büyüklüğünü değerlendirmek ve riskleri yönetmek için önemlidir, çünkü pozisyon büyüklüğü işlemden kaynaklanan potansiyel kayıpları veya karları doğrudan etkiler.
{{strategy.market_position_size}} verileri bu alana TradingView'den gelir.
“prev_market_position” - kullanımı zorunludur. Önceki piyasa pozisyonu hakkındaki bilgileri temsil eder. Bu, stratejinizde son işlem yapılmadan önceki piyasa pozisyonunun durumunu gösterir.
“prev_market_position” değeri aşağıdakilerden biri olabilir:
“ long ”: Bu, stratejinizin son işlem yapılmadan önce piyasada long pozisyonu yönettiği anlamına gelir.
“short”: Bu, stratejinizin son işlem yapılmadan önce piyasada short pozisyonu yönettiği anlamına gelir.
“flat”: Bu, stratejinizin son işlem yapılmadan önce piyasadaki herhangi bir açık pozisyonu yönetmediği anlamına gelir. Bu durumda, long ya da short pozisyon tutmuyordunuz.
Bu bilgiler, piyasa pozisyonlarındaki değişiklikleri analiz etmek ve stratejinizin farklı piyasa koşullarında pozisyonlara girme ve çıkma konusunda nasıl kararlar aldığını anlamak için kullanışlıdır.
{{strategy.prev_market_position}} verileri bu alana TradingView'den gelir.
“prev_market_position_size” - kullanımı zorunludur. Önceki piyasa pozisyonunun boyutunu temsil eder. Bu, stratejinizde son işlem yapılmadan önce piyasada açık pozisyonda olan varlıkların sayısını gösterir.
Örneğin, “prev_market_position_size” 100'e eşitse, bu, önceki piyasa pozisyonunda 100 birim açık varlığınız olduğu anlamına gelir.
Bu bilgiler, piyasa pozisyonlarının büyüklüğündeki değişiklikleri analiz etmek ve stratejinizin farklı piyasa senaryolarında işlem hacmini nasıl yönettiğini anlamak için kullanışlıdır.
{{strategy.prev_market_position_size}} verileri bu alana TradingView'den gelir.
“order.amount” - kullanımı zorunludur. Bir alım satım emrinin sonucu olarak satın alınması veya satılması gereken varlık sayısını temsil eder.
Örneğin, “order.amount” 100'e eşitse, bu, varlıktan 100 birim satın alınması veya satılması gerektiği anlamına gelir.
{{strategy.order.contracts}} verileri bu alana TradingView'den gelir.
“order.currency_type” - kullanımı zorunludur. Alım satım emriyle ilişkili para birimi türünü temsil eder. Bu, bu emir bağlamında alım satım veya kapatma işlemleri için kullanılan para birimi türünü gösterir.
Bu bilgi, kullanılan para biriminin belirlenmesi ve hesaplamaların doğruluğunun ve işlemlerin yürütülmesinin sağlanması için önemlidir.
“order.currency_type” değeri yalnızca aşağıdakilerden biri olabilir:
“base” - emir boyutunun botun satın aldığı para birimi cinsinden gönderildiği anlamına gelir, örneğin XRP, DOGE, BTC, ETH.
Ek alanlar.
"enable"/"disable"
Bu eylem Signal botlarını etkinleştirecektir:
{
...
"action": "enable",
...
}Bu eylem Signal botlarını durduracaktır:
{
...
"action": "disable",
...
}
Kullanım örnekleri.
3Commas hesabınızdaki tüm aktif Signal botlarını durdurun
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable"
}
Belirli borsa hesaplarındaki tüm aktif Signal botlarını durdurun
Bağlı borsa hesabınızın ID'sini bilmeniz gerekecektir - Portföyüm sayfasında gerekli borsayı bulun, 3 noktalı menüye tıklayın, Görüntüle'ye tıklayın ve URL çubuğunda ID'yi göreceksiniz:
1'den fazla borsa hesabı eklemek için, bunları köşeli parantez içine yerleştirmeniz ve virgülle bölmeniz gerekecektir:
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"account_ids": [3345345, 3345347]
}
Bir veya birkaç belirli Signal botunu durdurun
Signal botlarının UUID'sini bilmeniz gerekecektir. Botun yanındaki i butonunun üzerine geldiğinizde UUID'sini göreceksiniz. Eğer birden fazla bot eklemek istiyorsanız, UUID'leri köşeli parantez içinde tırnak işareti ile yazabilir ve virgül ile bölebilirsiniz:
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"bot_uuid": ["xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"]
}
Borsa hesaplarınızdaki tüm aktif Long Signal botlarını durdurun
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"scopes": ["long", "real"]
}
Aktif Signal botlarının pozisyonlarını durdurun ve kapatın
{
...
"action": "disable",
"positions_sub_action": "market_close"
...
}
Pozisyonu piyasa fiyatından kapatmak istiyorsanız, satırı eklemeniz gerekir:
"positions_sub_action": "market_close"
İşte bir örnek:
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"positions_sub_action": "market_close"
}
Pozisyonu iptal etmek ve daha sonra manuel olarak işlemek istiyorsanız, satırı eklemeniz gerekir:
"positions_sub_action": "cancel"
İşte bir örnek:
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"positions_sub_action": "cancel"
}
Önemli notlar.
Özel sinyal tipi botlarda, Long veya Short pozisyonunu devre dışı bırakma sinyali, sadece bir tarafı değil, botun kendisini de iptal edecektir.
Long veya Short botları ayrı ayrı devre dışı bırakmak istiyorsanız, biri Long stratejili diğeri Short stratejili olmak üzere iki ayrı bot oluşturmanız gerekir.
Farklı parametreler birleştirilebilir ve bir “VE” mantığı ile çalışırlar. Tüm parametreler koşulları karşılıyorsa, sinyal gelecek ve işlenecektir. En az bir parametre karşılanmazsa sinyal reddedilecektir:
{
"secret": "xxxxxxxxx.xxxxxxxxxxx.xxxxxxxxxxx",
"max_lag": "300",
"timestamp": "{{timenow}}",
"action": "disable",
"scopes": ["long", "real"],
"account_ids": [1, 2, 3]
}