API Bitmex

Bitmex는 암호화폐 거래소이자 파생상품 거래 플랫폼입니다.

다음 API가 지원됩니다:

WebSocket streams: 일부 메서드를 구독하여 데이터를 실시간으로 받을 수 있게 합니다. 이벤트는 서버에 의해 구독자에게 푸시됩니다. 프로토콜로 WebSocket을 사용합니다.
REST API: 클라이언트가 서버에 시장 및 계정 데이터를 요청할 수 있습니다. 인증을 위해 API Key와 Secret이 필요하며 프로토콜로 HTTPs를 사용합니다.

Properties

Bitmex API에는 2가지 유형의 메서드가 있습니다: 공개 및 비공개. 공개 메서드는 인증 없이 액세스할 수 있습니다(예: 티커 가격 가져오기). 일부는 비공개이며 사용자 데이터와 관련됩니다. 이러한 메서드는 Bitmex API 키 사용이 필요합니다.

ApiKey: Bitmex 계정에서 새 api key를 요청하고, 그 값을 이 속성에 복사하면 됩니다.
ApiSecret: API의 secret이며, 안전하게 보관하십시오.
TestNet: 활성화되면 Bitmex Demo Account에 연결합니다(기본값 false).
HTTPLogOptions: HTTP 요청 로그를 텍스트 파일에 저장합니다
- Enabled: 활성화되면 WebSocket API의 모든 HTTP 요청을 저장합니다.
- FileName: 로그가 저장될 파일 이름의 전체 경로

Most common uses

WebSockets API
- WebSocket API에 연결하는 방법
- WebSocket 채널 구독 방법

REST API
- Bitmex 주문을 넣는 방법

WebSocket API

Subscribe / Unsubscribe

BitMEX는 실시간 데이터 구독을 허용합니다. 이 액세스는 연결되면 속도 제한이 없으며 프로그램에 가장 최신 데이터를 제공하는 가장 좋은 방법입니다. 일부 topic에서는 Symbol을 전달하여 심볼별로 이벤트를 필터링할 수 있습니다(예: trades, quotes...).

다음 구독 토픽은 인증 없이 사용할 수 있습니다:

btmAnnouncement: 사이트 공지사항
btmChat: Trollbox 채팅
btmConnected: 연결된 사용자/bot의 통계
btmFunding: 스왑 펀딩 비율 업데이트. 펀딩 간격마다 전송됨(일반적으로 8시간)
btmInstrument: turnover 및 bid/ask를 포함한 상품 업데이트
btmInsurance: 일일 Insurance Fund 업데이트
btmLiquidation: book에 입력되는 Liquidation 주문
btmOrderBookL2_25: level 2 호가창의 상위 25개 수준
btmOrderBookL2: 전체 레벨 2 주문서
btmOrderBook10: 전통적인 전체 book 푸시를 사용한 최상위 10개 수준
btmPublicNotifications: 시스템 전체 알림(수명이 짧은 메시지에 사용됨)
btmQuote: book의 최상위 수준
btmQuoteBin1m: 1분 시세 빈
btmQuoteBin5m: 5분 견적 bin
btmQuoteBin1h: 1시간 호가 빈
btmQuoteBin1d: 1일 quote bin
btmSettlement: Settlements
btmTrade: 실시간 거래
btmTradeBin1m: 1분 거래 bin
btmTradeBin5m: 5분 거래 빈
btmTradeBin1h:1시간 거래 bin
btmTradeBin1d: 1일 거래 빈

다음 subject는 인증이 필요합니다:

btmAffiliate: 총 추천 사용자 수 & 지급 % 등 제휴 상태
btmExecution: 개별 체결, 주문당 여러 개일 수 있습니다.
btmOrder: 주문에 대한 라이브 업데이트
btmMargin: 현재 계정 잔액 및 margin 요구 사항에 대한 업데이트
btmPosition: 포지션에 대한 업데이트
btmPrivateNotifications: 개별 알림 - 현재 사용되지 않음
btmTransact: 입금/출금 업데이트
btmWallet: 총 입금 및 출금을 포함한 Bitcoin 주소 잔액 데이터

수신된 메시지의 예:


{
      "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

user-locked 스트림을 구독하려면 먼저 인증해야 합니다. 잘못된 인증은 연결을 닫습니다.

BitMEX API를 사용하려면 API Key가 필요합니다.

영구 API Key는 메인 자격 증명을 손상시키지 않고도 IP 주소 범위로 잠그고 원할 때 폐기할 수 있습니다. 또한 갱신이 필요하지 않습니다.

API Key 인증을 사용하려면 계정에서 API Key를 생성해야 합니다.

인증된 토픽을 구독하기 전에 Authenticate 메서드를 호출하십시오.

CancelAllAfter (Dead Man's Switch)

CancelAllAfter 메서드는 Dead Man's Switch 기능을 구현합니다. 타임아웃 값(밀리초)으로 호출되면, 타임아웃 기간 내에 후속 CancelAllAfter 호출이 수신되지 않으면 서버에게 모든 미체결 주문을 취소하도록 지시합니다. 이는 네트워크 연결 끊김의 경우 주문이 취소되도록 보장하는 데 유용합니다.

REST API

Method	설명
GetExecutions	이는 주문 개시 및 취소, 주문 상태 변경을 포함한 모든 raw 트랜잭션을 반환합니다.
GetExecutionsTradeHistory	이는 더 집중된 트랜잭션을 반환합니다.
GetInstruments	이는 결제되었거나 상장 폐지된 것을 포함하여 모든 상품과 인덱스를 반환합니다. 개별 상품을 쿼리하거나 복잡한 필터를 사용하려면 이 엔드포인트를 사용하십시오.
GetOrders	미결제 주문만 가져오기
PlaceOrder	TsgcHTTPBitmexOrder 객체를 사용하여 raw 주문을 합니다.
PlaceMarketOrder	새 MARKET 주문을 배치합니다.
PlaceLimitOrder	새 LIMIT 주문을 실행합니다.
PlaceStopOrder	새 STOP 주문을 넣습니다.
PlaceStopLimitOrder	새 STOPLIMIT 주문을 넣습니다.
AmendOrder	기존 주문을 수정합니다.
CancelOrder	활성 주문을 취소합니다.
CancelAllOrders	모든 활성 주문을 취소합니다.
CancelAllOrdersAfter	일정 시간 후 모든 주문 취소.
ClosePosition	미결제 포지션을 청산합니다.
GetOrderBook	세로 형식으로 현재 OrderBook 가져오기
GetPosition	포지션을 가져옵니다.
SetPositionIsolate	포지션별로 isolated margin 또는 cross-margin을 활성화합니다.
SetPositionLeverage	포지션당 leverage를 선택합니다.
SetPositionRiskLimit	위험 한도를 업데이트합니다.
SetPositionTransferMargin	포지션에서 자기자본을 이체하거나 인출합니다.
GetQuotes	Get Quotes
GetTrades	Get Trades
GetFunding	펀딩 데이터를 가져옵니다.
GetInsurance	보험 기금 데이터를 가져옵니다.
GetTradeBucketed	구성 가능한 빈 크기로 버킷화된 거래 데이터(OHLCV)를 가져옵니다.
GetQuoteBucketed	구성 가능한 빈 크기로 버킷화된 호가 데이터를 가져옵니다.
GetSettlement	정산 데이터를 가져옵니다.
GetLiquidation	청산 주문을 가져옵니다.
GetInstrumentIndices	instrument 인덱스를 가져옵니다.
GetInstrumentCompositeIndex	악기에 대한 복합 인덱스 데이터를 가져옵니다.
GetStats	거래소 전체 통계를 가져옵니다.
GetStatsHistory	과거 거래소 통계를 가져옵니다.
GetStatsHistoryUSD	과거 USD 환율 통계를 가져옵니다.
GetUserMargin	계정 마진 데이터를 가져옵니다.
GetUserWallet	지갑 정보를 가져옵니다.
GetUserWalletHistory	지갑 거래 내역을 가져옵니다.
GetUserWalletSummary	지갑 요약을 가져옵니다.