API가 어떻게 작동하는지

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는 액세스 토큰 하나로 앱이 보낼 수 있는 요청 수를 제한합니다: 분당 30회, 그리고 초당 최대 1회입니다. 주문 생성이나 포지션 매도는 8초에 1회, 호퍼 백테스트는 2초에 1회로 제한됩니다.

한도를 넘으면 다음 요청까지 몇 초를 기다려야 하는지 알려 주는 메시지와 함께 429 오류가 반환됩니다.

요청 한도 및 오류