TL;DR

Polymarket-5min-bot은 Rust로 작성된 자동 차익거래 에이전트로, Polymarket의 5분 Up/Down 시장에서 YES+NO 호가 합이 설정한 임계값 이하일 때 동시 매수하고 온체인 Merge로 포지션을 통합해 차익을 실현합니다. 환경변수로 서명 타입(Poly1271 등), 스프레드, 최대 주문 크기, 리스크 한도, Merge 주기와 윈드다운 동작을 세밀하게 제어할 수 있으며 릴리스 바이너리와 소스 빌드 경로가 모두 제공됩니다. 실제 자금 연결이 가능하므로 운영 전 Builder API 키와 서명 타입 설정을 확인하고 소규모 자금으로 충분히 검증할 것을 권장합니다.

주요 기능

• 실시간 CLOB 호가 구독으로 YES+NO 합을 지속 계산해 차익 기회를 포착합니다.
• 매수·병합·윈드다운을 자동화해 창 종료 전 리스크를 줄이고 포지션을 정리합니다.
• 환경변수 기반으로 심도 있는 설정을 제공하여 슬리피지, 주문 규모, 노출 한도를 조절합니다.
• Builder API를 이용한 온체인 Merge와 다양한 서명 타입(Poly1271, Proxy, GnosisSafe, Eoa)을 지원합니다.

어떻게 동작하는가

Polymarket의 5분 Up/Down 창에서 YES와 NO 호가 합계가 1보다 낮으면 이론적으로 무위험 수익이 발생하므로 봇은 이 조건을 감시합니다. 먼저 지정한 심볼 목록으로 시장을 발견하고 CLOB 구독으로 매초 최우선 호가를 합산한 뒤 설정된 spread 임계값 이하이면 YES와 NO를 동시 주문해 포지션을 획득합니다. 보유 후에는 주기적 혹은 윈드다운 시점에 온체인 Merge를 호출해 두 토큰을 USDC/pUSD로 통합해 노출을 제거하고, 실행 로그와 리스크 한도는 환경변수로 제어합니다.

해결 문제

Polymarket 5분 예측시장은 짧은 시간에 발생하는 미스프라이싱을 사람이 연속 모니터링하기 어려운 문제를 안고 있습니다. 이 봇은 실시간 주문서 합산과 자동 주문·병합 흐름으로 반복적이고 빠른 차익 기회를 프로그램적으로 포착해 실행 시간을 단축합니다. 또한 윈드다운과 포지션 병합 옵션으로 만기 전 리스크 관리를 자동화해 수동 개입을 줄입니다.

지금 주목받는 이유

토픽 태그와 README가 강조하는 5minute arbitrage 특성 때문에 단기 암호화 예측시장 자동화 사례로 관심을 끌고 있습니다. Polymarket의 활성화와 함께 YES/NO 스프레드 기반 차익 전략을 자동화한 오픈소스 구현체가 비교적 드물기 때문에 개발자와 연구자가 실전 환경을 검증하려는 목적에서 주목을 받고 있습니다. Rust 생태계에서 실무형 거래 에이전트를 찾는 사용자에게 맞는 사례로 검색 트래픽이 발생할 수 있습니다.

차별점

• Rust로 작성되어 단일 바이너리로 배포 가능한 점이 특징입니다. 이로 인해 성능과 실행 파일 배포가 용이하며, README에 Linux·Windows 용 사전 빌드 릴리스가 제공됩니다. 소스 빌드 시 cargo run으로 곧바로 실행할 수 있어 개발자 로컬 테스트 경로가 단순합니다.
• 서명 타입과 Builder API를 명시적으로 분리해 다양한 Polymarket 계정 유형을 지원합니다. 기본값은 Poly1271이며 Proxy, GnosisSafe, Eoa 등 실사용자 지갑 환경에 맞춰 전환할 수 있습니다. 이로 인해 서로 다른 계정 구성에서 발생할 수 있는 주문 실패 원인을 설정 단계에서 보완할 수 있습니다.
• 세부 실행 파라미터(스프레드 임계값, 최대 주문 규모, 리스크 한도, Merge 간격, 윈드다운 시간)를 환경변수로 제공해 운영 유연성이 높습니다. 운영 중 슬리피지와 노출을 조정해 보수적으로 또는 공격적으로 전략을 튜닝할 수 있습니다. 기본값들이 합리적으로 설정되어 있어 즉시 데모 운영이 가능합니다.

사용 사례

• 실전 모의 운영을 통해 5분 예측시장 차익 전략의 체결 가능성과 수익성을 검증하는 용도로 적합합니다. 봇은 실시간 CLOB 구독과 자동 주문 흐름을 제공하므로 개발자가 설정값을 바꾸며 다양한 시장 상황에서 전략 민감도를 측정할 수 있습니다. 백테스트 대신 라이브 소규모 펀딩으로 전략을 관찰하려는 연구자에게 유용합니다.
• 거래 인프라 테스트베드로 이용해 서명 타입 처리, Builder API 통합, 온체인 Merge 실패 케이스를 점검하는 데 적합합니다. 리스크 한도, 슬리피지, 주문 크기 등 운영 파라미터를 환경변수로 바꿔가며 복구 로직과 알람을 검증할 수 있습니다. 멀티 시그(GnosisSafe)나 Proxy 계정과의 상호작용을 실환경에서 점검하려는 엔지니어에게도 유용합니다.
• 교육 목적의 코드리딩 및 데모로 활용할 수 있어 prediction market의 작동 원리와 주문서 기반 차익 구조를 학습하기에 적절합니다. README와 이미지가 핵심 동작 흐름과 대시보드를 제공하므로 강의나 워크숍 자료로 바로 활용 가능합니다. 단, 실제 자금 연결 전 충분한 테스트가 필요합니다.

시작하기

릴리스 바이너리를 내려받아 .env.example을 복사해 필수 환경변수를 채우면 Linux나 Windows에서 즉시 실행할 수 있습니다. 소스에서 빌드하려면 Rust(toolchain) 설치 후 .env를 채운 상태에서 cargo run으로 실행하면 됩니다. README가 서명 타입과 Builder API 요구사항을 상세히 안내하므로 운영 전 설정값을 꼼꼼히 확인해야 합니다.

요구사항

• 실제 운영을 위해서는 Polymarket 계정의 폰더(예: POLYMARKET_PRIVATE_KEY)와 설정된 POLYMARKET_PROXY_ADDRESS가 필요합니다. 이메일/Magic 링크 계정 또는 브라우저 지갑에서 EOA 키를 추출하거나 V2 deposit 지갑 흐름에 맞는 정보를 준비해야 합니다. 또한 Merge 자동화는 Builder API 키·시크릿·패스프레이즈가 요구됩니다.
• 로컬 개발 환경에는 Rust 툴체인이 필요하며, 릴리스 바이너리를 사용할 경우에도 실행 시스템에 맞는 권한과 네트워크 접근이 요구됩니다. CLOB 구독을 위한 네트워크 안정성과 낮은 지연이 중요하므로 운영 환경에서 네트워크 모니터링을 권장합니다. 또한 온체인 호출을 위해 지갑에 gas·수수료를 감당할 자금이 필요합니다.
• 운영 정책과 법적 준수 검토를 사전에 해야 합니다. README는 학습·연구 목적이라고 명시하나 실제 자금 운용 시 Polymarket 약관과 관할법을 준수해야 합니다. 위험 노출 한도(RISK_MAX_EXPOSURE_USDC) 등 파라미터를 보수적으로 설정해 초기 소규모 자금으로 검증하는 절차가 필요합니다.

이미지 분석