Polymarket CLOB API: 호가 조회와 주문 관리

Polymarket CLOB API 소개

공개 호가에는 매수·매도와 거래 제한이 포함됩니다. 참조 조회는 중간값, 스프레드와 최근 거래 정보를 별도로 제공합니다. 화면이나 체결 서비스에 쓰기 전에 가격 방향과 식별자를 확인하세요.

출처에 기록된 공개 CTF 호가 조회는 Gamma에서 선택한 결과와 맞는 ID를 반환했습니다. 이는 비공개 접근 시험보다 좁으며 서명·제출·취소·체결·지속 지연을 시험하지 않았습니다. API 인증 정보와 지갑 주문 승인은 별도 구현 요건입니다.

기능과 범위

• 결과 토큰 호가

  매수·매도, 가격 단위, 최소 주문, 상태 해시와 시장 식별자를 읽습니다.

• 가격 방향

  BUY는 최우선 ask, SELL은 최우선 bid를 반환합니다.

• 참조 가격

  중간값, 스프레드와 최근 거래 가격을 별도로 받습니다.

• 일괄 조회

  지원 호가·가격 요청은 최대 500개 항목을 받습니다.

• 주문 관리

  인증 인터페이스로 서명 주문 제출·취소·상태 관리를 수행합니다.

• 인증 계층

  L1 지갑 서명은 인증 정보를 생성·도출하고 L2는 비공개 요청을 서명하며 주문은 별도 지갑 서명으로 승인합니다.

• 관찰된 ID 연결

  공개 표본은 market, asset_id, timestamp, bids와 asks를 반환했습니다. market은 Gamma conditionId, asset_id는 요청 결과 토큰과 맞았습니다.

Polymarket CLOB API 활용 워크플로

가격과 총비용

시작하기

시작하기 전에: 문서는 최우선 호가를 배열 끝에 둔다고 설명합니다.

1. Gamma에서 시장과 결과 이름에 대응하는 토큰 ID를 찾습니다.
2. 공개 호가나 가격을 요청합니다.
3. 가격 단위와 최소 주문 크기를 지킵니다.
4. 비공개 작업에는 지갑 서명과 L2 인증을 설정합니다.
5. 직렬화된 요청 본문을 서명과 정확히 맞춥니다.

문서상 최우선 bid·ask는 배열 마지막 항목입니다. 첫 수준이 최선이라고 가정하지 마세요.

CLOB API 기본 엔드포인트

유용한 링크

• Polymarket Discord 커뮤니티

Polymarket CLOB API 자주 묻는 질문