Polymarket website screenshot

Polymarket

Polymarket is a decentralized prediction-market platform built on Polygon where users buy and sell binary outcome shares in real-world events. Settlement is on-chain via the UMA optimistic oracle, while order matching runs through a hybrid central-limit order book (CLOB). Developer surface includes the CLOB API for order placement and market data, the Gamma API for market and event metadata, a Data API for historical and analytical reads, a WebSocket stream, and official CLOB client SDKs in TypeScript, Python, and Rust.

Polymarket publishes 5 APIs on the APIs.io network, including WebSocket, CLOB Market Data API, CLOB Trade API, and 2 more. Tagged areas include Prediction Markets, DeFi, Polygon, Order Book, and Crypto.

The Polymarket catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Polymarket’s developer surface includes authentication, documentation, GitHub presence, support, status page, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub
43.3/100 developing ▬ flat Agent 36/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreeSelf serve⚡ Free to try
11 APIs
Prediction MarketsDeFiPolygonOrder BookCryptoMarkets

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 43.3/100 · developing
Contract Quality 16.9 / 25
Developer Ergonomics 4.8 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 3.4 / 13
Governance 5.0 / 12
Discoverability 7.4 / 10
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/polymarket: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Polymarket CLOB API

Central-limit order book REST API for Polymarket - place, cancel, and query orders, list markets and tokens, fetch order books and trades, and look up user positions. Used by tr...

Polymarket Gamma API

Read-only metadata API for markets, events, tags, and categories - the surface that powers polymarket.com's listings and search. Useful for discovery and for stitching multiple ...

Polymarket Data API

Historical and analytical data API exposing trades, prices, volumes, holders, and time-series aggregates across Polymarket markets, intended for research, dashboards, and quanti...

Polymarket WebSocket

Real-time streaming feed for order book updates, trades, and market events on the Polymarket CLOB - used by trading clients to maintain a live view of the book without polling.

py-clob-client (Python SDK)

Official Python SDK for the Polymarket CLOB API - wallet signing, EIP-712 order construction, place / cancel / query, and market data helpers.

clob-client (TypeScript SDK)

Official TypeScript / JavaScript SDK for the Polymarket CLOB API - typed clients, wallet integration (viem), order construction, and market data helpers.

clob-client (Rust SDK)

Official Rust SDK for the Polymarket CLOB API.

Polymarket CLOB Market Data API

Public CLOB market data.

Polymarket CLOB Trade API

Order placement and management on the central-limit order book.

Polymarket Gamma Events API

Read-only event metadata.

Polymarket Gamma Markets API

Read-only market metadata.

Scroll for all 11

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Polymarket APIs (CLOB and Gamma)

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Polymarket Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Polymarket Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Polymarket Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Polymarket CLOB WebSocket API

Real-time streaming feed for Polymarket's central-limit order book (CLOB). Two channels are exposed: a public market channel that streams order book snapshots, price level updat...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Polymarket API Rules

6 rules · 1 errors 5 warnings

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Polymarket Authentication

apiKey · 1 scheme

SECURITY

Polymarket Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Polymarket Agentic Access

5 operations · 1 acting

5 operations · 1 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 US Documentation
US Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LlmsText
LlmsText

Build 1

SDKs, sample code, and the tooling you integrate with

GitHub
GitHub

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

Support
Support
 Status
Status

Company 2

The organization behind the API

Website
Website
 LinkedIn
LinkedIn

Other 1

Properties that don't map to a standard resource type

Builders Program
Builders Program

Source (apis.yml)

apis.yml Raw ↑ 
aid: polymarket
url: https://raw.githubusercontent.com/api-evangelist/polymarket/refs/heads/main/apis.yml
name: Polymarket
kind: company
description: Polymarket is a decentralized prediction-market platform built on Polygon where users buy and sell binary outcome
  shares in real-world events. Settlement is on-chain via the UMA optimistic oracle, while order matching runs through a hybrid
  central-limit order book (CLOB). Developer surface includes the CLOB API for order placement and market data, the Gamma
  API for market and event metadata, a Data API for historical and analytical reads, a WebSocket stream, and official CLOB
  client SDKs in TypeScript, Python, and Rust.
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/polymarket.png
tags:
- Prediction Markets
- DeFi
- Polygon
- Order Book
- Crypto
- Markets
created: '2026-05-23'
modified: '2026-05-29'
specificationVersion: '0.19'
apis:
- aid: polymarket:clob-api
  name: Polymarket CLOB API
  description: Central-limit order book REST API for Polymarket - place, cancel, and query orders, list markets and tokens,
    fetch order books and trades, and look up user positions. Used by traders and bots interacting with Polymarket's matched
    markets.
  humanURL: https://docs.polymarket.com/
  baseURL: https://clob.polymarket.com
  tags:
  - REST
  - Orders
  - Order Book
  - Markets
  properties:
  - type: Documentation
    url: https://docs.polymarket.com/
- aid: polymarket:gamma-api
  name: Polymarket Gamma API
  description: Read-only metadata API for markets, events, tags, and categories - the surface that powers polymarket.com's
    listings and search. Useful for discovery and for stitching multiple binary markets into the broader events they belong
    to.
  humanURL: https://docs.polymarket.com/
  baseURL: https://gamma-api.polymarket.com
  tags:
  - REST
  - Markets
  - Events
  - Metadata
  properties:
  - type: Documentation
    url: https://docs.polymarket.com/
- aid: polymarket:data-api
  name: Polymarket Data API
  description: Historical and analytical data API exposing trades, prices, volumes, holders, and time-series aggregates across
    Polymarket markets, intended for research, dashboards, and quantitative use.
  humanURL: https://docs.polymarket.com/
  baseURL: https://data-api.polymarket.com
  tags:
  - Data
  - Historical
  - Analytics
  properties:
  - type: Documentation
    url: https://docs.polymarket.com/
- aid: polymarket:websocket
  name: Polymarket WebSocket
  description: Real-time streaming feed for order book updates, trades, and market events on the Polymarket CLOB - used by
    trading clients to maintain a live view of the book without polling.
  humanURL: https://docs.polymarket.com/
  baseURL: wss://ws-subscriptions-clob.polymarket.com
  tags:
  - WebSocket
  - Streaming
  - Order Book
  properties:
  - type: Documentation
    url: https://docs.polymarket.com/
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/polymarket/refs/heads/main/asyncapi/polymarket-asyncapi.yml
- aid: polymarket:py-clob-client
  name: py-clob-client (Python SDK)
  description: Official Python SDK for the Polymarket CLOB API - wallet signing, EIP-712 order construction, place / cancel
    / query, and market data helpers.
  humanURL: https://github.com/Polymarket/py-clob-client
  baseURL: https://github.com/Polymarket/py-clob-client
  tags:
  - SDK
  - Python
  - CLOB
  properties:
  - type: Repository
    url: https://github.com/Polymarket/py-clob-client
- aid: polymarket:clob-client-ts
  name: clob-client (TypeScript SDK)
  description: Official TypeScript / JavaScript SDK for the Polymarket CLOB API - typed clients, wallet integration (viem),
    order construction, and market data helpers.
  humanURL: https://github.com/Polymarket/clob-client
  baseURL: https://github.com/Polymarket/clob-client
  tags:
  - SDK
  - TypeScript
  - JavaScript
  - CLOB
  properties:
  - type: Repository
    url: https://github.com/Polymarket/clob-client
- aid: polymarket:clob-client-rust
  name: clob-client (Rust SDK)
  description: Official Rust SDK for the Polymarket CLOB API.
  humanURL: https://github.com/Polymarket/rust-clob-client
  baseURL: https://github.com/Polymarket/rust-clob-client
  tags:
  - SDK
  - Rust
  - CLOB
  properties:
  - type: Repository
    url: https://github.com/Polymarket/rust-clob-client
- aid: polymarket:polymarket-clob-market-data-api
  name: Polymarket CLOB Market Data API
  description: Public CLOB market data.
  humanURL: https://docs.polymarket.com/
  baseURL: https://clob.polymarket.com
  tags:
  - CLOB Market Data
  properties:
  - type: OpenAPI
    url: openapi/polymarket-clob-market-data-api-openapi.yml
- aid: polymarket:polymarket-clob-trade-api
  name: Polymarket CLOB Trade API
  description: Order placement and management on the central-limit order book.
  humanURL: https://docs.polymarket.com/
  baseURL: https://clob.polymarket.com
  tags:
  - CLOB Trade
  properties:
  - type: OpenAPI
    url: openapi/polymarket-clob-trade-api-openapi.yml
- aid: polymarket:polymarket-gamma-events-api
  name: Polymarket Gamma Events API
  description: Read-only event metadata.
  humanURL: https://docs.polymarket.com/
  baseURL: https://clob.polymarket.com
  tags:
  - Gamma Events
  properties:
  - type: OpenAPI
    url: openapi/polymarket-gamma-events-api-openapi.yml
- aid: polymarket:polymarket-gamma-markets-api
  name: Polymarket Gamma Markets API
  description: Read-only market metadata.
  humanURL: https://docs.polymarket.com/
  baseURL: https://clob.polymarket.com
  tags:
  - Gamma Markets
  properties:
  - type: OpenAPI
    url: openapi/polymarket-gamma-markets-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/polymarket-agentic-access.yml
- type: DomainSecurity
  url: security/polymarket-domain-security.yml
- type: Authentication
  url: authentication/polymarket-authentication.yml
- type: Website
  url: https://polymarket.com/
- type: Documentation
  url: https://docs.polymarket.com/
- type: US Documentation
  url: https://docs.polymarket.us/
- type: GitHub
  url: https://github.com/Polymarket
- type: Builders Program
  url: https://builders.polymarket.com/
- type: Support
  url: https://help.polymarket.com/
- type: Status
  url: https://status.polymarket.com/
- type: LinkedIn
  url: https://www.linkedin.com/company/polymarket/
- type: LlmsText
  url: https://docs.polymarket.us/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com