Skip to main content
앱으로 돌아가기

API 소개

Conviction 의 공개 인터페이스는 REST 이며, 현재는 읽기 전용 입니다. 모든 공개 라우트는 /v1/ 으로 시작합니다.

#베이스 URL

https://api.conviction.bet

본 문서의 모든 예시는 이 URL 을 기준으로 합니다.

#경로 prefix

공개 라우트는 모두 /v1/... 로 시작합니다.

GET https://api.conviction.bet/v1/markets?status=ACTIVE

이 호스트의 그 밖의 라우트(로그인, 입금, 주문 제출, 관리자, 웹훅 등)는 공개 API 가 아닙니다. 인증이 필요하거나 내부용이고, 여기에 문서화하지 않으며, 예고 없이 바뀔 수 있습니다.

#무엇을 다루나

이 레퍼런스는 개발자·봇·마켓 메이커를 위한 두 가지를 다룹니다.

  • 공개 시장 데이터 (인증 불필요) — 시장 목록 / 상세, 호가창(orderbook), 시계열 가격(price history). 누구나 호출할 수 있습니다. REST → Markets 참고.
  • EIP-712 서명 도메인 — 주문이 서명되는 도메인을 참고용으로 공개합니다. EIP-712 서명 도메인 참고.

API 를 통한 주문 제출은 아직 열려 있지 않습니다. 쓰기 엔드포인트는 계정에서 API 키를 발급할 수 있게 된 뒤 봇·마켓 메이커에게 순차적으로 열 예정입니다.

일반 사용자는 이 레퍼런스가 필요 없습니다 — UI 가 모든 과정을 처리합니다.

#요청 형식

  • 공개 엔드포인트는 모두 GET 이며 경로·쿼리 파라미터만 받습니다 — 요청 본문이 없습니다.
  • 응답의 시각은 ISO-8601 문자열입니다. 시계열 가격 엔드포인트만 예외로, unix seconds 를 받고 반환합니다.

#응답 형식

성공 응답은 엔드포인트별 스펙에 따른 JSON 이며 키는 snake_case 입니다. 실패 응답은 표준 에러 envelope.

#다음

이 페이지가 도움이 되었나요?