TypeScript client library for Polymarket exchange connectivity.

🚀 Overview

Extracted from the polymarket-trading-bot monorepo. Provides WebSocket clients, orderbook tracking, price feeds, order execution, and redemption services for interacting with the Polymarket CLOB exchange.

🧰 Tech Stack:

📦 Features

• WebSocket clients – Market orderbook, user trades, RTDS price feed (Chainlink + Binance)
• Orderbook tracking – Snapshot/delta processing, ask/bid ladders, slope tracking
• Order execution – Limit orders (maker), market orders, pre-signed sells via CLOB API
• Redemption service – Auto-redeem settled positions, merge paired UP/DOWN positions
• Error handling – neverthrow Result types, no exceptions thrown

🛠️ Configuration

Prerequisites

• Node.js 22+
• pnpm

Installation & Usage

pnpm install

# Use as a dependency in another project
# package.json: "poly-client": "file:../poly-client"

import { createPolymarketClient, createPriceFeed } from 'poly-client';

const priceFeed = createPriceFeed();
const client = await createPolymarketClient({
    privateKey: process.env.POLYMARKET_PRIVATE_KEY!,
    funder: process.env.POLYMARKET_FUNDER!,
    priceFeed,
});

Development

pnpm test            # Run unit tests
npx tsc --noEmit     # Type check

📄 License

This project is licensed under the MIT License.

📫 Contact

Darren Kuro – [email protected]

GitHub: @darrenkuro