API · AI 에이전트
2026년의 폴리마켓 봇 대부분은 AI 코딩 에이전트(Claude Code, Cursor, Copilot)에 프롬프트를 넣어서 만들어집니다. 그 방식도 괜찮습니다. 단, 에이전트를 최신 V2 API와 안전 레일 위에 묶어 둘 때 이야기입니다. 이 페이지는 그 방법을 보여줍니다. 생성된 코드가 올바르고 페이퍼 모드로 시작하도록 규칙 + 읽기 전용 툴링을 설치하고, 실제 자금을 건드리기 전에 체크리스트를 따르는 것입니다.
에이전트에게 규칙부터 주세요. 저장소에
AGENTS.md를 넣으세요(Claude Code, Cursor, Copilot 등이 이를 읽습니다).
이 파일은 V2 SDK, 베이스 URL, pUSD 컨트랙트, 함정, 페이퍼를 기본으로 하는 자금 레일을 고정합니다. 그래서
에이전트가 죽은 V1(py-clob-client 0.34 / USDC.e) 코드를 더 이상 작성하지 않게 됩니다.에이전트 설정하기
- 규칙: 저장소 루트에
AGENTS.md를 추가하세요(그리고CLAUDE.md심링크 /.cursor/rules미러도). - 컨텍스트: 에이전트가 학습 시점의 추측이 아니라 최신 문서에 답을 접지하도록, 우리
llms.txt와 API 참고 자료를 가리키게 하세요. - 접지 데이터: 토큰 ID가 환각이 아니라 라이브 시장에서 나오도록 읽기 전용 MCP를 설치하세요.
- 코드 생성: 타입이 있는 클라이언트를 만들려면 생성기를 폴리마켓의 기계 판독 가능 스펙으로 가리키세요. CLOB OpenAPI, Data OpenAPI, 그리고 AsyncAPI (WebSocket) 스펙입니다. 그래야 에이전트가 추측이 아니라 실제 스키마를 대상으로 빌드합니다.
안전한 바이브 코딩 체크리스트
AI가 생성한 모든 트레이딩 봇을 라이브로 실행하기 전에 다음 기준으로 검증하세요:
- 읽기 전용으로 시작 - 시장 데이터가 먼저, 주문은 없이.
- 페이퍼 모드를 기본으로. 라이브 거래에는 명시적
--live플래그가 필요합니다. - 키는 환경 변수에만 - 하드코딩, 로그 출력, 커밋은 절대 금지.
- 공식 V2 SDK + 베이스 URL 고정 - 에이전트가 엔드포인트를 지어내지 못하게.
- 스펙 / MCP에 접지 - 에이전트가 "기억한다"는 엔드포인트를 믿지 마세요.
- 잘못된 데이터에는 안전하게 실패 - 실패했거나 비어 있는 조회로는 절대 거래하지 마세요.
- 사람의 검토 - 첫 라이브 실행 전에.
- 강한 포지션 & 손실 한도 + 킬 스위치.
이것이 중요한 이유. 바이브 코딩된 트레이딩 봇은 알려진 방식으로 실패합니다.
환각 가격으로 거래하고, 죽은 V1 패턴을 쓰고, 환각으로 만들어낸 패키지를 설치하며(slopsquatting), 키를
하드코딩합니다. 규칙 파일 + 읽기 전용 MCP + 페이퍼 우선 스캐폴드는 이 모든 것을 기본값으로 막아 줍니다.
좋은 첫 프롬프트
Using the Polymarket V2 API (py-clob-client-v2) and the AGENTS.md rules in this repo,
write a PAPER bot that finds the BTC-above-150k market, reads its order book, and would
buy Yes under 0.40. Do NOT place live orders. Keys from env only. Fail closed on bad data.에이전트는 페이퍼 모드 코드를 만들어야 합니다. 실제 토큰 ID(MCP/라이브 데이터에서), 환경에서 읽는 키,
그리고 당신이 직접 --live를 추가하지 않는 한 라이브 주문 경로가 없어야 합니다.
에이전트에게 실제 시장을 주세요
환각 토큰 ID는 바이브 코딩의 1순위 버그입니다. 여기서 실제 시장을 검색해 그 ID를 복사하고 에이전트에게 넘기세요(또는 MCP가 하게 두세요):
다음: AGENTS.md 규칙 · 어떤 SDK를 쓸까 · 복사-붙여넣기 예제 · CLOB 참고 자료 · 오류 해결 · 보일러플레이트.
재정 조언이 아닙니다. 자동 거래는 실제 자금을 위험에 노출합니다. 페이퍼 모드에서 테스트하고 라이브로 전환하기 전에 검토하세요.
