@polymarket/client: what it does, what it costs, where it stops

What it does

createPublicClient() gives unauthenticated market discovery and data with no host or chain config; createSecureClient derives or creates CLOB credentials, resolves the account wallet and configures signing. List methods return a paginator you iterate with for await, and page.nextCursor is an opaque cursor you can store and resume from.

Responses use typed models plus branded types for identifiers, decimals, timestamps and EVM addresses, so a TokenId cannot be passed where a MarketId belongs. Each action exposes a matching error guard for documented failures.

The docs page says the one client can fetch market data, subscribe to real-time data, submit orders and redeem positions. Exported types include Event, Market, OrderBook and PriceHistoryPoint alongside the branded CtfConditionId, DecimalString, EvmAddress, IsoDateTimeString, MarketId and TokenId. createSecureClient replaces the two-step credential derivation that clob-client-v2 required.

• Signer adapters for Viem, Privy and Ethers v5 are built in.
• Covers the Gamma API and Data API as well as CLOB trading and WebSocket subscriptions.
• Workspace packages: client, types, bindings (internal generated), and example scripts.
• Perps APIs are marked @experimental and may change in any release.

Pricing

Free under MIT. Publishing runs through Changesets with npm trusted publishing. The repo README documents pnpm build and pnpm clean as the only root scripts, with tsconfig.build.json governing package builds. Runnable scripts under examples/scripts show the common SDK workflows end to end.

Venues and data

Polymarket only. Polymarket US has its own official TypeScript SDK (Polymarket/polymarket-us-typescript) and is a separate exchange with a different API.

Where it falls short

It is 0.x: minor releases may break, and 273 npm versions in under five months show how fast it is moving. Repo development requires Node.js 24 or newer and pnpm 10, per the README.

A unified Rust SDK is still in development per the docs, so Rust users remain on the older CLOB client. The migration guide covers the CLOB, relayer and builder-signing clients; direct Gamma and Data API calls can be moved too, which the docs say simplifies application code.

Who should use it

Any new TypeScript or Node.js integration with Polymarket, and existing clob-client-v2 users following the migration guide.

Cross-venue builders should still reach for PMXT or CCXT, both of which have TypeScript packages.