Skip to main content

소개

Conviction Public API는 BNB 스마트 체인 (BSC) 기반 예측 시장 데이터에 대한 프로그래밍 방식의 접근을 제공합니다. 시장 정보, 확률, 오더북 데이터, 가격 히스토리를 조회할 수 있습니다.

#기본 URL

모든 API 요청은 다음 주소로 보내야 합니다:

https://api.conviction.bet/v1

#응답 형식

모든 엔드포인트는 JSON 응답을 반환합니다. 성공 응답은 데이터를 직접 포함합니다:

{
  "markets": [...],
  "total": 42,
  "limit": 20,
  "offset": 0
}

오류 응답은 표준 오류 형식을 반환합니다:

{
  "statusCode": 404,
  "message": "Market not found",
  "error": "Not Found"
}

#사용 가능한 엔드포인트

엔드포인트설명
GET /v1/markets마켓 목록 조회 (필터링 및 페이지네이션)
GET /v1/markets/:idUUID로 마켓 상세 정보 조회
GET /v1/markets/slug/:slugSlug로 마켓 상세 정보 조회
GET /v1/markets/:id/orderbook특정 아웃컴의 현재 오더북 조회
GET /v1/markets/slug/:slug/orderbookSlug로 현재 오더북 조회
GET /v1/markets/:id/prices-history특정 아웃컴의 가격 히스토리 조회
GET /v1/markets/slug/:slug/prices-historySlug로 가격 히스토리 조회

#데이터 규칙

  • 가격은 소수점 문자열로 표시됩니다 (예: "0.670" = 67% 확률)
  • 거래량은 USDT 단위이며 소수점 2자리입니다 (예: "1250.00")
  • 타임스탬프는 ISO 8601 형식입니다 (예: "2026-01-15T00:00:00Z")
  • 페이지네이션limitoffset 파라미터를 사용합니다
이 페이지가 도움이 되었나요?