polymarket-api

Route Polymarket tasks to the appropriate API surface with endpoint and authentication guidance.

1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/cavit99/codex-skill-library --skill polymarket-api-cavit99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket-api
Source: https://github.com/cavit99/codex-skill-library/tree/main/polymarket-api
Command: npx skills add https://github.com/cavit99/codex-skill-library --skill polymarket-api-cavit99

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Polymarket exposes multiple surfaces (Gamma, Data, CLOB, Bridge, Relayer, WebSocket, RTDS). This skill helps Codex determine the right surface for a given task and provides safe routing guidance and sample workflows.

Core Features & Use Cases

  • End-to-end routing guidance to identify the appropriate API surface (discovery, market data, trading, streaming, or funding) and recommended SDKs.
  • Authoritative endpoint lookups, authentication considerations, rate-limit guidance, and geoblock checks for trading flows.
  • Quick-start workflows and example prompts to generate safe, task-specific requests or code scaffolds.

Quick Start

Route a task to the Polymarket API surface and generate a starter request example.

Frequently Asked Questions about polymarket-api

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

FAQPage Schema
How do I choose the right Polymarket API surface for tasks like trading or market discovery?

To choose the right Polymarket API surface, identify your task scope—such as discovery, positions, trading, streaming, or funding. The correct surface (Gamma, Data, CLOB, Bridge, Relayer, WebSocket, or RTDS) is determined by matching your specific scenario to the optimal routing path.

What's the best way to authenticate and handle rate limits for Polymarket CLOB API trading?

The best way to handle rate limits and authentication for Polymarket trading is to follow safe routing guidance that includes endpoint lookups, geoblock checks, and production-ready guardrails to ensure secure CLOB API transactions.

How does Polymarket WebSocket streaming work for real-time market data?

Polymarket WebSocket streaming works by utilizing the RTDS surface to provide real-time data. You route streaming tasks to this specific surface to receive continuous market updates rather than polling static endpoints.

Can I use official SDKs to interact with Polymarket API endpoints?

Yes, you can use recommended official SDKs to interact with Polymarket API endpoints. The routing guidance specifies which SDKs to use for specific surfaces and provides quick-start workflows to generate safe, task-specific code scaffolds.

When should I use the Gamma API versus the Data API for Polymarket positions and analytics?

You should use the Gamma API for market discovery and the Data API for positions and analytics. Selecting between them depends on whether your task requires finding active markets or retrieving detailed historical performance data.