Polymarket Up/Down 마켓 조회
btc-updown-5m-1780949100 같은 슬러그를 붙여넣으면 해당 마켓의 구간, 기준 가격, 결과, 거래량을 확인할 수 있습니다. Polymarket이 더 이상 오더북을 제공하지 않는 마켓도 포함됩니다.
예시:
슬러그 읽는 법
모든 Polymarket 암호화폐 Up/Down 마켓에는 고정되고 예측 가능한 형식의 슬러그가 있습니다. 읽는 법을 알면 검색하지 않고도 원하는 구간의 슬러그를 직접 만들 수 있습니다.
btc-updown-5m-1780949100
│ │ │ └── Unix timestamp: when the window OPENS, in UTC
│ │ └────── Timeframe: 5m | 15m | 1h | 4h | 24h
│ └───────────── Always "updown"
└───────────────── Coin: btc | eth | sol함정: API의 startDate 필드는 거래가 시작되는 시각이 아니라 마켓 객체가 생성된 시각이며, 보통 하루 이상 이릅니다. 슬러그의 타임스탬프가 실제 구간 시작 시각이고, endDate는 여기에 타임프레임을 더한 값입니다.
Polymarket이 보관하는 것
마켓의 결과가 확정되면 Polymarket은 마켓 레코드와 성긴 가격 시계열만 남기고 오더북은 삭제합니다. 정산된 마켓의 오더북을 요청하면 404가 반환됩니다. 가격 기록은 약 1분에 한 포인트 간격으로, 시작과 끝을 명시적으로 지정한 경우에만 반환됩니다:
curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"} 404
curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market
curl -s "https://clob.polymarket.com/prices-history?market=$TOK&interval=max"
# {"history":[]} for older markets위 조회가 가능한 것은 이 마켓들이 진행되는 동안 기록되었기 때문입니다. 작동 원리는 Up/Down 마켓 설명에서, 전체 결과 확정 통계는 마켓 데이터 페이지에서 확인하세요.
자주 묻는 질문
- Polymarket btc-updown-5m 마켓은 어떻게 조회하나요?
- 위 조회 창에 슬러그(예: btc-updown-5m-1780949100)를 붙여넣으세요. 거래 구간, 시작과 종료 시점의 기준 가격, 어느 쪽으로 확정되었는지, 최종 거래량을 확인할 수 있습니다. Polymarket 이벤트 URL 전체를 붙여넣어도 슬러그가 추출됩니다. 끝의 타임스탬프를 생략하면 해당 시리즈의 가장 최근 마켓이 반환됩니다.
- Polymarket Up/Down 슬러그 끝의 숫자는 무엇을 뜻하나요?
- 거래 구간이 시작되는 순간의 Unix 타임스탬프(UTC)입니다. btc-updown-5m-1780949100에서 마켓은 해당 타임스탬프에 시작해 5분 뒤에 종료됩니다. 이 값은 API의 startDate 필드와 다르다는 점에 유의하세요. startDate는 마켓 객체가 생성된 시각을 기록하며 하루 이상 이를 수 있습니다.
- 오래된 Polymarket 마켓을 찾을 수 없는 이유는 무엇인가요?
- 두 가지 이유가 있습니다. Polymarket은 확정된 마켓의 오더북에 대해 404를 반환하고, 가격 기록은 약 1분에 한 포인트만 보관합니다. PolyTest는 최근 31일간의 아카이브를 유지하므로, 31일보다 이전에 확정된 마켓은 여기에도 없습니다. 그 시점이 되면 저희가 아는 한 그 오더북은 어디에도 남아 있지 않습니다.
- 특정 Polymarket 마켓의 오더북을 받을 수 있나요?
- 네. 31일 구간 안에 있는 마켓이라면 PolyTest API로 받을 수 있습니다. 각 마켓에는 양쪽 8단계 깊이를 갖춘 1초 미만 해상도의 특정 시점 스냅샷이 있어, 현실적인 체결을 시뮬레이션하는 데 필요한 데이터를 제공합니다. Polymarket 자체 API는 확정된 마켓에 대해 이를 제공할 수 없습니다.