Polymarket CLOB 퀀트 가이드: py-clob-client로 0% 수수료 메이커 및 고래(Whale) 카피 트레이딩봇 배포하기
완벽한 엔지니어링 가이드: Polygon L2 CLOB 자격 증명 유도, Gamma 조건 토큰 ID 조회, 고래 거래 매수/매도 알림 구독 및 가스비가 0인 EIP-712 제한가격(리밋) 주문 작성법.
초보를 위한 3분 사전 비행 체크리스트
- ✓Python 3.10+가 설치된 Windows/Mac 컴퓨터 또는 월 5달러 Ubuntu VPS
- ✓OKX Web3 Wallet 또는 MetaMask에 있는 전용 서브월렛 (절대 메인 콜드 월렛을 사용하지 마세요)
- ✓OKX/Binance를 통해 Polygon 네이티브 USDC로 $50~$200 충당 + 최초 컨트랙트 승인을 위해 약 $1 POL 필요
절대 집에서 사용하는 노트북에서 실시간 트레이딩 봇을 실행하지 마세요! 화면이 꺼지거나 Wi-Fi가 끊길 수 있기 때문입니다. RAKsmart Cloud VPS를 추천합니다: (1) OKX/Binance 및 Polygon RPC로 초저지연(밀리초 단위)을 위해 도쿄, 싱가포르, 또는 실리콘밸리를 선택하세요; (2) Docker Compose를 위해 Ubuntu 22.04 LTS (2 vCPU / 4GB RAM)를 선택하세요; (3) 전량 정적 IPv4 주소를 거래소 API 화이트리스트에 연결하세요.
VPS를 방금 구매하셨나요? SSH로 접속하고 Windows/Mac에서 명령어를 실행하는 방법 (3분 가이드)
처음 사용하는 많은 분들이 클라우드 서버를 구매한 직후, ‘터미널 명령어를 어디서 입력해야 하나요?’라고 하시는 경우가 많습니다. 아래 5단계만 따르세요:
• 서버 IPv4 주소 (예:
198.51.100.88복사)• SSH 포트: 보통
22복사이며, 제어판에 표시되는 맞춤형 보안 포트(예: 22022복사 / 62134복사)일 수도 있습니다.• 사용자 이름: Ubuntu에서는 항상
root복사입니다.• 루트 비밀번호: 초기 서버 비밀번호입니다.
powershell복사을 입력한 뒤 Enter를 누르세요.• Mac에서: Command ⌘ + Space 키를 누르고,
Terminal복사을 입력한 뒤 Enter를 누르세요.ssh -p PORT root@SERVER_IP복사를 실행하세요. (소문자 -p복사에 유의하세요. 커스텀 포트를 지정하지 않으면 Connection refused복사 오류가 발생합니다):• 표준 포트 22:
ssh -p 22 root@198.51.100.88복사• 커스텀 SSH 포트 (예:
62134복사): ssh -p 62134 root@198.51.100.88복사Are you sure you want to continue connecting (yes/no)?복사라고 묻는 질문에, 전체 단어 yes복사를 입력하고 Enter를 누르세요.• 프롬프트 2 ([!] 비밀번호를 입력해도 커서가 움직이지 않으면 어떻게 해야 하나요?!):
password:복사를 입력하라는 메시지가 뜰 때, 보안상 Linux는 모든 문자를 숨깁니다. (별표 *조차도 표시되지 않아요!) PowerShell에서 마우스 오른쪽 버튼을 클릭하거나 (Mac의 경우 Cmd + V복사를 눌러) 비밀번호를 눈에 보이지 않게 붙여넣은 후, Enter를 누르세요!root@ubuntu:~#복사로 바뀌면 클라우드 서버 안으로 들어간 것입니다! Docker, Git, Python을 설치하기 위해 다음 설정 명령어를 한 번만 붙여넣어 실행하세요:docker compose ...복사 명령어의 경우: 단순히 SSH 창에서 마우스 오른쪽 버튼으로 붙여넣고 Enter를 누르세요.• Python (
.py복사) 스크립트의 경우: nano bot.py복사를 입력하고 Enter를 누르세요 → 마우스 오른쪽 버튼으로 코드를 붙여넣으세요 → 저장하려면 Ctrl + O를 누른 뒤 Enter를 누르세요 → Ctrl + X를 눌러 종료하세요 → 노트북을 닫아도 보트가 24시간 7일 내내 계속 실행되도록 nohup python3 bot.py > bot.log 2>&1 &복사를 실행하세요!# 1. Update Ubuntu packages and install Git, Curl, and Python3
apt update -y && apt install -y curl git python3-pip python3-venv
# 2. One-line official Docker & Docker Compose installation
curl -fsSL https://get.docker.com | sh && systemctl enable --now docker
# 3. Verify Docker Compose is ready
docker compose version
import os
from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, OrderType
from py_clob_client.order_builder.constants import BUY
# 1. 初始化 Polygon 主网 (chain_id=137) CLOB 客户端
HOST = "https://clob.polymarket.com"
CHAIN_ID = 137
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"] # 仅存放于本地 .env,严禁硬编码上传 GitHub
FUNDER_ADDR = os.environ["POLY_PROXY_WALLET"] # Polymarket 代理合约钱包地址
client = ClobClient(HOST, key=PRIVATE_KEY, chain_id=CHAIN_ID, signature_type=1, funder=FUNDER_ADDR)
client.set_api_creds(client.create_or_derive_api_creds())
# 2. 半凯利公式 (Half-Kelly) 动态计算正期望值 (+EV) 下单份额
def compute_half_kelly_shares(bankroll_usdc: float, mkt_price: float, true_prob: float, max_cap: float = 0.15) -> float:
if true_prob <= mkt_price + 0.03: # 要求至少 +3% Alpha 安全边际才出手
return 0.0
full_kelly = (true_prob - mkt_price) / (1.0 - mkt_price)
alloc_pct = min(max_cap, 0.5 * full_kelly)
stake_usdc = bankroll_usdc * alloc_pct
return round(stake_usdc / mkt_price, 2)
# 3. 读取订单簿最优买一价并挂出 0% 手续费 Maker 限价单
TOKEN_ID = "21742633143463906290569050155826241533067272736897614950488156847949938836455"
book = client.get_order_book(TOKEN_ID)
best_bid = float(book.bids[0].price) if book.bids else 0.35
true_p = 0.52 # 来自 JEV / LLM 校准后的真实发生概率
shares = compute_half_kelly_shares(bankroll_usdc=1000.0, mkt_price=best_bid, true_prob=true_p)
if shares >= 5.0:
order_args = OrderArgs(price=best_bid, size=shares, side=BUY, token_id=TOKEN_ID)
signed_order = client.create_order(order_args)
resp = client.post_order(signed_order, OrderType.GTC)
print(f"[CLOB Maker] 挂单成功: price={best_bid:.2f} size={shares} resp={resp}")
코드와 명령어逐行, 쉬운 설명으로 풀기
| 코드 / 명령어 | 쉬운 설명 (이것이 무엇을 하는 건가요?) |
|---|---|
from py_clob_client.client import ClobClient
|
Polymarket 공식 Python SDK를 가져옵니다 (pip install py-clob-client복사). |
CHAIN_ID = 137
|
137은 Polymarket USDC 계약이 모두 정산되는 Polygon 메인넷의 체인 ID입니다. |
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"]
|
로컬 .env복사 파일에서 서브 지갑 사본 키를 안전하게 읽습니다. |
client.create_or_derive_api_creds()
|
EIP-712 서명을 통해 가스리스 L2 CLOB API 자격 증명을 도출합니다. |
if true_prob <= mkt_price + 0.03: return 0.0
|
안전 필터: 보정 확률이 시장 가격보다 최소 +3% 이상 높을 때만 매매합니다. |
alloc_pct = min(max_cap, 0.5 * full_kelly)
|
각 주문당 하드 15% 최대 제한이 있는 Half-Kelly 사이징을 적용합니다. |
client.post_order(signed_order, OrderType.GTC)
|
0% 수수료로 패시브 Good-Til-Cancelled 메이커 제한 주문을 제출합니다. |
[!] 초보자가 자주 실수하는 상위 3가지 함정 & 문제 해결 가이드
✕ 함정 1: Market Slug와 TOKEN_ID복사 혼동
https://gamma-api.polymarket.com/markets?slug=<slug>복사를 조회하고 YES는 clobTokenIds[0]복사, NO는 clobTokenIds[1]복사를 복사합니다.
✕ 함정 2: 첫 주문 시 Allowance / Balance not enough복사 오류
Polymarket 웹 UI에서 먼저 $1 제한 주문을 접수하고 취소하여 프록시 지갑이 USDC 사용을 승인하도록 합니다.
✕ 함정 3: 큰 뉴스가 터졌을 때 방치된 유효하지 않은 제한 주문 (Limit Order)
매도/매도 대기(Maker) 주문을 60~90초마다 취소하고 갱신하세요.
1단계: 전용 서브월렛(Sub-Wallet) 및 Polygon 네이티브 USDC 준비하기
자동화 스크립트는 절대 메인 콜드 스토리지 시드 페이즈와 함께 실행하지 마세요. 격리된 서브월렛을 생성하고, OKX 또는 Binance에서 Polygon 네이티브 USDC로 자금을 채운 후, 초기 승인 작업을 위해 약 2달러 상당의 POL을 준비해 두세요.
2단계: .env복사 파일에서 로컬로 L2 CLOB API 자격 증명을 파생하기
client.create_or_derive_api_creds()복사를 한 번 실행하여 L2 API 키/비밀키/패스프레이즈를 생성하세요. chmod 600복사으로 .env복사 파일의 접근 권한을 제한하고, .gitignore복사 파일에 추가하세요.
3단계: Gamma REST API를 통해 clobTokenIds복사 해결하기
https://gamma-api.polymarket.com/markets?slug=<market-slug>복사를 쿼리하여 clobTokenIds[0]복사(YES 토큰)과 clobTokenIds[1]복사(NO 토큰)을 가져오세요.
4단계: 스탈 쿼트 보호 기능이 있는 GTC 메이커 지정가 주문 게시하기
수동 지정가 주문(패시브 페이저)을 게시하면 0%의 메이커 수수료와 스프레드 슬리피지(가변성)가 전혀 발생합니다. 중요한 매크로 뉴스가 발표될 때 잔존 주문을 취소하는 90초 간격의 하트비트(심박) 기능을 반드시 구현하세요.
Headline Quant Guides Directory (With Reading Level, Time & Code Stack)
Start from L1 Beginner Essentials and progress to L4 Institutional Tick Backtesting. Every guide includes reading difficulty, estimated reading time, and production-ready code:
Beginner $1,000 Quant Starter Combo Deep-Dive: How Much Can You Earn Monthly Running Polymarket Penny Clipper & LP Bots?
Complete quantitative breakdown for first-time algorithmic traders starting with $1,000 USDC: ranking all 4 Polymarket open-source bot strategies by risk-adjusted edge, modeling 3 realistic monthly profit tiers ($60–$180/mo or 6%–18% monthly ROI) using 5×$200 position splitting, and enforcing the 3 iron survival rules.
Pionex Cloud AI Bots vs. Self-Hosted Polymarket Bots (CloddsBot / Grok Desk): 6 Key Differences & Dual-Engine Allocation Guide
Both are called 'quant trading bots,' yet Pionex's 16 built-in cloud bots and self-hosted open-source Polymarket bots (`CloddsBot`, `polymarket_lp_tool`, `Grok 4-Step Desk`) operate on completely different market mechanics. Pionex harvests crypto volatility and perpetual funding rates with zero code and massive liquidity capacity, while self-hosted Polymarket bots snipe $1.00 deterministic event settlement discounts and Daily LP Rewards with zero correlation to Bitcoin price swings.
Pionex AI Quantitative Trading Complete Guide: 16 Free Built-In Grid Bots, Funding-Rate Arbitrage & Polymarket Delta Hedging
Don't want to maintain a Linux VPS? Master Pionex's 16 free built-in AI trading bots (PionexGPT strategy generator, AI Infinity Grid, Spot-Futures Funding Rate Arbitrage, and 0.05% maker/taker fees) and learn how to pair Pionex BTC/ETH grids with Polymarket event tail-hedges.
CloddsBot & Polymarket LP Bot Complete Guide: Deploy 119-Skill AI Arbitrage, Penny Clipper & Daily Liquidity Rewards Bots
Why pay $5,000+ for black-box bots when the best Polymarket trading engines are MIT open-source on GitHub? Full deployment guide to `alsk1992/CloddsBot` (3.1k⭐, 119+ skills including cross-market arbitrage, Penny Clipper expiry decay, and smart-money copy trading) and `lihanyu81/polymarket_lp_tool` (passive LP market-making for daily USDC rewards).
Grok × Polymarket 4-Step Multi-Agent Trading Desk: SCAN · VERIFY · EXECUTE · EXIT Pipeline That Filters Out 90% of Bad Trades
The best agent on a quantitative trading desk has never placed a trade — its entire job is to say NO. Learn how to replace fragile single-prompt FOMO bots with an institutional 4-Agent Desk (SCAN -> VERIFY -> EXECUTE -> EXIT) for Polymarket CLOB & crypto markets: run free deterministic code filters first, invoke Grok `x_search` only on survivors, size off live cash + pool depth, and enforce 5 pre-written exit rules (`exits.py`) with full `tasks.csv` skip auditing.
Polymarket CLOB 퀀트 가이드: py-clob-client로 0% 수수료 메이커 및 고래(Whale) 카피 트레이딩봇 배포하기
완벽한 엔지니어링 가이드: Polygon L2 CLOB 자격 증명 유도, Gamma 조건 토큰 ID 조회, 고래 거래 매수/매도 알림 구독 및 가스비가 0인 EIP-712 제한가격(리밋) 주문 작성법.
퀀트 VPS 보안, API IP 화이트리스팅 및 하드 드로우다운 킬-스위치 엔지니어링 가이드
퀀트 트레이더를 위한 프로덕션 보안 체크리스트: 저지연 VPS 선택, 거래소 API IP 화이트리스팅, 출금 비활성화 키 설정, 그리고 자동화 5% 일일 드로우다운 킬-스위치입니다.
AI LLM 확률 보정 + Half-Kelly 사이징: +EV 주문을 위한 DeepSeek / OpenAI / Ollama API 단계별 통합
Python을 통해 DeepSeek, OpenAI GPT-4o 또는 로컬 Ollama LLM에 연결하여 최신 뉴스를 구조화된 베이지안 우도비(likelihood ratio)와 Half-Kelly 포지션 사이징으로 분석하는 완전한 단계별 가이드.
Freqtrade + FreqAI Docker 튜토리얼: OKX / Binance 연결, 과거 데이터 다운로드 및 무선피어(미래지식) 편향 검증
Docker Compose로 Freqtrade를 배포하는 단계별 가이드, OKX 및 Binance의 수년치 OHLCV 데이터 다운로드, 현실적인 수수료 반영 백테스트 실행 및 `lookahead-analysis` 진행법.
Hummingbot 시장 메이킹 & 델타 헤지 가이드: Polymarket 오즈 vs OKX / Binance 페러스 (Perps) 간의 아비트리지
기관 트레이딩 데스크가 OKX/Binance에서 Hummingbot V2 시장 메이킹 컨트롤러를 Polymarket 이벤트 컨트랙트와 결합하여 델타-중립(중립적인) 거시 변동성 헤지를 구성하는 방법입니다.
NautilusTrader L2 호치(_ORDER BOOK) 백테스팅 가이드: 슬리피지(가차) 환상 및 큐(Queue) 위치 편향 제거하기
NautilusTrader에서 리얼리스트ic 큐(Queue) 위치 체결, 지연(latency) 모델링, 그리고 워크-포워드(Walk-Forward) 검증을 통해 고도(L2) 호치 틱 백테스트를 수행하는 방법입니다.
Poly Day (p.day) — 폴리마켓(Polymarket) 한국 완벽 가이드: 예측시장 확률, 디시/갤러리/나무위키 화제 판세 및 USDC 입금법
폴리마켓 한국 실시간 배당률, 업비트/빗썸 김치프리미엄 차익거래, 폴리마켓 디시 화제 판세 및 Polygon USDC 입금 가이드
국내 크립토 커뮤니티와 포털에서 「폴리마켓」, 「폴리마켓 한국」, 「폴리마켓 디시」, 「폴리마켓 갤러리」, 「폴리마켓 대선」 검색량이 폭발적으로 증가하고 있습니다. 폴리마켓(Polymarket)은 폴리곤(Polygon) 블록체인 기반의 세계 최대 탈중앙화 예측시장으로, 한국 대선·서울시장·정국 이슈부터 미국 연준(Fed) 금리 인하, 한국은행 기준금리, 비트코인 최고가 경신까지 실제 자금(USDC)이 걸린 오더북 확률(1¢~99¢)을 실시간으로 보여줍니다.
또한 많은 분들이 궁금해하시는 「폴리마켓 처벌」 및 법적 유의사항과 관련하여, Poly Day 한국어판(p.day/ko/)에서 전 세계 예측시장 배당률과 고래 지갑 데이터를 조회하고 거시경제·크립토 투자 지표로 활용하는 것은 100% 합법이며 안전합니다. 업비트(Upbit)·빗썸(Bithumb)에서 트래블룰을 준수해 USDT/USDC를 해외 거래소(Bybit/Binance)를 거쳐 Polygon 네트워크로 수수료 없이 전송하는 방법도 단계별로 안내합니다.