API 엔드포인트

모든 API 요청은 다음 API 엔드포인트로 해야 합니다:

https://api.cryptohopper.com/v1/

지원되는 요청 메서드

요청 파라미터

API에서 사용하는 네 가지 매개변수 유형이 있습니다: 경로, 쿼리 문자열, 헤더 및 요청 본문 매개변수입니다. 요청 본문 매개변수는 POST 및 PATCH 요청의 JSON 요청 본문에 게시된 데이터입니다. 헤더 매개변수는 당연히 헤더에 게시해야 하는 매개변수입니다. 헤더, 경로 및 쿼리 문자열 매개변수에 대한 자세한 내용은 아래에서 확인할 수 있습니다.

헤더 파라미터

우리 API에 대한 모든 요청은 헤더에 다음 값들을 포스팅하여 인증해야 합니다.

• access-token - OAuth2 인증으로 받은 접근 토큰입니다.

경로 매개변수

이들은 엔드포인트의 URI에 제공되는 매개변수입니다. 예를 들어 GET Hopper 엔드포인트:

https://api.cryptohopper.com/v1/hopper/{hopper_id}

트레이딩봇을 고유 ID로 검색하려면 {hopper_id} 자리에 해당 ID 값을 넣어야 해. 예를 들어, ID가 37인 트레이딩봇을 가져오려면 다음 URL을 요청해야 해:

https://api.cryptohopper.com/v1/hopper/37

일부 엔드포인트는 여러 매개변수가 필요합니다. 예를 들어 이전 혹퍼에서 특정 주문을 반환하려면 다음 URL을 호출해야 합니다.

https://api.cryptohopper.com/v1//hopper/{hopperId}/order/{orderId}

그리고 호퍼와 주문 ID를 매개변수로 바꿔주면:

https://api.cryptohopper.com/v1//hopper/37/order/231

각 API 엔드포인트에서 필요한 매개변수의 자세한 목록은 API 참조 가이드를 참고하세요.

쿼리 문자열 매개변수

이러한 종류의 매개변수는 데이터 필터링 및/또는 페이징을 위한 GET 요청에 사용합니다. 이러한 매개변수는 경로에 명시되지 않고 URL 문자열에서 ‘&’ 문자로 구분된 값 세트로 지정됩니다.

예를 들어, 거래 로봇의 비트코인 매수 주문을 가져오려면, Hopper 주문 엔드포인트를 다음과 같이 호출할 수 있습니다.

https://api.cryptohopper.com/v1/hopper/37/order/?order_type=buy&coin=btc
        

API 참조를 보면, 이 경우 order_type 매개변수는 ‘buy’ 또는 ‘sell’ 값을 가질 수 있으며, coin 매개변수는 모든 소문자 암호화폐 코인 코드일 수 있습니다.

응답 형식

모든 응답은 JSON 객체 형식으로 제공됩니다. 따라서 모든 응답에서 볼 수 있는 MIME 종류는 application/json입니다. 각 요청 및 응답 본문의 구체적인 JSON 응답 형식은 API 참조 문서를 참고하세요.

HTTP 응답 코드

우리는 RFC 2616 및 RFC 6585 표준에서 정의된 응답 상태 코드를 활용합니다..

HTTP 에러 코드

오류 메시지

API가 에러 코드를 반환할 때마다, 에러 설명이 담긴 JSON 객체를 본문에 붙입니다. 에러 메시지는 다음과 같습니다.

{
            "status": 400,
            "error": 1,
            "message": "Missing required request parameters: [access_token]"
        }
        

요금 제한

저희 API는 모든 사용자에게 밴드위스 자원을 공평하게 제공하기 위해 요청 속도 제한을 두고 있습니다. 현재 제한은 1초에 사용자당 2개의 요청이며, 매수 주문 시에는 제한이 8초에 1개의 주문으로 낮아집니다.

초당 허용 요청 수를 초과하면 429 에러 응답 코드가 반환됩니다. 응답에 포함된 Retry-After 헤더를 확인하여 다음 요청을 보낼 수 있기까지 기다려야 하는 시간을 확인하세요.