BitCo API 정보 01

BitCo REST & 스트리밍 API 버전 2.0은 BitCo의 차세대 트레이딩 엔진에 프로그래밍 방식의 액세스를 제공한다. 우리는 새로운 고객들이 최고의 거래 경험을 얻기 위해 API 버전 2.0을 사용할 것을 강력히 추천한다. 우리는 또한 우리의 현재 거래자들이 최신 버전 2.0으로 바꿀 것을 권고한다. BitCo API를 사용하여 API 사용권 계약을 읽고 동의했는지 확인하십시오.

개발 가이드

API 탐색기

Swager를 사용하여 API를 탐색할 수 있음+인증이 필요한 메서드를 포함한 UI.

API URL

쉬다 http://api.bit10api.com/api/2
스트리밍 시장 데이터 wss:///api.bit10api.com/api/2/ws/public
스트리밍 트레이딩 wss:///api.bit10api.com/api/2/ws/trading
스트리밍 계정 wss:///api.bit10api.com/api/2/ws/account
BitCo REST 및 Streaming API 버전 2.0은 BitCo의 차세대 거래 엔진에 대한 프로그래밍 방식 액세스를 제공합니다.
신규 고객은 최고의 거래 경험을 얻기 위해 API 버전 2.0을 사용하는 것이 좋습니다. 또한 현재 트레이더는 최신 버전 2.0으로 전환 할 것을 권장합니다.

날짜 시간 형식

모든 타임스탬프는 ISO 8601 형식(UTC)으로 반환된다. 예: "2017-04-03T10:20:49.315Z"

숫자 형식

모든 재무 데이터(예: 가격, 수량, 수수료 등)는 임의의 정밀도 번호여야 하며 문자열 표시가 있어야 한다. 예: "10.20058"

페이지 지정

매개 변수:
매개 변수 설명
제한 통화당 결과 수
허용 범위: 0 - 1000
기본값: 100
오프셋 결과 오프셋 수
기본값: 0
종류 정렬 방향
허용 값: ASC (순서 변경), DESC (순서 변경)
기본값: DESC
에 의해 필터 유형 정의
허용 값: id, timestamp
에서 간격 초기 값(옵션 매개 변수)
필터링 기준인 경우 timestamp 사용된 다음 매개 변수 유형은 datetime, 그렇지 않으면 object id
까지 간격 끝 값(옵션 매개 변수)
필터링 기준인 경우 timestamp 사용된 다음 매개 변수 유형은 datetime, 그렇지 않으면 object id

요금 제한

다음과 같은 속도 제한이 적용된다.
  • 200 OK. 성공적 요청
  • 400 잘못된 요청. 오류 메시지와 함께 JSON 반환
  • 401 허가되지 않음. 인증이 필요하거나 실패함
  • 403 금지됨. API 키에 대한 작업이 금지됨
  • 429개의 요청이 너무 많음. 연결 속도가 제한됨
  • 500 내부 서버. 내부 서버 오류
  • 503 서비스를 사용할 수 없음. 유지보수를 위해 서비스가 중단됨
  • 504 게이트웨이 시간 초과. 요청 시간 초과 만료
요율 제한을 현저히 초과하면 정지로 이어질 수 있다.

모범 사례

BitCo API 개발팀은 API 사용자에게 최고의 거래 경험을 제공하기 위해 노력한다. 이 설명서에는 API를 최대한 효율적으로 사용하기 위한 모범 사례들이 수록되어 있다.

HTTP 영구 연결

기본 TCP 연결은 여러 요청/응답에 대해 활성 상태로 유지된다. 후속 요청은 TCP 핸드셰이킹 프로세스가 더 이상 필요하지 않기 때문에 지연 시간을 줄일 수 있다. HTTP 1.0 클라이언트를 사용하는 경우 클라이언트가 Keep-Alive 명령을 지원하는지 확인하고 ''Connection:'을 제출하십시오. 요청과 함께 '계속-알리브' 헤더. Keep-Alive는 HTTP 1.1 프로토콜의 일부로서 준수 클라이언트에서 기본적으로 활성화된다. 그러나 다른 값을 연결 헤더로 설정하지 않도록 해야 한다.

계정 상태 검색 및 업데이트

주문, 거래 및 트랜잭션 변경사항의 실시간 업데이트를 위해 스트리밍 API를 사용하십시오.

REST API 참조서

HTTP 상태 코드

  • 200 OK. 성공적 요청
  • 400 잘못된 요청. 오류 메시지와 함께 JSON 반환
  • 401 허가되지 않음. 인증이 필요하거나 실패함
  • 403 금지됨. API 키에 대한 작업이 금지됨
  • 429개의 요청이 너무 많음. 연결 속도가 제한됨
  • 500 내부 서버. 내부 서버 오류
  • 503 서비스를 사용할 수 없음. 유지보수를 위해 서비스가 중단됨
  • 504 게이트웨이 시간 초과. 요청 시간 초과 만료

오류 응답

모든 오류 응답에 오류가 있음 code 그리고 인간이 읽을 수 있는 message 필드입니다. 일부 오류에는 추가 오류가 포함됨 description 분야이다. 오류 응답의 예:
{
"error" : {
"code" : 20001 ,
"message" : "Insufficient funds" ,
"description" : "Check that the funds are sufficient, given commissions"
}
}

시장자료

통화

모든 통화 또는 지정된 통화 목록 가져오기 GET /api/2/public/currency 사용 가능한 통화, 토큰 등의 실제 목록을 반환하십시오. 선택적으로 쉼표로 구분된 통화 목록을 사용할 수 있다. null이거나 비어 있지 않은 경우 요청은 모든 통화를 반환한다. API 키 액세스 권한이 필요하지 않음 매개 변수:
이름 형식 설명
통화 String 쉼표로 구분된 통화 코드 목록. 선택적 매개 변수
응답:
이름 형식 설명
이드 String 통화 식별자(코드)(예: ''BTC'')
참고: 설명은 단순히 currency 미래에
fullName String 통화 전체 이름(예: "비트코인")
crypto Boolean 통화가 블록체인에 속하는지 여부 결정)
payinEnabled Boolean 입금에 대한 주소 생성 허용 여부 결정
지불 확인 번호 입금에 필요한 블록 확인 수
payoutEnabled Boolean 인출 허용 여부 결정
payoutIsPaymentId Boolean 철회를 위한 추가 정보 제공 허용 여부 결정
transferEnabled Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
상장 폐지 Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
curl "http://api.bit10api.com/api/2/public/currency"

위 명령은 다음과 같이 구성된 JSON을 반환한다.

[
{
"id" : "BTC" ,
"fullName" : "Bitcoin" ,
"crypto" : true ,
"payinEnabled" : true ,
"payinPaymentId" : false ,
"payinConfirmations" : 2 ,
"payoutEnabled" : true ,
"payoutIsPaymentId" : false ,
"transferEnabled" : true ,
"delisted" : false ,
"payoutFee" : "0.00958" ,
"payoutMinimalAmount" : "0.00958" ,
"precisionPayout" : 10 ,
"precisionTransfer" : 10
},
{
"id" : "ETH" ,
"fullName" : "Ethereum" ,
"crypto" : true ,
"payinEnabled" : true ,
"payinPaymentId" : false ,
"payinConfirmations" : 2 ,
"payoutEnabled" : true ,
"payoutIsPaymentId" : false ,
"transferEnabled" : true ,
"delisted" : false ,
"payoutFee" : "0.001" ,
"payoutMinimalAmount" : "0.00958" ,
"precisionPayout" : 20 ,
"precisionTransfer" : 15 ,
"lowProcessingTime" : "3.518" ,
"highProcessingTime" : "2411.963" ,
"avgProcessingTime" : "247.1108947"
}
]

기호

모든 기호 또는 지정된 기호 목록 가져오기 GET /api/2/public/symbol 교환 시 거래된 통화 기호(통화 쌍)의 실제 목록을 반환하십시오. 기호의 첫 번째 상장 통화를 기준 통화라고 하고, 두 번째 통화는 견적 통화라고 한다. 통화 쌍은 기준 통화의 한 단위를 구입하는 데 필요한 견적 통화의 양을 나타낸다. 선택적으로 쉼표로 구분된 기호 목록을 사용할 수 있다. null이거나 비어 있지 않은 경우 요청은 모든 기호를 반환한다. API 키 액세스 권한이 필요하지 않음 매개 변수: 매개 변수:
이름 형식 설명
통화 String 쉼표로 구분된 통화 코드 목록. 선택적 매개 변수
응답:
이름 형식 설명
이드 String 통화 식별자(코드)(예: ''BTC'')
참고: 설명은 단순히 currency 미래에
fullName String 통화 전체 이름(예: "비트코인")
crypto Boolean 통화가 블록체인에 속하는지 여부 결정)
payinEnabled Boolean 입금에 대한 주소 생성 허용 여부 결정
지불 확인 번호 입금에 필요한 블록 확인 수
payoutEnabled Boolean 인출 허용 여부 결정
payoutIsPaymentId Boolean 철회를 위한 추가 정보 제공 허용 여부 결정
transferEnabled Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
상장 폐지 Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
curl ""http://api.bit10api.com/api/2/public/ticker""

위 명령은 다음과 같이 구성된 JSON을 반환한다.

[
{
"ask" : "0.050043" ,
"bid" : "0.050042" ,
"last" : "0.050042" ,
"open" : "0.047800" ,
"low" : "0.047052" ,
"high" : "0.051679" ,
"volume" : "36456.720" ,
"volumeQuote" : "1782.625000" ,
"timestamp" : "2017-05-12T14:57:19.999Z" ,
"symbol" : "ETHBTC"
}
]

Tickers

모든 기호 또는 지정된 기호에 대한 눈금자 가져오기 GET /api/2/public/symbol 티커 정보를 반환한다 선택적으로 쉼표로 구분된 기호 목록을 사용할 수 있다. null이거나 비어 있지 않은 경우 요청은 모든 기호에 대해 티커를 반환한다. API 키 액세스 권한이 필요하지 않음 매개 변수: 매개 변수:
이름 형식 설명
통화 String 쉼표로 구분된 통화 코드 목록. 선택적 매개 변수
응답:
이름 형식 설명
이드 String 통화 식별자(코드)(예: ''BTC'')
참고: 설명은 단순히 currency 미래에
fullName String 통화 전체 이름(예: "비트코인")
crypto Boolean 통화가 블록체인에 속하는지 여부 결정)
payinEnabled Boolean 입금에 대한 주소 생성 허용 여부 결정
지불 확인 번호 입금에 필요한 블록 확인 수
payoutEnabled Boolean 인출 허용 여부 결정
payoutIsPaymentId Boolean 철회를 위한 추가 정보 제공 허용 여부 결정
transferEnabled Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
상장 폐지 Boolean 철거래 계좌와 은행 계좌 간의 이체 허용 여부 결정(유지보수 시 비활성화 가능)
curl ""http://api.bit10api.com/api/2/public/ticker""

위 명령은 다음과 같이 구성된 JSON을 반환한다.

[
{
"ask" : "0.050043" ,
"bid" : "0.050042" ,
"last" : "0.050042" ,
"open" : "0.047800" ,
"low" : "0.047052" ,
"high" : "0.051679" ,
"volume" : "36456.720" ,
"volumeQuote" : "1782.625000" ,
"timestamp" : "2017-05-12T14:57:19.999Z" ,
"symbol" : "ETHBTC"
}
]