전체 글
가이드Polymarket API테스트트레이딩 봇

Polymarket에 테스트넷이 있나요?

짧게 답하면, 없습니다. Polymarket은 공개 테스트넷을 내놓은 적이 없고, 샌드박스 환경이나 데모 API도 없습니다. 첫 실제 주문은 실제 돈으로 실제 거래 상대방과 체결되는 진짜 주문입니다. 숙련된 개발자들이 이 문제를 어떻게 우회하는지 소개합니다.

9분 분량

직접적인 답

Polymarket에는 테스트넷이 없습니다. 샌드박스 환경도, 데모 API도, 모의 거래 엔드포인트도, 테스트 계정도 없습니다. 2026년 9월 기준으로 Polymarket 공식 문서 색인 어디에도 testnet, sandbox, demo, paper trading이라는 단어가 나오지 않습니다. 존재하는 환경은 프로덕션 CLOB 하나뿐입니다.

테스트넷이 기본인 암호화폐 거래소에서 온 사람들은 이 사실에 놀랍니다. Binance에도 있습니다. Polymarket의 가장 가까운 경쟁사인 Kalshi는 demo-api.kalshi.com에서 가짜 돈으로 프로덕션 API를 그대로 재현하는 완전한 샌드박스를 운영합니다. Polymarket에는 이에 해당하는 것이 없습니다.

그러니 실질적인 질문은 테스트넷이 어디 있나가 아니라 유일한 환경이 프로덕션일 때 전략의 위험을 어떻게 줄이나입니다. 방법은 네 가지이며, 각각 잡아내는 버그의 종류가 다릅니다. 대부분은 둘 이상이 필요합니다.

테스트넷이 없는 이유

이유를 이해해 둘 가치가 있습니다. 앞으로도 테스트넷이 나올 가능성이 낮은 이유를 설명해 주기 때문입니다. Polymarket은 Polygon에서 정산되는 온체인 오더북입니다. 테스트넷을 만들려면 API 사본만으로는 부족합니다. CTF 거래소 컨트랙트의 병렬 배포, 테스트넷 pUSD, 매칭 엔진, 그리고 양쪽에 현실적인 유동성을 갖춘 합성 오더북이 필요합니다.

가장 어려운 것은 마지막 부분입니다. 가짜 유동성을 가진 샌드박스 오더북으로는 쓸모 있는 것을 거의 배울 수 없습니다. 정말 알아야 하는 것은 주문이 실제 거래 상대방과 어떻게 상호작용하는지, 즉 무엇이 어떤 가격에 얼마의 슬리피지로 체결되는지이기 때문입니다. 테스트넷은 동작하는 연동과 함께 우위가 있다는 착각을 줍니다. 이는 아무것도 없는 것보다 더 나쁘다고 볼 수도 있습니다.

테스트넷 없이 테스트하는 네 가지 방법

방법잡아내는 것놓치는 것비용
읽기 전용 연동 테스트인증, 직렬화, 파싱, 요청 한도 처리주문 동작에 관한 모든 것무료
과거 오더북으로 백테스팅전략에 우위가 있는지, 슬리피지와 체결의 현실성실제 인프라 버그, 지연 시간, 부분 체결 경쟁 상태낮음
실시간 가격으로 모의 거래배관, 타이밍, 실시간 신호 생성실제 체결, 시장 충격, 대기열 순서무료지만 느림 (실시간으로만 가능)
최소 규모 실거래 주문모든 것을 확실하게없음. 다만 대표성이 없을 수 있는 규모에서만실제 돈

1. 주문이 아닌 모든 것을 무료로 테스트하기

봇 버그 중 의외로 많은 부분이 트레이딩과 무관합니다. 인증, 요청 서명, 시계 오차, 페이지네이션, 소수점 처리, 재연결 로직, 요청 한도 백오프 등은 모두 돈을 쓰거나 주문을 하나도 넣지 않고 프로덕션 읽기 엔드포인트로 검증할 수 있습니다.

마켓 데이터 엔드포인트는 공개되어 있고 인증이 필요 없습니다. 봇을 이 엔드포인트에 연결해 하루 동안 돌려 보면, 자본을 위험에 노출하기 전에 대부분의 연동 결함을 찾아낼 수 있습니다.

# Public, unauthenticated, safe to hammer (within rate limits).
curl -s "https://clob.polymarket.com/book?token_id=<TOKEN_ID>" | jq .

# Confirm your auth works without placing an order:
# a 200 here proves your key, secret, passphrase and clock are all correct.
curl -s "https://clob.polymarket.com/auth/api-keys" \
  -H "POLY_ADDRESS: $ADDRESS" \
  -H "POLY_SIGNATURE: $SIG" \
  -H "POLY_TIMESTAMP: $TS" \
  -H "POLY_NONCE: 0" | jq .

거래 없이 인증 검증하기

인증이 필요한 읽기 엔드포인트를 호출하는 것이 자격 증명이 동작하는지 증명하는 가장 깔끔한 방법입니다. GET /auth/api-keys가 200을 반환하면 키, 시크릿, 패스프레이즈, 시스템 시계가 모두 올바른 것입니다. 이것으로 Unauthorized/Invalid api key의 가장 흔한 원인이 제거됩니다. 나머지는 오류 레퍼런스를 참고하세요.

2. 과거 오더북으로 백테스트하기

현존하는 것 중 테스트넷에 가장 가까운 방법이며, 어떤 테스트넷도 답할 수 없는 질문에 답합니다. 이 전략이 실제로 돈을 버는가?

문제는 Polymarket 자체 API로는 이 데이터를 얻을 수 없다는 점입니다. API는 오더북의 현재 상태만 제공합니다. 과거 깊이 아카이브가 없고, 마켓 결과가 확정되면 오더북은 404를 반환합니다. 어떤 요청 한도 등급이나 어떤 플랜으로도, 지난 화요일 14:03:17의 오더북 모습을 API로 재구성할 수 없습니다.

따라서 백테스팅에는 마켓이 진행되는 동안 누군가 기록해 둔 특정 시점 스냅샷이 필요합니다. 그것이 PolyTest가 하는 일입니다. Polymarket 암호화폐 Up/Down 마켓의 240M+개 스냅샷을 양쪽 8단계 오더북 깊이, 1초 미만 단위 타임스탬프와 함께 제공하며, 결과가 확정된 마켓도 버리지 않고 보존합니다.

# List recent BTC 5-minute Up/Down markets
curl -H "X-API-Key: $POLYTEST_KEY" \
  "https://api.polytest.io/api/v1/markets?coin=btc&market_type=5m&limit=20"

# Replay one market's book, snapshot by snapshot
curl -H "X-API-Key: $POLYTEST_KEY" \
  "https://api.polytest.io/api/v1/markets/$MARKET_ID/snapshots?include_orderbook=true"

백테스트를 무의미하게 만드는 실수

중간가로 백테스트한다면 전략을 테스트하는 것이 아니라 산술 항등식을 테스트하는 것입니다. Polymarket Up/Down 스프레드는 보통 2–5센트로, 대부분의 전략이 주장하는 우위에 비해 엄청나게 큽니다. 실제 오더북 단계를 따라가며 실제로 받았을 체결을 반영하세요. 그 과정을 견디는 전략은 모의 거래해 볼 가치가 있고, 견디지 못하는 전략은 애초에 실체가 없었던 것입니다.

3. 실시간 가격으로 모의 거래하기

백테스팅은 과거에 우위가 있었음을 증명합니다. 모의 거래는 봇이 지금 동작한다는 것, 즉 재연결하고, 429를 처리하고, 시계를 올바르게 읽고, 실제 조건에서 실시간으로 신호를 생성한다는 것을 증명합니다.

Polymarket에는 이를 위한 엔드포인트가 없으므로 직접 만들어야 합니다. 실전 전략 루프를 프로덕션 마켓 데이터에 대해 실행하되, POST /order를 호출하는 대신 의도한 주문을 그 순간의 오더북 상태와 함께 로그에 기록하세요. 그런 다음 오더북이 이후 어떻게 움직였는지와 비교해 평가합니다.

// A paper-trading shim: identical interface, no capital at risk.
interface OrderIntent {
  tokenId: string;
  side: "BUY" | "SELL";
  price: number;
  size: number;
}

class PaperExecutor {
  readonly fills: Array<OrderIntent & { at: number; bookTop: number }> = [];

  async submit(intent: OrderIntent, book: { asks: { price: number; size: number }[] }) {
    // Record what the book actually looked like at decision time —
    // this is what lets you mark the trade honestly afterwards.
    this.fills.push({ ...intent, at: Date.now(), bookTop: book.asks[0].price });
  }
}

// Swap this for the real CLOB client only once the numbers look right.
const executor = new PaperExecutor();

한계는 분명하고 피할 수 없습니다. 모의 체결은 체결되었다고 가정합니다. 이 방식으로는 대기열 순서나 시장 충격을 배울 수 없습니다. 하지만 봇이 일주일 동안 중단 없이 버티는지는 알 수 있으며, 이는 별개이면서도 똑같이 필요한 일입니다.

4. 작게 실거래 시작하기

결국에는 실제 주문을 넣어야 하며, 솔직히 말하면 이것이 진짜 테스트이고 그 전의 모든 것은 리허설입니다. 신중하게 하세요. 최소 규모, 단일 마켓, 엄격한 포지션 상한, 그리고 실제로 테스트해 본 킬 스위치를 갖추세요.

  • 의도한 규모가 아니라 마켓 최소 규모로 시작하세요.
  • 총 노출 한도는 머릿속이 아니라 코드로 제한하세요.
  • 진입 경로보다 취소 경로를 먼저 테스트하세요. 빠져나오지 못하는 것이 들어가지 못하는 것보다 나쁩니다.
  • 503 cancel-only 모드를 명시적으로 처리하세요. 취소하기 전에 재호가하는 봇은 포지션을 정리하지 못하고 루프에 빠질 수 있습니다.
  • 첫 주에는 모든 요청과 응답을 로그로 남기세요. 반드시 필요하게 됩니다.

Polymarket US는 어떤가요?

미국 대상 규제 법인인 Polymarket US는 별개의 문제입니다. 자격을 갖춘 연동 파트너에게 온보딩의 일부로 샌드박스 환경 접근을 제공해 왔으며, 그 후 프로덕션 자격 증명이 발급됩니다. 이는 셀프서비스 테스트넷이 아니라 승인된 파트너를 위한 상업적 온보딩 절차입니다. 오늘 오후에 가입해서 바로 쓸 수 있는 것이 아니며, 메인 국제 CLOB을 대상으로 개발하는 사람에게는 도움이 되지 않습니다.

효과가 검증된 테스트 순서

  1. 읽기 전용 연동 테스트를 프로덕션 마켓 데이터로 진행합니다. 인증, 파싱, 백오프를 검증합니다. 무료, 하루.
  2. 과거 오더북으로 백테스트하며 현실적인 체결 시뮬레이션을 적용합니다. 우위가 존재하고 스프레드를 견디는지 검증합니다. 대부분의 전략이 여기서 탈락합니다. 돈을 쓰고 탈락하는 것보다 여기서 탈락하는 편이 낫습니다.
  3. 실시간 모의 거래를 최소 일주일 진행합니다. 봇이 운영상 견고한지 검증합니다. 가동 시간, 재연결, 요청 한도, 시계.
  4. 최소 규모로 실거래를 시작하며, 엄격한 노출 상한과 테스트된 킬 스위치를 갖춥니다.
  5. 실거래 수치가 모의 거래 수치와 일치한 뒤에만 규모를 키우세요. 차이가 난다면 체결 모델이 틀린 것입니다. 2단계로 돌아가세요.

1, 3, 4단계는 며칠이면 직접 만들 수 있습니다. 2단계는 Polymarket에서 얻을 수 없는 데이터가 필요한 단계이자, 사람들의 돈을 가장 자주 아껴주는 단계입니다. PolyTest 무료 체험을 시작하세요. 아이디어가 통하는지 확인하는 데 3일이면 충분합니다.

자주 묻는 질문

Polymarket에 테스트넷이 있나요?
없습니다. Polymarket에는 공개 테스트넷, 샌드박스, 데모 API, 테스트 계정이 없습니다. 2026년 9월 기준으로 Polymarket 공식 문서 어디에도 testnet, sandbox, demo, paper trading이라는 용어가 나오지 않습니다. 이용할 수 있는 환경은 프로덕션 CLOB뿐이므로, 첫 실제 주문은 실제 돈으로 이루어집니다.
개발자용 Polymarket 샌드박스나 데모 API가 있나요?
셀프서비스 샌드박스는 없습니다. Polymarket US는 상업적 온보딩의 일부로 자격을 갖춘 연동 파트너에게 샌드박스 환경을 제공해 왔지만, 이는 공개 테스트 환경이 아니라 승인이 필요한 절차이며 메인 국제 CLOB API에는 적용되지 않습니다.
돈을 걸지 않고 Polymarket 트레이딩 봇을 테스트하려면 어떻게 해야 하나요?
세 단계를 활용하세요. 첫째, 주문이 아닌 모든 것(인증, 파싱, 요청 한도 처리)을 프로덕션 읽기 엔드포인트로 연동 테스트합니다. 무료입니다. 둘째, 현실적인 체결 시뮬레이션과 함께 과거 오더북 스냅샷으로 전략을 백테스트합니다. 셋째, 주문을 제출하는 대신 의도한 주문을 로그로 남기며 실시간 가격으로 모의 거래합니다. 그 다음에야 최소 규모로 실거래를 시작하세요.
백테스트에 쓸 Polymarket 과거 데이터를 구할 수 있나요?
Polymarket 자체 API로는 불가능합니다. 이 API는 현재 마켓 상태만 제공하며 결과가 확정된 마켓의 오더북에 대해서는 404를 반환합니다. 마켓이 진행되는 동안 기록된 특정 시점 스냅샷이 필요합니다. PolyTest는 Polymarket 암호화폐 Up/Down 마켓의 그런 스냅샷 240M+개를 8단계 오더북 깊이와 1초 미만 단위 타임스탬프와 함께 제공하며, 결과가 확정된 마켓도 포함합니다.
Polymarket에는 없는 테스트넷이 Kalshi에는 있나요?
네. Kalshi는 demo-api.kalshi.com에서 모의 자금으로 프로덕션 API를 그대로 재현하는 완전한 샌드박스를 운영합니다. 두 플랫폼에서 개발할 때 가장 뚜렷한 실질적 차이 중 하나이며, Polymarket 개발자들이 백테스팅과 모의 거래에 훨씬 더 많이 의존하는 이유이기도 합니다.

Polymarket이 보관하지 않는 과거 데이터를 확보하세요

PolyTest는 Polymarket 암호화폐 Up/Down 마켓을 실시간으로 기록합니다. 8단계 오더북 깊이와 1초 미만 단위 타임스탬프를 갖춘 240M+개의 스냅샷을 제공하며, 결과가 확정된 마켓도 보존합니다. 3일 무료 체험으로 시작하세요.

더 읽어보기