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.