API 소개

Conviction 의 공개 인터페이스는 REST 입니다. 모든 공개 라우트는 /v1/ 으로 시작합니다.

#베이스 URL

https://api.conviction.bet

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

#경로 prefix

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

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

/v1/ 으로 시작하지 않는 엔드포인트 (사용자 인증, 입금, 관리자, 웹훅 등) 는 외부에 공개되지 않습니다.

#무엇을 다루나

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

• 공개 시장 데이터 (인증 불필요) — 시장 목록 / 상세, 호가창(orderbook), 시계열 가격(price history). 누구나 호출할 수 있습니다. REST → Markets 참고.
• 프로그램 주문 서명 — UI 없이 직접 호가를 올리려는 봇·마켓 메이커를 위한 EIP-712 주문 구조. EIP-712 주문 서명 참고.

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

#요청 형식

• 모든 본문은 JSON (Content-Type: application/json).
• 시각은 ISO-8601 또는 unix seconds (각 엔드포인트가 명시).

#응답 형식

성공 응답은 엔드포인트별 스펙에 따른 JSON. 실패 응답은 표준 에러 envelope.

#다음

• 인증 — 공개 엔드포인트는 인증이 필요 없습니다
• 에러 — 응답 envelope, validation message 배열
• 페이지네이션 — 모든 list 엔드포인트 공통
• REST → Markets — 공개 시장 데이터 엔드포인트
• EIP-712 주문 서명 — 프로그램으로 주문을 만드는 봇·마켓 메이커용