지원 마켓

PolyTest API로 이용할 수 있는 자산, 타임프레임, 데이터 스키마, 데이터 이용 정책을 알아보세요.

자산 및 타임프레임

자산 6개

PolyTest는 Polymarket의 예측 시장을 자산별로 추적합니다. 각 자산은 일부 마켓 타임프레임(시작부터 결과 확정까지의 기간)을 지원합니다. 스냅샷은 모든 타임프레임에서 초당 8회 수집됩니다. API에서는 coin과 market_type으로 필터링하세요.

자산	API 파라미터	타임프레임	스냅샷 빈도
BTC Bitcoin `coin="btc"`	`coin="btc"`	5m15m1hr4hr24hr	초당 8회
ETH Ethereum `coin="eth"`	`coin="eth"`	5m15m1hr	초당 8회
SOL Solana `coin="sol"`	`coin="sol"`	5m15m1hr	초당 8회
XRP XRP 곧 지원 예정 데이터 수집 중 `coin="xrp"`	`coin="xrp"`	5m15m1hr4hr24hr	초당 8회
DOGE Dogecoin 곧 지원 예정 데이터 수집 중 `coin="doge"`	`coin="doge"`	5m15m1hr4hr24hr	초당 8회
BNB BNB 곧 지원 예정 데이터 수집 중 `coin="bnb"`	`coin="bnb"`	5m15m1hr4hr24hr	초당 8회

~마켓당 스냅샷 수 = 기간 × 8 (예: 5m ≈ 2,400, 24h ≈ 691,200).

데이터 이용 범위

데이터 이용 범위는 플랜에 따라 다릅니다. Builder(Builder 전체 기능이 포함된 3일 무료 체험 포함)는 최근 구간을 제공하고, Pro와 Enterprise는 과거 데이터에 제한 없이 접근할 수 있습니다. 범위 쿼리의 경우 각 요청은 최대 31일 구간을 지원합니다.

Builder

14일

약 14일간의 과거 마켓 및 스냅샷 데이터에 접근할 수 있습니다. 3일 무료 체험 기간에도 동일합니다.

Pro

Enterprise

무제한

과거 데이터 전체 접근에 더해 맞춤 데이터 이용 정책과 대량 내보내기를 제공합니다.

최대 데이터 구간: start_time부터 end_time까지의 범위는 최대 31일입니다. 31일이 지난 데이터는 삭제됩니다.

마켓 객체 스키마

API가 반환하는 모든 마켓에는 다음 필드가 포함됩니다.

필드	타입	설명
`market_id`	`string`	마켓의 고유 숫자 식별자
`event_id`	`string`	Polymarket의 상위 이벤트 ID
`slug`	`string`	사람이 읽을 수 있는 URL 슬러그 (예: btc-updown-5m-1772689200)
`market_type`	`string`	기간 유형: 5m \| 15m \| 1h \| 4h \| 24h
`coin`	`string`	암호화폐: btc \| eth \| sol \| xrp \| doge \| bnb
`start_time`	`ISO 8601`	마켓 거래가 시작된 시각
`end_time`	`ISO 8601`	마켓 결과가 확정된 시각
`price_start`	`number`	마켓 시작 시점의 자산 현물 가격
`price_end`	`number \| null`	마켓 종료 시점의 자산 현물 가격 (미확정 시 null)
`winner`	`string \| null`	결과: "Up" 또는 "Down" (미확정 시 null)
`final_volume`	`number`	마켓의 총 거래량
`final_liquidity`	`number`	마켓 종료 시점의 총 유동성
`condition_id`	`string`	온체인 condition 식별자
`clob_token_up`	`string`	"Up" 결과의 CLOB 토큰 ID
`clob_token_down`	`string`	"Down" 결과의 CLOB 토큰 ID
`resolved_at`	`ISO 8601 \| null`	마켓 결과 확정 타임스탬프
`created_at`	`ISO 8601`	PolyTest에 레코드가 생성된 시각
`updated_at`	`ISO 8601`	마지막 업데이트 타임스탬프

스냅샷 객체 스키마

스냅샷은 가격, 확률, 선택적 오더북 깊이를 포함해 특정 시점의 마켓 상태를 담습니다.

필드	타입	설명
`id`	`integer`	고유 행 식별자
`market_id`	`string`	상위 마켓 ID (외래 키)
`time`	`ISO 8601`	이 스냅샷의 타임스탬프
`spot_price`	`number \| null`	스냅샷 시점의 자산 현물 가격
`price_up`	`number \| null`	"Up" 결과의 확률 (0.00–1.00)
`price_down`	`number \| null`	"Down" 결과의 확률 (0.00–1.00)
`orderbook_up`	`object \| null`	"Up" 토큰의 전체 오더북 (요청 시)
`orderbook_down`	`object \| null`	"Down" 토큰의 전체 오더북 (요청 시)

오더북 필드는 요청에 include_orderbook=true를 전달한 경우에만 포함됩니다. 오더북 데이터는 Builder, Pro, Enterprise 플랜에서만 이용할 수 있습니다.

마켓의 작동 방식

각 마켓은 이진 예측을 나타냅니다. 특정 암호화폐의 가격이 마켓 타임프레임 안에 Up할까요, Down할까요?

마켓 수명 주기

1마켓 시작: start_time이 설정되고 거래가 시작됩니다
2스냅샷이 초당 8회 수집됩니다: 확률 가격이 실시간으로 업데이트됩니다
3마켓 결과 확정: winner가 "Up" 또는 "Down"으로 설정됩니다
4데이터 보관: 스냅샷은 계속 API로 조회할 수 있습니다

확률 가격

price_up과 price_down은 0.00부터 1.00까지의 시장 내재 확률을 나타냅니다.

price_up = 0.65는 결과 확정 시점에 자산 가격이 더 높을 확률을 시장이 65%로 본다는 뜻입니다.

이 가격은 Polymarket 오더북에서 산출되며 스냅샷마다 업데이트됩니다.