Skip to main content
앱으로 돌아가기

오더북 조회

GET/v1/markets/:id/orderbookPublic

특정 아웃컴의 현재 오더북(매수/매도 호가)을 조회합니다. 교차 가능한 주문은 매칭 시뮬레이션을 통해 제거됩니다. 오더북은 통합되어 있으며, YES와 NO 양쪽의 유동성을 합산합니다.

#경로 파라미터

파라미터타입필수설명
idstring예Market UUID

#쿼리 파라미터

파라미터타입필수설명
outcomeIdstring예오더북을 조회할 아웃컴 ID

#응답

{
  "outcomeId": "outcome-uuid-1",
  "outcomeSide": "Yes - YES",
  "bids": [
    { "price": "0.650", "shares": "500.00" },
    { "price": "0.640", "shares": "300.00" },
    { "price": "0.620", "shares": "150.00" }
  ],
  "asks": [
    { "price": "0.680", "shares": "200.00" },
    { "price": "0.700", "shares": "400.00" },
    { "price": "0.750", "shares": "100.00" }
  ]
}

#응답 필드

필드타입설명
outcomeIdstring오더북이 나타내는 아웃컴 ID
outcomeSidestring아웃컴 이름과 방향의 조합 (예: Yes - YES, Trump - YES)
bidsarray매수 주문, 가격 내림차순 정렬
asksarray매도 주문, 가격 오름차순 정렬
bids[].pricestring매수 가격 (소수점 3자리)
bids[].sharesstring해당 가격 수준의 총 수량

#통합 오더북

오더북은 양쪽의 유동성을 합산합니다:

  • YES 매수 = YES 매수 주문 + NO 매도 주문 (반전 가격)
  • YES 매도 = YES 매도 주문 + NO 매수 주문 (반전 가격)

교차 가능한 주문 (매수가 >= 매도가)은 매칭 시뮬레이션을 통해 제거되어, 대기 중인 매칭이 완료된 후의 예상 상태를 반영하는 깨끗한 오더북을 제공합니다.

#오류

상태 코드설명
400outcomeId 누락 또는 아웃컴이 해당 마켓에 속하지 않음
404마켓 또는 아웃컴을 찾을 수 없음

#Slug 기반 대안

WebSocket 신호(slug 기반 채널 이름 market:{slug}:orderbook 제공)를 사용하는 경우, slug-to-UUID 매핑 유지 없이 slug 기반 엔드포인트를 사용할 수 있습니다:

GET /v1/markets/slug/:slug/orderbook

자세한 내용은 Slug로 오더북 조회를 참조하세요.

#예제

curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/orderbook?outcomeId=outcome-uuid-1"
이 페이지가 도움이 되었나요?
Edit this page on GitHub