---
url: "https://predictiontoolkit.com/ko/tools/polymarket-client/"
publisher: "PredictionToolkit"
dateModified: "2026-11-02"
---

[← SDK와 라이브러리](<https://predictiontoolkit.com/ko/polymarket-sdks/>) 

![@polymarket/client 로고](<https://predictiontoolkit.com/assets/logo-tool-polymarket-client-765ba4cc040b.webp>)

SDK

# @polymarket/client: 공식 TypeScript SDK

@polymarket/client는 npm으로 TypeScript와 JavaScript에서 쓰는 Polymarket 공식 통합 SDK입니다. 자격 정보 없는 공개 데이터와 인증된 거래·지갑 동작을 구분합니다.

[**4.0**5점 만점편집부 평가](<https://predictiontoolkit.com/ko/tools/polymarket-client/#reviews>) [편집팀 평가](<https://predictiontoolkit.com/ko/tools/polymarket-client/#reviews>) 

[npm에서 @polymarket/client 보기](<https://npmjs.com/package/@polymarket/client>) npmjs.com

**가격:** 패키지는 구독이 필요 없습니다. 거래소 비용과 운영 인프라 비용은 별도입니다.

[스크린샷](<https://predictiontoolkit.com/ko/tools/polymarket-client/#screenshots>) [대안 살펴보기](<https://predictiontoolkit.com/ko/tools/polymarket-client/#alternatives>) 

[SDK와 라이브러리](<https://predictiontoolkit.com/ko/polymarket-sdks/>) [공식 개발 도구](<https://predictiontoolkit.com/ko/polymarket-official-tools/>) 

## 스크린샷과 인터페이스

제품 미리보기1 / 2

공식 통합 SDK 소개.

## @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()로 재개합니다.
    

## 개발 흐름

### 타입 시장 화면

PublicClient를 만들고 작은 페이지를 읽어 호가창 조회용 토큰 ID를 보관하세요.

### 계정 동작 추가

서명을 연결하고 SecureClient를 만들어 계정 신원을 확인한 뒤 기능을 켜세요.

### 주제 수신

공개 주제를 구독하고 이벤트 타입을 구분하며 해제 시 stream.close()를 호출하세요.

### 중단 탐색 재개

페이지 처리 후 nextCursor를 저장하세요. 필터를 유지하고 요청 속도를 조절하며 동작별 검사로 RateLimitError/UserInputError를 처리하고 예상 밖 오류는 다시 던지세요.

## 가격과 총비용

패키지는 구독이 필요 없습니다. 거래소 비용과 운영 인프라 비용은 별도입니다.

## 설치와 설정

1.  공식 @polymarket/client를 설치하세요.
2.  PublicClient로 활성 시장을 읽으세요.
3.  페이지 처리와 오류 처리를 구현하세요.
4.  계정 기능에만 서명과 SecureClient를 추가하세요.
5.  이전 클라이언트에는 현재 이전 가이드를 쓰세요.

[TypeScript SDK 가이드 읽기](<https://docs.polymarket.com/getting-started/typescript>) 

## 유용한 링크

-   [Polymarket Discord 참여](<https://discord.gg/polymarket>) 

### 확인할 사항

-   PublicClient는 비공개 계정 스트림을 제공하지 않습니다.
-   소수 문자열과 도메인 ID는 다른 타입입니다.
-   이전 클라이언트는 메서드와 계정 규칙이 다릅니다.

자세히 살펴보기

## 평가와 리뷰

편집부 평가

**4.0**5점 만점

사용자 리뷰 0건

PredictionToolkit 편집부

### @polymarket/client에 대한 편집부 의견

타입 ID와 공개·계정 기능 구분으로 문서가 잘 갖춰진 TypeScript 출발점입니다. 이전 클라이언트에서는 신중한 이전 작업이 필요합니다.

**평가 기준:** 작업 유용성, 문서화된 범위, 설정의 명확성, 접근 및 비용의 투명성.

**평가 날짜:** 2026-10-01

**문서 검토 완료:** 2026-10-01

문서에 근거한 평가입니다. [평가 방법](<https://predictiontoolkit.com/ko/methodology/>) 

### 사용자 리뷰 0

공개된 리뷰가 5건이 되면 주 평가가 사용자 평가로 바뀝니다.

**첫 이용 경험을 공유해 주세요**

구체적인 사례는 다음 사용자가 알맞은 도구를 고르는 데 도움이 됩니다.

## 관련 도구

[카테고리 둘러보기](<https://predictiontoolkit.com/ko/polymarket-sdks/>) 

![공식 Polymarket CLOB 가격·호가 문서](<https://predictiontoolkit.com/assets/cover-polymarket-clob-api-39f988b081351d90-400.webp>)

![Polymarket CLOB API 로고](<https://predictiontoolkit.com/assets/logo-tool-polymarket-clob-api-765ba4cc040b.webp>)[Polymarket CLOB API](<https://predictiontoolkit.com/ko/tools/polymarket-clob-api/>) 

데이터 API**4.0**편집부

결과 토큰 가격과 깊이를 조회하고 인증 주문은 별도 서명 절차로 처리합니다.

-   접근 API

전송 제어가 필요하면 직접 HTTP를 씁니다.

![공식 Polymarket Python SDK 설치·빠른 시작](<https://predictiontoolkit.com/assets/cover-polymarket-python-sdk-abdc8e68d81b53bc-400.webp>)

![Polymarket Python SDK 로고](<https://predictiontoolkit.com/assets/logo-tool-polymarket-python-sdk-765ba4cc040b.webp>)[Polymarket Python SDK](<https://predictiontoolkit.com/ko/tools/polymarket-python-sdk/>) 

SDK**4.0**편집부

스크립트·노트북·계정 작업·실시간 구독용 타입 기반 동기·비동기 클라이언트입니다.

-   언어 Python

공식 Python 대안을 씁니다.

![Poly SDK 기능, 설치, 서비스](<https://predictiontoolkit.com/assets/cover-poly-sdk-5d5c6a6ddd551594-400.webp>)

[Poly SDK](<https://predictiontoolkit.com/ko/tools/poly-sdk/>) 

SDK**3.0**편집부

타사 TypeScript 도구 모음에서 데이터 클라이언트, 지갑 추적, 전략 예시를 결합합니다.

-   언어 TypeScript

고수준 타사 TypeScript 전략과 비교합니다.

## @polymarket/client 자주 묻는 질문

### 통합 패키지는 무엇인가요?

@polymarket/client입니다.

### 공개 조회에 개인 키가 필요한가요?

아니요. createPublicClient로 시작하세요.

### 여러 주제를 합칠 수 있나요?

네. 스포츠와 시장 등 여러 주제 명세를 받습니다.

### 어떻게 재개하나요?

nextCursor를 그대로 저장하고 페이지 객체로 재개하세요.

### 스트림은 어떻게 닫나요?

해제 시 stream.close()를 호출하세요. 공개 구독은 두 클라이언트 모두 가능하지만 계정 동작에는 적절한 서명과 권한이 필요합니다.

이 프로필에서