Skip to main content
앱으로 돌아가기

가격 히스토리 조회

GET/v1/markets/:id/prices-historyPublic

특정 아웃컴의 과거 가격 데이터를 조회합니다. Polymarket 호환 형식으로 Unix 타임스탬프와 설정 가능한 정밀도를 사용합니다.

#경로 파라미터

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

#쿼리 파라미터

파라미터타입필수기본값설명
outcomeIdstring예—가격 히스토리를 조회할 아웃컴 ID
startTsnumber아니오1주 전시작 Unix 타임스탬프 (초)
endTsnumber아니오현재 시간종료 Unix 타임스탬프 (초)
fidelitynumber아니오1데이터 정밀도 (분). 값이 클수록 데이터 포인트가 적어집니다.

#응답

{
  "history": [
    { "t": 1710000000, "p": 0.67 },
    { "t": 1710000300, "p": 0.68 },
    { "t": 1710000600, "p": 0.665 }
  ]
}

#응답 필드

필드타입설명
historyarray가격 포인트 배열
history[].tnumberUnix 타임스탬프 (초)
history[].pnumber해당 간격의 종가 (0-1)

#참고사항

  • 가격 데이터는 체결 및 부분 체결된 주문에서 생성됩니다
  • 각 데이터 포인트는 정밀도 간격 내의 종가를 나타냅니다
  • 정밀도 값이 높을수록 더 적고 집계된 데이터 포인트가 생성됩니다
  • fidelity=5로 5분봉, fidelity=60으로 시간봉 등을 얻을 수 있습니다

#오류

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

#Slug 기반 대안

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

GET /v1/markets/slug/:slug/prices-history

자세한 내용은 Slug로 가격 히스토리 조회를 참조하세요.

#예제

#최근 24시간, 5분 정밀도

curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/prices-history?outcomeId=outcome-uuid-1&startTs=1709913600&endTs=1710000000&fidelity=5"

#최근 1주, 기본 정밀도

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