Developer docs · every surface, one page
One page, every integration surface: the REST API, the OpenAPI schema, the native MCP server, x402 pay-per-call authentication, the npm SDK, installable agent skills and the free sandbox. Each entry below is one or two sentences and a link — the full documentation lives at the linked path.
Integrate
Four HTTPS tools — order preflight, wallet copyability, leaderboard, red list — no account, no API key. Full reference with request and response shapes: /api (machine version: /api.md).
The complete schema for codegen and validation, straight from the live service: /openapi.json.
Native MCP over streamable-http at POST https://ticktape.cc/mcp — all tools plus a credits balance check. Server card: /.well-known/mcp/server-card.json; registry name cc.ticktape/mcp; also listed on Smithery.
Authentication is payment: no accounts, no API keys — each call is paid in USDC on Base via x402, or with prepaid credits. Flows, probe and token hygiene: /auth.md. Append ?x402_probe=1 to any paid endpoint to see the exact payment requirements without paying.
npm install ticktape — a typed JavaScript client that handles the x402 flow for you. Package: npmjs.com/package/ticktape; source: github.com/padak/ticktape-js.
Installable skills for agent harnesses. Hermes: hermes skills install well-known:https://ticktape.cc/.well-known/skills/ticktape; skills.sh: padak/ticktape-skills; ClawHub: polymarket-preflight. Index: /.well-known/skills/index.json.
Sandbox · free forever
Append sandbox=1 to any tool for a free deterministic example response — same schema as live, never rate-limited, never charged, safe for CI.
# deterministic, free, unlimited
curl "https://ticktape.cc/api/preflight_trade?sandbox=1"
Reference
Per call: preflight_trade, leaderboard and red_list $0.02; preflight_copy $0.10. $5 buys 500 credits at half the per-call price. Human rate card: /pricing; machine version: /pricing.md.
Live freshness at /status.json, dataset start dates and known gaps at /coverage.json, and the canonical fact sheet at /facts.json.
The canonical machine spec — tools, payment terms, payTo address, operator safety rules — is /llms.txt; the compact manifest is /agent.json.
The verification runbook at /why.md lets you audit our arithmetic against the live order book yourself — the full self-audit costs at most $0.12.
The full reference — request parameters, response shapes, the 402 payment trace and copy-paste agent setup — is one page.
Agent docs How verdicts are computed