터미널에서 Polymarket 예측 봇 빌드 및 실행하기

Polymarket 예측 봇이란?

Polymarket 예측 봇은 Polymarket의 예측 시장을 탐색할 수 있는 오픈 소스 키보드 중심 터미널 애플리케이션입니다. Textual 및 Rich 기반 터미널 인터페이스에서 시장 브라우저, 실시간 중앙 지정가 주문장 화면, 전략 엔진, 포지션 추적기, 체결 로그를 제공합니다.

Polymarket 시장에는 일반적으로 실제 사건의 결과에 따라 $1 또는 $0으로 정산되는 YES 및 NO 주식이 있습니다. 시장 가격을 내재 확률로 해석할 수 있으므로, 이 봇은 시장 가격을 적정 확률 추정치와 비교하고 주문장 상태를 분석하여 잠재적인 엣지 또는 차익거래 신호를 표시합니다.

중요: 이 프로젝트는 비공식 교육용 프로젝트이며 Polymarket과 제휴하지 않습니다. 금융 조언이 아니며, 포함된 어떤 전략도 수익을 보장하지 않습니다. 지갑에 연결하지 않고 번들 데이터셋과 시뮬레이션 체결을 사용하는 --demo로 시작하세요.

주요 기능

• 시장 브라우저: 거래량, 스프레드, 카테고리, 정산까지 남은 시간으로 시장을 필터링합니다.
• CLOB 주문장: YES 및 NO 매수·매도 호가, 스프레드, 중간 가격, 주문장 불균형을 확인합니다.
• 전략 엔진: 확률 엣지, 주문장 불균형, 유동성 전략을 개별적으로 또는 함께 실행합니다.
• 신호 추적: 추천 방향과 0에서 1 사이의 신뢰도 값을 확인합니다.
• 포지션 모니터링: 보유 중인 YES 및 NO 수량, 평균 비용, USDC 기준 미실현 손익, 정산 카운트다운을 추적합니다.
• 체결 로그: 신호, 시뮬레이션 체결 또는 CLOB 체결, 취소 내역을 로컬에 기록합니다.
• 대시보드: 주요 변동 시장, 넓은 스프레드, 정산이 임박한 시장, 대기 중인 신호를 확인합니다.
• 모의 거래: 실시간 접속을 설정하기 전에 가상 USDC 잔액으로 작업 흐름을 테스트합니다.
• 위험 관리: USDC 최대 익스포저, 시장별 한도, 일일 손실 한도를 적용합니다.
• 멀티플랫폼 인터페이스: Windows, macOS 또는 Linux에서 애플리케이션을 실행합니다.

사전 요구 사항

표준 설치에는 Git, Python 3.11 이상, pip가 필요합니다. 저장소에는 처음 사용할 때 번들로 제공되는 독립 실행형 인터프리터의 압축을 해제하는 원클릭 실행기도 포함되어 있으므로, 해당 실행기를 사용하면 시스템에 Python을 설치하지 않아도 됩니다.

Python으로 봇 설치하기

1. 저장소를 복제합니다.

   git clone https://github.com/gulelmatthews/Polymarket-Perpetual-Bot.git

2. 프로젝트 디렉터리로 이동합니다.

   cd Polymarket-Perpetual-Bot

3. 필요한 패키지를 설치합니다.

   pip install -r requirements.txt

4. 번들 데모 데이터셋으로 시작합니다.

   python main.py --demo

또한 python -m polymarket_bot을 통해 패키지 진입점을 사용할 수 있습니다. 명령줄 분석 및 실행 로직은 호스트 패키지에 구현되어 있습니다.

원클릭 실행기 사용하기

Windows

포함된 배치 실행기를 실행합니다.

run.bat

Linux 및 macOS

셸 실행기에 실행 권한을 부여한 다음 실행합니다.

chmod +x run.sh
./run.sh

처음 사용할 때 이 실행기들은 애플리케이션에 필요한 번들 독립 실행형 인터프리터의 압축을 해제합니다.

터미널 대시보드 탐색하기

인터페이스는 6개의 기본 화면으로 구성됩니다. 숫자 키를 사용하면 화면 사이를 바로 이동할 수 있습니다.

• 1: 대시보드
• 2: 시장
• 3: 주문장
• 4: 전략
• 5: 포지션
• 6: 로그

주요 작업 흐름을 지원하는 추가 키보드 조작:

• /: 시장 목록을 필터링합니다.
• Enter 또는 b: 선택한 시장의 CLOB 주문장을 엽니다.
• s: 관심 목록 전체에서 전략 엔진을 실행합니다.
• o: 모의 주문을 작성합니다.
• t: 사용 가능한 테마를 차례로 전환합니다.
• q: 애플리케이션을 종료합니다.

기본 데모 작업 흐름

1. python main.py --demo로 애플리케이션을 실행합니다.

2. 2를 눌러 시장 브라우저를 엽니다.

3. /를 사용하여 사용 가능한 필터에 따라 표시되는 시장을 좁힙니다.

4. 시장을 선택하고 Enter 또는 b를 눌러 해당 시장의 YES 및 NO 주문장을 확인합니다.

5. 최우선 매수·매도 호가, 스프레드, 중간 가격, 상대적 수량 불균형을 확인합니다.

6. s를 눌러 활성화된 전략으로 관심 목록을 스캔합니다.

7. 4로 전략 화면을 열고 각 신호의 신뢰도와 추천 방향을 확인합니다.

8. 신호를 테스트하려면 o를 눌러 모의 주문을 작성합니다.

9. 5를 사용하여 포지션과 미실현 손익을 확인한 다음, 6을 사용하여 신호와 시뮬레이션 체결을 검토합니다.

내장 전략 이해하기

확률 엣지 전략

이 전략은 시장 가격을 적정 확률 모델과 비교합니다. 차이가 설정된 임계값을 초과하면 신호를 생성합니다. 예를 들어 모델의 적정 확률이 현재 YES 가격보다 유의미하게 높다면, 결과 신호는 YES 방향을 추천할 수 있습니다.

이 신호의 품질은 전략에 제공된 적정 확률 모델에 따라 달라집니다. 신뢰도는 보장이 아니라 분석 결과로 간주하세요.

주문장 불균형 전략

오더북 불균형 전략은 YES와 NO 양쪽에서 이용 가능한 상대적 주문량을 분석합니다. 주문량의 큰 편중은 방향성 신호로 볼 수 있습니다. 이는 오더북 정보일 뿐이며, 시장이 해당 방향으로 움직이거나 결과가 결정된다는 증거는 아닙니다.

유동성 전략

유동성 전략은 넓은 스프레드와 중간값으로의 평균 회귀 가능성을 찾습니다. 넓은 스프레드는 기회를 제공할 수 있지만, 유동성 부족이나 높은 체결 위험을 나타낼 수도 있습니다.

시장 간 신호

봇은 YES와 NO의 합산 스프레드 및 다중 결과 차익거래 신호를 표시할 수 있습니다. 이러한 신호는 자동 수익으로 간주하기보다 가용 유동성, 오더북 깊이, 위험 한도와 함께 평가해야 합니다.

실시간 모드 구성

실시간 모드를 사용하려면 본인의 Polymarket API 자격 증명이 필요합니다. 다음 구조로 ~/.polymarket-bot/config.toml 구성 파일을 생성합니다.

[auth]
private_key    = "0x…"
proxy_address  = "0x…"
api_key        = "…"
api_secret     = "…"
api_passphrase = "…"
endpoint       = "https://clob.polymarket.com"

private key는 Polygon EOA 개인 키이고, proxy_address는 Polymarket 프록시 또는 서명자 주소입니다. 애플리케이션은 이 로컬 구성 파일에서만 자격 증명을 읽습니다.

Unix 파일 권한을 지원하는 시스템에서는 파일 접근을 제한합니다.

chmod 0600 ~/.polymarket-bot/config.toml

보안 경고: 구성 파일, 개인 키, API secret 또는 passphrase를 소스 제어에 절대 커밋하지 마세요. 프로젝트 설명에 따르면 키는 로컬에만 보관되며 로그에 기록되지 않습니다.

자격 증명을 구성한 후 다음 명령으로 실시간 모드를 시작할 수 있습니다.

python main.py

실시간 주문 배치는 명시적인 구성 뒤에만 활성화됩니다. 먼저 데모 모드에서 설정을 검증하고, 노출도 제어를 확인하며, Polymarket을 해당 관할권에서 이용할 수 있는지 확인하세요. 프로젝트는 지역 제한을 우회하지 않습니다.

고급 사용 팁

전략 맥락 결합

내장 전략은 선택하고 조합할 수 있습니다. 하나의 지표만으로 판단하지 말고 확률 엣지, 오더북 불균형, 스프레드 폭, 신호 신뢰도를 비교하세요. 여러 지표가 일치하면 더 많은 맥락을 파악할 수 있지만, 그렇다고 거래 위험이 사라지는 것은 아닙니다.

신호를 검토하기 전에 유동성 확인

표시된 시장 가격만으로는 해당 가격에 체결할 수 있는 주문량을 알 수 없습니다. 엣지 또는 차익거래 신호를 평가하기 전에 오더북을 열어 매수·매도 깊이, 스프레드, 중간값, 불균형을 확인하세요.

로그를 거래 기록으로 활용

봇은 신호, 체결, 취소를 기록합니다. 로그를 검토하면 전략 결과를 이후의 시뮬레이션 결과와 비교하고, 높은 신뢰도의 신호가 예상대로 작동하지 않은 사례를 파악하는 데 도움이 됩니다.

결과 확정 시간 모니터링

마켓 브라우저와 대시보드를 사용해 곧 결과가 확정될 시장을 확인하세요. 결과 확정 시점은 자금이 얼마나 오래 노출될 수 있는지에 영향을 주며, Positions 화면에서는 열린 시장의 카운트다운을 제공합니다.

실시간 사용 전에 위험 제어 적용

사용 가능한 최대 USDC 노출도, 시장별 한도, 일일 손실 한도를 설정하고 준수하세요. 이러한 제어 기능은 전략을 실시간 주문 템플릿에 연결할 때 특히 중요합니다.

데모와 실시간 워크플로 분리

키 바인딩을 익히고, 전략 조합을 테스트하며, 시뮬레이션 체결을 관찰하는 동안에는 --demo를 사용하세요. 인터페이스, 신호 해석, 위험 설정이 예상대로 작동하는지 확인한 후에만 자격 증명을 사용하는 실시간 모드로 전환하세요.

프로젝트 구조

저장소는 명령줄 시작, 구성, 전략 로직, 데이터 모델, 터미널 인터페이스를 분리합니다.

polymarket-prediction-bot/
├── main.py
├── polymarket_bot/
│   ├── __main__.py
│   ├── cli.py
│   ├── config.py
│   ├── core/
│   └── tui/
├── support/
├── requirements.txt
├── run.bat
├── run.sh
└── release/

main.py는 기본 진입점이며, polymarket_bot/core/에는 모델, 전략 엔진, 모의 데이터가 들어 있습니다. polymarket_bot/tui/ 디렉터리에는 Textual 화면, 위젯, 스타일이 들어 있습니다. release/ 디렉터리는 계획된 사전 컴파일 바이너리를 위해 예약되어 있습니다.

결론

Polymarket Prediction Bot은 예측 시장을 탐색하고, CLOB 유동성을 확인하며, 전략 신호를 생성하고, 포지션과 체결을 추적하는 통합 터미널 워크플로를 제공합니다. python main.py --demo로 시작해 키보드 중심 인터페이스를 익히고, 맥락에 따라 신호를 평가하며, 자격 증명을 사용하는 실시간 모드를 고려하기 전에 엄격한 노출도 제어를 적용하세요.

이 프로젝트는 MIT 라이선스로 배포되며 금융 조언이 아닌 독립적인 교육용 도구로 제공됩니다.