1 minute read

메이져 거래소 OPEN API 제공 데이터

공통 제공 Public 데이터

  • 가상자산 거래 체결 완료 내역

  • 가상자산 현재가 정보(Ticker)

  • 가상자산 현재가 정보(Orderbook)

  • 가상 자산의 입/출금 현황 정보

  • 시간 및 구간 별 거래소 가상자산 가격, 거래량 정보

공통 제공 Private 데이터

  • 회원의 및 코인 거래 수수료 정보

  • 회원의 보유한 자산 리스트

  • 회원의 코인 입금 지갑 주소

  • 회원의 가상자산 거래 정보

  • 회원의 매수/매도 등록 대기 또는 거래 중 내역 정보

  • 회원의 매수/매도 체결 내역 상세 정보

  • 회원의 거래 완료 내역 정보

  • 주문 가능 정보

  • 지정가 매수/매도 등록 기능

  • 시장가 매수/매도 등록 기능

  • 코인 입/출금

  • 원화 입/출금

Rate Limits (요청 제한)

bithumb

Public

  • 1초당 최대 135회 요청 가능

Private

  • 1초당 최대 135회 요청 가능

upbit

주문
  • 초당 8회, 분당 200회
주문 외 API
  • 초당 30회, 분당 900회

Gopax

  • 1초의 구간 안에서 최대 20번의 API

OPEN API 설계시 고려 사항

1. API 스펙(EndPoint) 정의

2. Public Key, Private Key 암호화 방식





Endpoint 고려 사항 및 에러처리

API Design Rules.

1. 기본 URL에는 동사가 아닌 명사를 사용, 리소스마다 2개의 기본 URL을 유지

2. 복수형 명사와 구체적인 이름을 사용

3. 자원 간의 관계를 간단히 하여 URL 계층이 깊어지는 것 지양

4. 오류 처리를 명확

5. 접두사 “V”로 버전을 지정하고 지속적인 버전 관리

6. 데이터베이스에 없는 자원에 대한 응답일 경우 동사를 사용

에러 코드 정의 - HTTP Status Code

400 (요청변수) : 필수 요청 변수가 빠졌거나 요청변수 이름이 잘못되었을 경우나 요청 변수 값을 URL 인코딩하지 않고 전송하였을 경우

401 (인증실패) : 애플리케이션 클라이언트 아이디와 시크릿 값이 없거나 잘못되었을 경우

401 (인증실패) : 클라이언트 아이디와 시크릿 값을 HTTP 헤더에 정확히 설정하지 않고 호출했을 경우

401 (인증실패) : API 권한 설정이 안되어 있을 경우

401 (인증오류) : 로그인 오픈 API를 호출할 때 접근 토큰(access_token) 값이 빠졌거나 잘못된 값 (기간 만료)을 설정하였을 경우

403 (호출금지) : https가 아닌 http로 호출하였을 경우

403 (호출금지) : 약관 동의를 하지 않고 호출할 경우 또는 권한이 없거나 비공개인 경우

404 (API없음) : API 요청 URL이 잘못되었을 경우

405 (메서드오류) : HTTP 메서드를 잘못하여 호출하였을 경우 (POST인데 GET으로 호출)

429 (한도초과) : 오픈 API를 호출할 때 일 허용량을 초과하였을 경우

500 (서버오류) : API 호출은 정상적으로 했지만, API 서버 유지보수나 시스템 오류로 인한 에러가 발생하였을 경우