websocket URL :

wss://wsapi.bitz.top/

데이터 압축

데이터 전송 효율을 높이기 위해 Bit-Z Websocket은 2019 년 10 월 8 일 17:00 (UTC + 8)에 비 압축 데이터 지원을 중단하고 GZIP 압축 데이터 만 출력할 예정입니다. Bit-Z API 사용자분들 빨리 업그레이드하시길 바랍니다. 구독 할 때 dataType = 1 매개 변수를 추가하며 사용자는 데이터를 수신 한 후 로컬에서 압축 해제하셔야 됩니다. 압축 해제에 대한 문서 및 데모를 참조하십시오

하트 비트 및 긴 연결 전략

a) 클라이언트는 5 초마다 ping 문자열을 서버에 보냅니다. 서버는이 하트 비트와 긴 연결을 유지하기 위해 pong 문자열을 반환합니다.

b) 10 초마다 서버 감지 : 60 초이내에 클라이언트로부터 'ping' 메시지가 수신되지 않으면 자발적으로 연결이 끊어집니다.

c) 서버5초마다 클라이언트와의 네트워크 연결 상태를 점검하는데, 이 경우에 네트워크가 중단되면, 서버는 이번 구독을 삭제하게 되며, 클라이언트는 새로운 메시지를 받지 못하게 되며, 이 시점에 클라이언트는 구독 재시작 요청을 필요로 하며, 이전의 구독 요청은 효력을 잃게 됩니다.

d) 서버는 클라이언트에게 새로운 메시지를 보낼 때에도, 이 시점의 인터넷 접속 상태를 점검하여, 네트워크가 중단되는 경우, 위와 같이 처리됩니다.

요청 명령 형식 전송:

전송json

{"action":"Topic.sub","data":{"symbol":"bz_usdt","type":"market,depth,order,kline","resolution":"60min","_CDID":"100002","dataType": "1"},"msg_id":1562156656532}

분석한 후 표시:

{
    "action": "Topic.sub",
    "data": {
        "symbol": "bz_usdt",
        "type": "market,depth,order,kline",
        "resolution": "60min",
        "_CDID": "100002",
        "dataType": "1"
    },
    "msg_id": 1562156656532
}

세부 명령:

action:
  • 구독 요청:Topic.sub 구독 추가、Topic.unsub 구독 취소;단일 선택
data :
a) symbol
  • 코인 간 거래페어 명, 예: btc_usdteth_btc;단일 선택
    b) type
  • 구독 유형 옵션: 시세 market、심도depth、체결 주문order、k 라인kline; 복수 선택 가능, 쉼표로 구분
    c) resolution (필수 전송이 아님)
  • 구독 유형은 kline이 있는 경우 전송해야 합니다.:1min5min15min30min60min4hour1day5day1week1mon; 단일 선택
    d) _CDID
  • 스테이션 정보 bitz 웹 사이트 값: 100002

    5. dataType (디폴트0 전달할 필요는 없음)
  • 0 : (디폴트) 문자열 형식 데이터

  • 1 : gzip 압축 바이너리 형식 데이터, 사용자 클라이언트 압축 해제 필요

    msg_id:

    현재 밀리초 타임스탬프

클라이언트가 메시지를 수신함:

a)market 시세 소식:

{
    "msgId": 0,  # 메시지 ID
    "params": [],  # 파라미터
    "data": {  # 데이터
        "btc_usdt": {  #거래페어 명
            "s": "btc_usdt", #거래페어 명
            "q": "748289393.19", #24H 거래액
            "v": "68457.02", #24H 거래량
            "tp": "6.58",  #금일 등락폭
            "p24": "11.74", #24H 등락폭
            "o": "10138.95", #개장가
            "h": "11500.00",  #24H 최고가
            "l": "9728.61",  #24H 최저가
            "n": "11330.00", #현재 가격
            "nP": 4,  #수량은 소수점 자리 표시
            "pP": 2, #가격은 소수점 자리 표시
            "cny": "77978.74", #인민폐 평가
            "usd": "11330.00", #달러 평가
            "krw": "13235981.30", #원화 평가
            "jpy": "1220905.17" #엔 평가
        },
        ...... #기타 모든 거래페어 시세
    },
    "action": "Pushdata.market", #구독 유형
    "time": 1562159048028, #메시지 시간
    "source": "sub-api" #발송원
}

b) order 체결 주문 정보:

{
    "msgId": 0, #메시지 ID
    "params": { #파라미터
        "symbol": "bz_usdt" #거래페어 명
    },
    "action": "Pushdata.order", #구독 유형
    "data": [ #data
        {
            "id": 1216814315, #id
            "t": "21:04:10", #시간
            "T": 1562159050, #타임 스탬프
            "p": "0.1599", #가격
            "n": "2185.0000", #수량
            "s": "sell" # 방향 판매 : 구매 판매 : 구매
        }
    ],
    "time": 1562159051901, #메시지 시간
    "source": "sub-api" #발송원
}

c) depth 심도 정보:

{
    "msgId": 0, #메시지 ID
    "params": { #파라미터
        "symbol": "bz_usdt" #거래페어 명
    },
    "action": "Pushdata.depth", #구독 유형
    "data": { #data
        "asks": [ # 위원회 지시 : asks: 판매하다、bids:구매
            [
                "0.1586", #가격
                "616.4175", #수량
                "97.7638" #합계
            ]
        ]
    },
    "time": 1562159910917, #메시지 시간
    "source": "sub-api" #발송원
}

d) kline k 라인 정보:

{
    "msgId": 0, #메시지 ID
    "params": { #파라미터
        "symbol": "bz_usdt", #거래페어 명
        "resolution": "60min" #k 라인 타입
    },
    "action": "Pushdata.kline", #구독 유형
    "data": { #data
        "bars": [ # k 라인을 포함하는 목록
            {
                "time": "1562155200000", #밀리초 타임스탬프
                "open": "0.1609", #개장가
                "high": "0.1635", #최고가
                "low": "0.1575", #최저가
                "close": "0.1603", #종가
                "volume": "1288739.3374", #거래량
                "datetime": "2019-07-03 20:00:00" #k 라인 타임
            }
        ],
        "resolution": "60min", #k 라인 타입
        "symbol": "bz_usdt", # k 라인 거래페어 명
        "from": "1562155200000", #시작 시간
        "to": "1562151600000", #종료 시간
        "size": 1 #k 라인 총수
    },
    "time": 1562156715923, #메시지 시간
    "source": "sub-api" #발송원
}

오류 알림:

  • -101001 구독 유형 type 매개 변수 오류
  • -101002 구독 거래 페어 symbol 획득 실패
  • -101003 K 라인 스케일 resolution 오류

results matching ""

    No results matching ""