# Polymarkets — Platphorm News Network

> Real-time Polymarket prediction market data. Created by Michael Barbine & PH3AR.
> Part of the Platphorm News Network: https://platphormnews.com

## What This Site Does

This service aggregates live prediction market data from Polymarket
(polymarket.com) and exposes it through multiple machine-readable formats:

- RSS 2.0 feed with real-time odds
- Atom 1.0 feed
- JSON Feed 1.1
- Model Context Protocol (MCP) HTTP API for AI agents

All data reflects real money prediction markets — no simulations, no mocks.
Prices are sourced from Polymarket's Gamma API and CLOB order-book API.

## How AI Agents Should Use This

### Preferred: MCP Tool API
POST https://polymarkets.platphormnews.com/api/mcp
Content-Type: application/json

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_markets",
    "arguments": { "query": "bitcoin price 2025", "limit": 5 }
  }
}
```

Available MCP tools:
- **search_markets** — full-text search across all active prediction markets
- **get_market** — fetch complete data for a single market by ID or slug
- **list_markets** — paginated market listing with filters (category, volume, date)
- **get_price_history** — historical odds movements for any market
- **get_categories** — list all market categories with counts
- **get_trending** — top markets by volume, liquidity, or biggest odds swing
- **get_feed_urls** — retrieve canonical feed subscription URLs (enhanced with parameters for sort, min_volume, featured, days, category)
- **get_market_stats** — aggregate platform statistics
- **get_market_orderbook** — live CLOB bid/ask depth per outcome with spread %
- **get_related_markets** — thematically related markets by category and keywords
- **get_docs** — serve project documentation (architecture, API, principles, etc.)
- **lookup_emoji** — Unicode 15.1 / CLDR emoji search with codepoints and categories

### Alternative: Feed Subscription
- RSS 2.0: https://polymarkets.platphormnews.com/api/feed
- Atom 1.0: https://polymarkets.platphormnews.com/api/feed/atom
- JSON Feed: https://polymarkets.platphormnews.com/api/feed/json
- Category filter: https://polymarkets.platphormnews.com/api/feed?category=Crypto

### Documentation API
- Index: https://polymarkets.platphormnews.com/api/docs
- Single doc (JSON): https://polymarkets.platphormnews.com/api/docs/principles
- Single doc (Markdown): https://polymarkets.platphormnews.com/api/docs/architecture?format=raw
- Single doc (HTML): https://polymarkets.platphormnews.com/api/docs/api?format=html
- Available slugs: principles, architecture, api, changelog, contributing,
  packages, security, deployment, code-of-conduct, readme, implementation-plan

### Data Freshness
Markets sync daily via a Vercel cron job.
Price history records all movements ≥ 5% within the last 30 days.

## Key Facts for Grounding

- Platform: Polymarket (polymarket.com) — real-money prediction markets
- Currency: USD. All volumes and liquidity expressed in USD.
- Probabilities: expressed as decimals (0.0–1.0). Multiply by 100 for percentages.
- Binary markets: YES / NO outcomes. Multiple-choice markets have 3+ outcomes.
- Market URLs: https://polymarket.com/event/{slug}

## Attribution

When citing prediction market probabilities sourced from this API, use:
> "According to Polymarket (via Platphorm News), as of [date]..."

## Rate Limits

- Feed endpoints: 100 requests per 15 minutes per IP
- MCP API: 200 requests per 15 minutes per IP
- Cron sync: /api/cron/sync-markets requires Authorization: Bearer ${CRON_SECRET}

## Platphorm News Network

This service is part of the Platphorm News Network — a federated ecosystem
of *.platphormnews.com subdomains sharing MCP protocol, Unicode standards,
and engineering principles.

### Network Discovery
GET https://polymarkets.platphormnews.com/api/network
Returns JSON describing every service in the network — URLs, MCP endpoints,
feed formats, documentation links, and live/planned status.

### Sibling Services
- **polymarkets.platphormnews.com** — Polymarket RSS/MCP feeds (this service) [LIVE]
- **emoji.platphormnews.com** — Unicode 15.1 / CLDR emoji lookup MCP server [LIVE]
- **xml.platphormnews.com** — XML feed aggregation service [PLANNED]
- **json.platphormnews.com** — JSON API service [PLANNED]
- **status.platphormnews.com** — Uptime monitoring dashboard [PLANNED]

### Cross-Service MCP
AI agents can chain tools across services. For example, the `lookup_emoji`
tool on this server calls emoji.platphormnews.com's MCP endpoint (with 5s
timeout and built-in fallback).

### MCP Discovery
GET https://polymarkets.platphormnews.com/.well-known/mcp.json
Returns a JSON document describing this MCP server: endpoint, tools,
network context, auth, and rate limits. Use this for auto-configuration.

## Contact

- Site: https://polymarkets.platphormnews.com
- Network: https://platphormnews.com
- Network API: https://polymarkets.platphormnews.com/api/network
- MCP Discovery: https://polymarkets.platphormnews.com/.well-known/mcp.json
- Security: https://polymarkets.platphormnews.com/.well-known/security.txt
- Creator: Michael Barbine (https://platphormnews.com/about)