> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polytape.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PolyTape for agents

> The Polymarket trader-intelligence layer for you and your AI agent. Every trader's full on-chain history, over MCP or REST.

**The Polymarket trader-intelligence layer for you and your AI agent.**

Point an agent at a Polymarket wallet and it can read that trader's whole
on-chain career: every market they touched, how they sized, when they got in,
what it cost them, and whether the record reads like skill or luck.

Two surfaces, one key, one budget:

<Columns cols={2}>
  <Card title="MCP" icon="plug" href="/mcp/overview">
    `https://api.polytape.io/mcp` — 13 tools and a `crack_this_trader` prompt for
    Claude Code, claude.ai, Cursor, opencode, and any MCP client.
  </Card>

  <Card title="REST" icon="terminal" href="/rest/overview">
    `https://api.polytape.io/api/agent/v1` — every read is a GET. For scripts,
    cron jobs, and anything that curls JSON.
  </Card>
</Columns>

<Card title="Start here" icon="rocket" href="/quickstart" horizontal>
  Three ways in — the claude.ai connector, an MCP client, or a raw key — in under
  five minutes.
</Card>

## What you can ask it

| Question                                                   | Where to start                                                |
| ---------------------------------------------------------- | ------------------------------------------------------------- |
| "How does this trader actually trade? What's their edge?"  | [Crack a trader](/guides/recipes#crack-a-trader)              |
| "Which of these two is better — do they overlap?"          | [Compare traders](/guides/recipes#compare-two-traders)        |
| "What happened in this market, and where did they get in?" | [Read a market's tape](/guides/recipes#read-one-markets-tape) |
| "Chart it / show me their equity curve"                    | [Plotting](/guides/plotting)                                  |
| "Has this wallet done anything new?"                       | [Monitor a wallet](/guides/recipes#monitor-a-wallet)          |

## What's underneath

The archive is our own indexed copy of both Polymarket V2 exchanges — roughly
**500M ticks across 1.7M markets**, keyed by trader. Every price point the API
returns is a level that actually traded; the server never emits a computed
price. The line an agent draws is byte-for-byte the line the PolyTape web app
draws.

## Read this before you quote a number

Three P/L figures live on this API and they answer different questions. Quoting
the wrong one is the single most common way to be confidently wrong about a
trader.

<Card title="Reading the numbers" icon="scale-balanced" href="/concepts/pnl" horizontal>
  `polymarket.pnl` is THE P/L. The chain-audited figures are the audit voice, and
  they read more negative on anyone holding an open book. Two minutes here saves
  a wrong verdict.
</Card>

## The shape of the thing

<Note>
  **V1 is read-only by construction.** Every endpoint is a GET, every MCP tool is
  a read. There are no writes, no orders, and no trading. A key cannot even mint
  another key — that is a dashboard action.
</Note>

* `{trader}` accepts a **0x wallet**, a **polymarket.com profile URL**, or a
  **display name** (e.g. `GoingInsolvent`). Responses always echo the canonical
  wallet and name.
* Timestamps are epoch **seconds**. Money fields are USD, suffixed `_usd`.
  Prices are UP-normalized (0–1).
* Pagination is cursor-based and forward-only.
* History depth and daily trader lookups are plan-gated — see
  [Plans & limits](/plans-and-limits).

## Machine-readable entry points

If you would rather hand your agent a file than a docs site:

<Columns cols={3}>
  <Card title="llms.txt" href="https://polytape.io/llms.txt" icon="file-lines">
    The whole data plane in one page.
  </Card>

  <Card title="Agent skill" href="https://polytape.io/skill/SKILL.md" icon="graduation-cap">
    Skill format, with references and chart templates.
  </Card>

  <Card title="OpenAPI" href="https://api.polytape.io/api/agent/v1/openapi.json" icon="brackets-curly">
    Every parameter and response schema.
  </Card>
</Columns>