PredictionToolkit
@polymarket/client 소개
PublicClient는 공개 데이터를, SecureClient는 Viem, Privy, Ethers 서명 어댑터로 계정 기능을 제공합니다. 내보낸 모델과 토큰·시장·조건·주소 타입은 식별자 및 소수 문자열을 의도적으로 구분합니다.
목록 페이지 객체는 동기적으로 생성되고 firstPage()나 비동기 순회가 데이터를 가져옵니다. nextCursor를 그대로 보관해 from(cursor).firstPage()로 재개하고 새 탐색에서는 생략하세요. 이전 CLOB 클라이언트는 메서드와 계정 규칙이 달라 현재 이전 가이드가 필요합니다.
적합한 사용자
- TypeScript 시장·거래 앱.
- 이전 클라이언트를 교체하는 팀.
- 여러 실시간 피드를 받는 앱.
기능과 범위
- 공개·보안 클라이언트
공개 데이터와 서명 계정 동작을 나눕니다.
- 타입 모델
Event, Market, OrderBook 응답 타입을 씁니다.
- 식별자 타입
컴파일 단계에서 도메인 ID를 구분합니다.
- 페이지 처리
페이지를 순회하고 불투명 커서를 저장합니다.
- 오류 처리
동작별 제한·입력 오류를 처리하고 예상 밖 오류는 다시 던집니다.
- 지갑 어댑터
Viem, Privy, Ethers 서명을 지원합니다.
- 통합 구독
여러 주제를 한 이벤트 스트림으로 받습니다.
- 탐색 재개
firstPage()나 비동기 순회로 읽고 from(cursor).firstPage()로 재개합니다.
@polymarket/client 활용 워크플로
타입 시장 화면
PublicClient를 만들고 작은 페이지를 읽어 호가창 조회용 토큰 ID를 보관하세요.
계정 동작 추가
서명을 연결하고 SecureClient를 만들어 계정 신원을 확인한 뒤 기능을 켜세요.
주제 수신
공개 주제를 구독하고 이벤트 타입을 구분하며 해제 시 stream.close()를 호출하세요.
중단 탐색 재개
페이지 처리 후 nextCursor를 저장하세요. 필터를 유지하고 요청 속도를 조절하며 동작별 검사로 RateLimitError/UserInputError를 처리하고 예상 밖 오류는 다시 던지세요.
가격과 총비용
패키지는 구독이 필요 없습니다. 거래소 비용과 운영 인프라 비용은 별도입니다.
시작하기
시작하기 전에: PublicClient는 비공개 계정 스트림을 제공하지 않습니다.
- 공식 @polymarket/client를 설치하세요.
- PublicClient로 활성 시장을 읽으세요.
- 페이지 처리와 오류 처리를 구현하세요.
- 계정 기능에만 서명과 SecureClient를 추가하세요.
- 이전 클라이언트에는 현재 이전 가이드를 쓰세요.
SDK 커서는 불투명 값이며 변경 없이 저장해야 합니다.
유용한 링크
확인할 사항
- PublicClient는 비공개 계정 스트림을 제공하지 않습니다.
- 소수 문자열과 도메인 ID는 다른 타입입니다.
- 이전 클라이언트는 메서드와 계정 규칙이 다릅니다.
자세히 살펴보기
평가와 리뷰
사용자 리뷰 0
공개된 리뷰가 5건이 되면 주 평가가 사용자 평가로 바뀝니다.
구체적인 사례는 다음 사용자가 알맞은 도구를 고르는 데 도움이 됩니다.
관련 도구
카테고리 둘러보기
@polymarket/client 자주 묻는 질문
통합 패키지는 무엇인가요?
@polymarket/client입니다.
공개 조회에 개인 키가 필요한가요?
아니요. createPublicClient로 시작하세요.
여러 주제를 합칠 수 있나요?
네. 스포츠와 시장 등 여러 주제 명세를 받습니다.
어떻게 재개하나요?
nextCursor를 그대로 저장하고 페이지 객체로 재개하세요.
스트림은 어떻게 닫나요?
해제 시 stream.close()를 호출하세요. 공개 구독은 두 클라이언트 모두 가능하지만 계정 동작에는 적절한 서명과 권한이 필요합니다.