polymarket-clob-client

Place and cancel Polymarket orders via the CLOB v2 API with HMAC authentication.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/Aradotso/devtools-skills --skill polymarket-clob-client
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket-clob-client
Source: https://github.com/Aradotso/devtools-skills/tree/main/skills/polymarket-clob-client
Command: npx skills add https://github.com/Aradotso/devtools-skills --skill polymarket-clob-client

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you programmatically place, cancel, and manage orders on Polymarket’s prediction markets without manually interacting with the UI.

Core Features & Use Cases

  • Two-level authentication: uses wallet signature (L1) to create/derive API keys, then uses HMAC credentials (L2) for trading operations.
  • Order creation for limit and market trading: supports limit orders plus market orders with FOK/FAK execution styles.
  • Market data + account management: fetches order books, markets, tickers, trades, balances, and positions for strategy automation.
  • Use Case: build a simple market-making bot that periodically reads the best bid/ask, calculates spread, cancels stale orders, and re-quotes around the mid price.

Quick Start

Use the polymarket-clob-client to create an authenticated client, then call createAndPostOrder to place a limit BUY order on the Polymarket CLOB for a specific tokenID.

Frequently Asked Questions about polymarket-clob-client

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place automated trades on Polymarket prediction markets using code?

You can place automated trades on Polymarket prediction markets by using a TypeScript SDK that handles wallet-based API credential derivation and HMAC-authenticated trading calls to submit limit and market orders via the CLOB v2 API.

What is two-level authentication for Polymarket CLOB API trading?

Two-level authentication for Polymarket CLOB API trading uses a wallet signature (L1) to create or derive API keys, followed by HMAC credentials (L2) to authorize actual trading operations like placing and canceling orders.

How do I build a market-making bot for Polymarket?

To build a market-making bot for Polymarket, periodically fetch the order book to read the best bid/ask, calculate the spread, cancel stale orders, and re-quote around the mid price using authenticated CLOB API limit orders.

Do I need a viem wallet client to trade on Polymarket programmatically?

Yes, you need a viem wallet client to trade on Polymarket programmatically. You must integrate the clob-client-v2 by correctly supplying the chain, host, signer, and ApiKeyCreds for authenticated trading operations.

Can I execute FOK or FAK market orders on the Polymarket CLOB?

Yes, you can execute FOK (Fill or Kill) and FAK (Fill and Kill) market orders on the Polymarket CLOB. The SDK supports creating both limit orders and market orders with these specific execution styles.

What market data and account information can I retrieve for trading strategy automation?

For trading strategy automation, you can retrieve order books, markets, tickers, trades, balances, and positions from the Polymarket CLOB API to inform your bot's pricing and risk management logic.