Query the trades behind a wallet's results.

Use the API to inspect a wallet's trades and reconstruct its P&L with resolved losses included. You can also query market price history and resolutions, or subscribe to record a market's order books. Each endpoint below explains its request parameters and the limits you need to account for when using its results.

Send requests to https://polymarket.omray.dev and include your key in the X-API-Key header for data endpoints. The Free plan allows 100 requests per UTC day, while Builder allows 10,000 and Pro allows 100,000. Daily allowances reset at 00:00 UTC, and per-minute limits also apply, so use the response headers to pace your requests.

These reference pages come from the application's OpenAPI schema, which you can read at /openapi.json. Start with the endpoint for the data you need, then check its authentication and coverage details before making a request. Public trade history can be incomplete, so a successful response should not be treated as proof of a complete lifetime record.

Check Polymarket API health

GET /health

Inspect service health and background data-refresh status.

Calculate a Polymarket wallet's P&L

GET /wallets/{id}/pnl

Reconcile wallet trades with resolved outcomes, including losing positions absent from closed positions.

Get a Polymarket wallet's trade history

GET /wallets/{id}/trades

Fetch cached Polymarket wallet trades with pagination and history coverage.

Find Polymarket markets and resolved outcomes

GET /markets

Browse Polymarket market metadata with resumable pagination.

Get Polymarket historical prices

GET /markets/{id}/history

Query price history for both outcome tokens at a chosen fidelity.

Get a Polymarket order-book snapshot

GET /markets/{id}/book

Read live bids and asks for a Polymarket market.

Check the Polymarket leaderboard for hidden losses

GET /leaderboard/true-pnl

Get observed P&L and resolved losing inventory for the current top 50 monthly wallets.

Get Polymarket market resolutions

GET /resolutions

Query archived outcomes and resolved market metadata.

Record a Polymarket market's order books

PUT /subscriptions/{id}

Subscribe to ongoing order-book recordings for a market.

Stop a market's order-book recording

DELETE /subscriptions/{id}

Remove your order-book recording subscription.

Download recorded Polymarket order books

GET /subscriptions/{id}/books

Page through stored book snapshots captured during your recording access windows.

Check API plan and request usage

GET /account

View your API key's plan, daily allowance and current usage.

Create a free API key

POST /signup

Create a Free-plan key (100 requests a day). The key is shown once; the server stores only its hash. Limited to 3 signups per address per day.

Start a Builder or Pro subscription

POST /billing/checkout

Create an authenticated Stripe Checkout session for the API key's account.

Receive Stripe subscription updates

POST /billing/webhook

Verify signed Stripe subscription events and apply account plan changes.