API Bitmex

Bitmex

 

Bitmex, bir kripto para borsası ve türev işlem platformudur.

 

Aşağıdaki API'ler desteklenir:

 

1. WebSocket akışları: bazı yöntemlere abone olmanıza ve verileri gerçek zamanlı almanıza olanak tanır. Olaylar, sunucu tarafından abonelere gönderilir. Protokol olarak WebSocket kullanır.
2. REST API: istemciler sunucudan piyasa ve hesap verisi isteyebilir. Kimlik doğrulamak için bir API Key ve Secret gerektirir ve protokol olarak HTTPs kullanır.

 

Özellikler

Bitmex API'sinin 2 tür yöntemi vardır: genel ve özel. Genel yöntemlere kimlik doğrulama olmadan erişilebilir, örneğin: ticker fiyatlarını alma. Bazıları özeldir ve kullanıcı verileriyle ilgilidir; bu yöntemler Bitmex API anahtarlarının kullanılmasını gerektirir.

 

• ApiKey: Bitmex hesabınızda yeni bir api anahtarı isteyebilirsiniz, değeri bu özelliğe kopyalamanız yeterlidir.
• ApiSecret: API'nin gizli anahtarıdır, güvende tutun.
• TestNet: etkinleştirilirse Bitmex Demo Hesabına bağlanır (varsayılan false).
• HTTPLogOptions: HTTP isteklerinin günlüğünü bir metin dosyasında depolar
  • Enabled: etkinleştirilirse, WebSocket API'sinin tüm HTTP isteklerini depolar.
  • FileName: günlüklerin depolanacağı dosya adının tam yolu

 

 

En yaygın kullanımlar

• WebSockets API
  • WebSocket API'ye Nasıl Bağlanılır
  • Bir WebSocket Kanalına Nasıl Abone Olunur

• REST API

  • Bitmex Emri Nasıl Verilir

 

WebSocket API

 

Subscribe / Unsubscribe

    

BitMEX, gerçek zamanlı verilere abone olmanıza olanak tanır. Bu erişim, bağlandıktan sonra hız sınırlamasına tabi değildir ve programlarınıza en güncel verileri almanın en iyi yoludur. Bazı konularda (topic), olayları sembole göre filtrelemek için bir Symbol geçirebilirsiniz, örnek: trades, quotes...

 

Aşağıdaki abonelik topic'leri kimlik doğrulama olmadan kullanılabilir:

 

• btmAnnouncement: Site Duyuruları

• btmChat: Trollbox sohbeti

• btmConnected: Bağlı kullanıcıların/botların istatistikleri

• btmFunding: Swap fonlama oranlarının güncellemeleri. Her fonlama aralığında gönderilir (genellikle 8 saat)

• btmInstrument: turnover ve bid/ask dahil olmak üzere Enstrüman güncellemeleri

• btmInsurance: Günlük Insurance Fund güncellemeleri

• btmLiquidation: Defter (book) içine girildikleri haliyle tasfiye (liquidation) emirleri

• btmOrderBookL2_25: Seviye 2 emir defterinin ilk 25 seviyesi

• btmOrderBookL2: Tam seviye 2 emir defteri

• btmOrderBook10: Geleneksel tam defter gönderimi kullanarak en üst 10 seviye

• btmPublicNotifications: Sistem genelinde bildirimler (kısa ömürlü mesajlar için kullanılır)

• btmQuote: Defterin en üst seviyesi

• btmQuoteBin1m: 1 dakikalık fiyat teklifi (quote) kovaları

• btmQuoteBin5m: 5 dakikalık quote bin'leri

• btmQuoteBin1h: 1 saatlik kotasyon bölmeleri

• btmQuoteBin1d: 1 günlük kotasyon bin'leri

• btmSettlement: Settlements

• btmTrade: Canlı işlemler

• btmTradeBin1m: 1 dakikalık işlem bin'leri

• btmTradeBin5m: 5 dakikalık işlem (trade) kovaları

• btmTradeBin1h:1 saatlik ticaret bin'leri

• btmTradeBin1d: 1 günlük işlem bölmeleri

 

Aşağıdaki konular kimlik doğrulama gerektirir:

 

• btmAffiliate: Toplam yönlendirilen kullanıcılar & ödeme % gibi Affiliate durumu

• btmExecution: Bireysel yürütmeler; emir başına birden fazla olabilir

• btmOrder: Emirlerinizdeki canlı güncellemeler

• btmMargin: Geçerli hesap bakiyeniz ve marj gereksinimlerinizle ilgili güncellemeler

• btmPosition: Pozisyonlarınızdaki güncellemeler

• btmPrivateNotifications: Bireysel bildirimler - şu anda kullanılmıyor

• btmTransact: Para Yatırma/Çekme güncellemeleri

• btmWallet: toplam para yatırma ve para çekme dahil olmak üzere Bitcoin adres bakiyesi verileri

 

 

Alınan mesaj örneği:

 

{
      "table":"orderBookL2_25",
      "keys":["symbol","id","side"],
      "types":{"id":"long","price":"float","side":"symbol","size":"long","symbol":"symbol"}
      "foreignKeys":{"side":"side","symbol":"instrument"},
      "attributes":{"id":"sorted","symbol":"grouped"},
      "action":"partial",
      "data":[
        {"symbol":"XBTUSD","id":17999992000,"side":"Sell","size":100,"price":80},
        {"symbol":"XBTUSD","id":17999993000,"side":"Sell","size":20,"price":70},
        {"symbol":"XBTUSD","id":17999994000,"side":"Sell","size":10,"price":60},
        {"symbol":"XBTUSD","id":17999995000,"side":"Buy","size":10,"price":50},
        {"symbol":"XBTUSD","id":17999996000,"side":"Buy","size":20,"price":40},
        {"symbol":"XBTUSD","id":17999997000,"side":"Buy","size":100,"price":30}
      ]
}
 
{
      "table":"orderBookL2_25",
      "action":"update",
      "data":[
        {"symbol":"XBTUSD","id":17999995000,"side":"Buy","size":5}
      ]
    }
{
      "table":"orderBookL2_25",
      "action":"delete",
      "data":[
        {"symbol":"XBTUSD","id":17999995000,"side":"Buy"}
      ]
}
{
      "table":"orderBookL2_25",
      "action":"insert",
      "data":[
        {"symbol":"XBTUSD","id":17999995500,"side":"Buy","size":10,"price":45},
      ]
}

Authentication

    

Kullanıcı tarafından kilitli akışlara abone olmak istiyorsanız, önce kimlik doğrulaması yapmalısınız. Geçersiz kimlik doğrulamasının bağlantıyı kapatacağını unutmayın.

 

BitMEX API kullanımı bir API Anahtarı gerektirir.

 

Kalıcı API Anahtarları, IP adresi aralıklarına kilitlenebilir ve ana kimlik bilgilerinizi tehlikeye atmadan istenildiği zaman iptal edilebilir. Ayrıca yenileme gerektirmezler.

 

API Anahtarı kimlik doğrulamasını kullanmak için hesabınızda bir API Anahtarı oluşturmalısınız.

 

Herhangi bir Kimlik Doğrulamalı Konuya abone olmadan önce Authenticate yöntemini çağırın.

CancelAllAfter (Dead Man's Switch)

CancelAllAfter yöntemi, Dead Man's Switch özelliğini uygular. Bir zaman aşımı değeriyle (milisaniye cinsinden) çağrıldığında, zaman aşımı süresi içinde sonraki bir CancelAllAfter çağrısı alınmazsa sunucuya tüm açık emirleri iptal etme talimatını verir. Bu, ağ bağlantısı kesilmesi durumunda emirlerin iptal edilmesini sağlamak için kullanışlıdır.

REST API

 

Yöntem	Açıklama
GetExecutions	Bu, emir açma ve iptal etme ile emir durumu değişikliklerini içeren tüm ham işlemleri döndürür.
GetExecutionsTradeHistory	Bu, daha odaklanmış İşlemler döndürür.
GetInstruments	Bu, yerleşmiş veya listelenmemiş olanlar dahil tüm araçları ve endeksleri döndürür. Tek tek araçları sorgulamak veya karmaşık bir filtre kullanmak istiyorsanız bu uç noktayı kullanın.
GetOrders	Yalnızca açık emirleri almak için
PlaceOrder	TsgcHTTPBitmexOrder nesnesini kullanarak ham bir emir verin.
PlaceMarketOrder	Yeni bir MARKET emri verin.
PlaceLimitOrder	Yeni bir LIMIT emri verin.
PlaceStopOrder	Yeni bir STOP emri verin.
PlaceStopLimitOrder	Yeni bir STOPLIMIT emri verin.
AmendOrder	Mevcut bir emri değiştirin.
CancelOrder	Etkin bir Siparişi iptal eder.
CancelAllOrders	Tüm Aktif Emirleri İptal Et.
CancelAllOrdersAfter	Belirli bir süreden sonra Tüm Emirleri İptal Et.
ClosePosition	Açık bir pozisyonu kapatın.
GetOrderBook	Mevcut OrderBook'u dikey biçimde alın
GetPosition	Pozisyonlarınızı alın.
SetPositionIsolate	Pozisyon başına izole marj veya çapraz marjı etkinleştirin.
SetPositionLeverage	Pozisyon başına kaldıraç seçin.
SetPositionRiskLimit	Risk limitinizi güncelleyin.
SetPositionTransferMargin	Bir pozisyona öz sermaye aktarın veya pozisyondan öz sermaye çıkarın.
GetQuotes	Get Quotes
GetTrades	Get Trades
GetFunding	Funding verilerini alın.
GetInsurance	Insurance fund verilerini alın.
GetTradeBucketed	Yapılandırılabilir bin boyutlarıyla gruplandırılmış işlem verilerini (OHLCV) alın.
GetQuoteBucketed	Yapılandırılabilir bölme boyutlarıyla bölmelenmiş kotasyon verilerini alın.
GetSettlement	Uzlaşma verilerini alın.
GetLiquidation	Likidasyon emirlerini alın.
GetInstrumentIndices	Enstrüman indekslerini alır.
GetInstrumentCompositeIndex	Enstrümanlar için composite index verilerini alın.
GetStats	Borsa genelindeki istatistikleri alın.
GetStatsHistory	Geçmiş exchange istatistiklerini alın.
GetStatsHistoryUSD	Geçmiş USD borsa istatistiklerini alın.
GetUserMargin	Hesabınızın marj verilerini alın.
GetUserWallet	Cüzdan bilgilerinizi alın.
GetUserWalletHistory	Cüzdan işlem geçmişinizi alın.
GetUserWalletSummary	Cüzdanınızın bir özetini alın.