Polymarket 트레이딩 봇 만드는 방법

Polymarket 봇은 여섯 부분으로 이루어집니다. 마켓 찾기, 가격 읽기, 결정하기, 주문 넣기, 포지션 관리하기, 살아남기. 처음 두 가지는 쉽고, 네 번째는 손이 많이 가며, 여섯 번째에서 대부분의 봇이 실제로 죽습니다. 이 가이드는 검증된 코드로 전체 과정을 따라가며, 정말 어려운 부분에 대해서는 솔직하게 말합니다.

0단계: 봇이 무엇을 거래할지 정하기

코드 한 줄을 쓰기 전에 해 둘 가치가 있습니다. 이후의 모든 것을 결정하기 때문입니다. Polymarket 마켓은 공통점이 거의 없는 두 계열로 나뉩니다:

자동화를 한다면 거의 확실히 두 번째 계열에 관심이 있을 겁니다. 빈도가 높고, 연속적이며, 코드로 옮길 수 있을 만큼 기계적입니다. 자세한 내용은 Up/Down 마켓 설명에서 다룹니다.

1단계: 최신 SDK 설치하기

두 SDK 모두 Polymarket의 모든 API에 대한 하나의 클라이언트 인터페이스, 타입이 지정된 모델, 일관된 페이지네이션, 내장 서명을 제공합니다. 직접 다시 구현하고 싶지 않은 번거로운 작업이 상당히 많이 해결됩니다.

pip install polymarket-client
# or: uv add polymarket-client / poetry add polymarket-client

Python 클라이언트는 네 가지가 있으며, 올바른 것을 고르는 일이 보기보다 중요합니다:

2단계: 마켓 찾기

공개 마켓 탐색에는 자격 증명이 전혀 필요 없습니다. SDK의 페이지네이터는 모든 목록 메서드에서 일관되므로 이 패턴은 그대로 응용할 수 있습니다.

import asyncio
from polymarket import AsyncPublicClient


async def main() -> None:
    async with AsyncPublicClient() as client:
        pages = client.list_markets(closed=False, page_size=50)

        # Iterate items directly when page boundaries do not matter.
        async for market in pages.iter_items():
            if "updown" in (market.slug or ""):
                print(market.slug, market.condition_id)


asyncio.run(main())

여기서 두 가지를 꼭 기억하세요. 첫째, page.next_cursor는 불투명한 커서입니다. 나중에 스캔을 재개하려면 그대로 저장하고, 파싱하거나 직접 만들려고 하지 마세요. 둘째, /markets는 플랫폼 전체에서 가장 엄격한 요청 한도(10초에 300회)를 가지므로, 반복 루프에서 다시 목록을 조회하지 말고 마켓 메타데이터를 캐시하세요. 전체 수치는 요청 한도 레퍼런스에 있습니다.

3단계: 인증하기

거래에는 지갑이 필요합니다. Python SDK는 로컬 개인 키로 서명자를 만듭니다:

import os
from polymarket import AsyncSecureClient

client = await AsyncSecureClient.create(
    private_key=os.environ["POLYMARKET_PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
)

내부적으로 Polymarket은 두 개의 인증 계층을 사용합니다. L1은 주소를 통제하고 있음을 증명하고 API 자격 증명을 생성하거나 파생할 수 있게 해주는 EIP-712 지갑 서명이고, L2는 그 자격 증명으로 각 비공개 요청을 HMAC-SHA256 서명합니다. SDK가 두 가지를 모두 처리하며, 이것이 SDK를 쓰는 주된 이유입니다.

4단계: 실시간 가격 받기

첫 봇에서 가장 흔한 아키텍처 실수는 타이머로 /book을 폴링하는 것입니다. 요청 한도를 소모하고, 지연 시간을 늘리며, 확장성이 나쁩니다. 대신 구독하세요. SDK가 여러 피드를 하나의 이벤트 스트림으로 합쳐 줍니다.

from polymarket.streams import MarketSpec

async with await client.subscribe([MarketSpec(token_ids=[token_id])]) as stream:
    async for event in stream:
        # MarketBookEvent | MarketPriceChangeEvent | MarketLastTradePriceEvent
        # | MarketTickSizeChangeEvent | MarketBestBidAskEvent
        # | NewMarketEvent | MarketResolvedEvent
        handle(event)

SDK 대신 원시 WebSocket에 연결한다면 10초마다 PING을 보내야 연결이 끊기지 않으며, best_bid_ask, new_market, market_resolved 이벤트를 받으려면 custom_feature_enabled: true가 필요합니다. 이 내용과 재연결 패턴은 WebSocket 가이드에서 다룹니다. 별도로, 기준 가격은 2026년 9월 15일에 PolyBolt로 이전되었습니다. 봇이 현물 가격을 스트리밍한다면 마이그레이션 가이드를 참고하세요.

5단계: 주문 넣기

시장가 주문이 동작하는 가장 간단한 방법이며, amount는 주식 수가 아니라 지출할 pUSD 금액 단위입니다:

market = await client.get_market(slug="<market-slug>")
token_id = market.outcomes.yes.token_id
assert token_id is not None

response = await client.place_market_order(
    token_id=token_id,
    side="BUY",
    amount="10",          # spend up to 10 pUSD
)

if not response.ok:
    raise RuntimeError(response.message)

# Settlement is on-chain and asynchronous — this waits for it.
hashes = await client.wait_for_order_fill_settlement(response)

지정가 주문을 걸어 둘 때는 다른 무엇보다 두 가지 규칙에 먼저 걸리게 됩니다. 가격은 마켓의 틱 그리드에 맞아야 합니다. 틱 크기는 마켓마다 다르고 마켓이 성숙하면서 좁아질 수 있으므로, 0.01이라고 가정하지 말고 마켓마다 GET /tick-size를 호출하세요. 그리고 마켓의 최소 규모보다 작은 주문은 즉시 거부됩니다. 두 경우 모두 구체적인 메시지와 함께 400으로 반환되며, 오류 레퍼런스에 정리되어 있습니다.

6단계: 전략이 통하는지 확인하기

지금까지의 내용은 모두 배관 작업이며, 배관은 쉬운 절반입니다. 어려운 질문은 전략이 돈을 버는지이고, 여기서 Polymarket 봇 개발은 암호화폐 현물 봇 개발과 크게 갈라집니다.

테스트넷이 없습니다. 샌드박스도, 데모 API도, 모의 거래 엔드포인트도 없습니다. Polymarket 문서 어디에도 이런 단어가 나오지 않습니다. 첫 실제 주문은 실제 거래 상대방과의 실제 돈 거래입니다. 네 가지 우회 방법은 Polymarket에 테스트넷이 있나요를 참고하세요.

과거 오더북도 없습니다. 마켓 결과가 확정되면 오더북은 404를 반환합니다. 약 1분에 한 포인트의 가격 시계열만 남으며, 그마저도 시작과 끝을 명시적으로 지정해 요청해야 합니다:

TOK=<token_id_of_a_resolved_market>
START=<epoch seconds the window opened>
END=$((START + 300))

curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"}   HTTP 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; interval=max returns [] for older ones

따라서 Polymarket으로는 백테스트할 수 없습니다. 마켓이 진행되는 동안 누군가 기록한 특정 시점 스냅샷이 필요합니다. PolyTest가 암호화폐 Up/Down 마켓에 대해 제공하는 것이 바로 그것입니다. 240M+개 스냅샷, 한쪽당 8단계 오더북 깊이, 1초 미만 단위 타임스탬프, 결과가 확정된 마켓 보존:

import os, requests

BASE = "https://api.polytest.io/api/v1"
H = {"X-API-Key": os.environ["POLYTEST_KEY"]}

markets = requests.get(f"{BASE}/markets",
                       params={"coin": "btc", "market_type": "5m", "limit": 50},
                       headers=H).json()["markets"]

snaps = requests.get(f"{BASE}/markets/{markets[0]['id']}/snapshots",
                     params={"include_orderbook": "true"},
                     headers=H).json()["snapshots"]


def simulate_fill(levels, qty):
    """Walk the ladder. Mid-price is not a price you can trade at."""
    filled = cost = 0.0
    for lvl in levels:
        take = min(lvl["size"], qty - filled)
        cost += take * lvl["price"]
        filled += take
        if filled >= qty:
            break
    return cost / filled if filled >= qty else None


print(simulate_fill(snaps[0]["orderbook"]["asks"], 500))

7단계: 프로덕션에서 살아남기

한 시간 동안 올바르게 거래하다가 멈춰 버리는 봇은 봇이 없는 것보다 나쁩니다. 실제로 발생하는 실패 유형을 대략 자주 발생하는 순서로 정리했습니다:

• 진입 경로보다 취소 경로를 먼저 테스트하세요. 빠져나오지 못하는 것이 들어가지 못하는 것보다 훨씬 나쁩니다.
• 노출 한도는 머릿속이 아니라 코드로 제한하세요. 엄격한 포지션 한도는 로직 버그를 무한한 손실이 아니라 작은 손실로 바꿉니다.
• 킬 스위치를 만들고 실제로 테스트하세요. 테스트하지 않은 킬 스위치는 주석에 불과합니다.
• 예약 작업에 지터를 추가하세요. 정확히 같은 초에 깨어나는 워커들은 평균 요청률을 훨씬 넘는 동시 급증을 만듭니다.
• 첫 주에는 모든 요청과 응답을 로그로 남기세요. 반드시 필요하게 되며, 나중에는 재구성할 수 없습니다.
• 메시지가 아니라 범주로 알림을 보내세요. Polymarket은 오류 문자열에 주문 ID와 가격을 넣으므로, 원시 문자열 기반 알림은 잡음일 뿐입니다.

현실적인 개발 순서

시간과 돈을 가장 적게 낭비하는 순서입니다:

1. 읽기 전용 연동을 공개 클라이언트로, 키 없이 진행합니다. 탐색, 파싱, 페이지네이션, 백오프를 검증합니다. 하루, 무료.
2. 전략을 백테스트합니다. 과거 오더북과 정직한 체결 시뮬레이션으로 진행합니다. 대부분의 아이디어가 여기서 탈락합니다. 그것이 목적입니다.
3. 실시간 모의 거래를 최소 일주일 진행합니다. 주문을 보내는 대신 의도한 주문을 로그로 남깁니다. 가동 시간, 재연결, 타이밍을 검증합니다.
4. 최소 규모로 실거래를 시작하며, 엄격한 노출 상한과 테스트된 킬 스위치를 갖춥니다.
5. 실거래 수치가 모의 거래 수치와 일치할 때만 규모를 키우세요. 차이가 난다면 체결 모델이 틀린 것입니다. 2단계로 돌아가세요.

1, 3, 4단계는 며칠이면 만들 수 있습니다. 2단계는 Polymarket이 보관하지 않는 데이터가 필요하며, 가장 확실하게 돈을 아껴주는 단계이기도 합니다. PolyTest 무료 체험을 시작하세요. 아이디어가 스프레드를 견디는지 알아보기에 충분합니다.