Quickstart

Get your API key and run your first query in 30 seconds.

1. Get an API key

Visit the dashboard and click Create API key. No email required — your API key is your identity.

curl -X POST https://api.polydata.live/v1/register

Response:

{
  "success": true,
  "data": {
    "api_key": "pd_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "plan": "free"
  }
}

Save your API key securely. It cannot be recovered if lost.

2. Make your first call

Authenticate using a Bearer token:

curl

curl https://api.polydata.live/v1/markets/stats \
  -H "Authorization: Bearer pd_live_xxxxx"

3. Fetch a historical orderbook

To query historical data, you need an asset_id — Polymarket’s outcome token ID. You can find one via the markets endpoint:

curl "https://api.polydata.live/v1/markets?limit=5"

Then fetch the orderbook at any moment:

curl

curl "https://api.polydata.live/v1/orderbook?asset_id=14335534604605453660922028185403381450252058807325037884132006055073174291257&timestamp=1776241000000" \
  -H "Authorization: Bearer pd_live_xxxxx"

4. Subscribe for historical data access

Free plan limits you to public stats only. To access historical data, subscribe:

curl -X POST https://api.polydata.live/v1/billing/subscribe \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pd_live_xxxxx" \
  -d '{"plan": "monthly"}'

Response:

{
  "success": true,
  "data": {
    "invoice_url": "https://nowpayments.io/payment/?iid=xxx",
    "amount_usd": 59.9,
    "plan": "monthly"
  }
}

Open invoice_url in your browser, pay with USDT/USDC/BTC/ETH, and your account is upgraded automatically.

Next steps

Backtesting Guide

Build a backtest using historical tick data.

Slippage Simulation

Compute realistic fill prices for any order size.

Bulk Export

Download large date ranges efficiently.

API Reference

Full endpoint documentation.