Public API
REST API keys for programmatic access (Bot plan)
The Predite Public API lets you read your own data programmatically — your live portfolio and the latest Expected Value signals — from your own scripts, spreadsheets, or trading tools. It is a read-only REST API secured with a personal API key, available on the Bot plan.
You create and manage keys from the dashboard, under Settings, on the API page.
Creating an API key
Give the key a label (for example, "sheet import" or "backtest script") and create it. A few things to know:
- •The full key is shown only once, at creation. It looks like pdt_live_ followed by a random string. Copy it immediately and store it somewhere safe — it is never displayed again, because only a hash of it is kept on our servers.
- •After creation, the dashboard shows just the key's short prefix so you can tell your keys apart.
- •Each key is read-only and expires one year after it is created. You are reminded before it lapses.
- •You can revoke a key at any time. Revocation takes effect immediately — any script still using it starts receiving 401 Unauthorized.
Authenticating
Send the key as a Bearer token in the Authorization header of every request:
Authorization: Bearer pdt_live_your_key_here
A missing or invalid key returns HTTP 401. Requests are rate limited to 120 per minute per key; go over and you receive HTTP 429 with a Retry-After header telling you how many seconds to wait. That ceiling is generous for any sane use — cache what you fetch, since none of this data changes second to second.
Endpoints
Two GET endpoints are available today, both returning JSON.
GET /api/v1/portfolio
Returns the open positions of the Polymarket wallet connected to your account, along with a summary and a generated_at timestamp. If you have not connected and verified a wallet yet, the positions array comes back empty with an error of no_wallet_connected — connect one first (see Connecting a Wallet).
GET /api/v1/signals
Returns the current top Expected Value signals, ordered by edge. Two optional query parameters:
- •limit — how many signals to return, from 1 to 100 (default 20)
- •min_edge — the minimum edge in percentage points (default 5)
The response includes the signals array, a count, the filters you used, and a generated_at timestamp.
Every signal here is an AI model's estimate. When no model answered, the scanner still shows its formula estimate in the dashboard, labeled as formula, but publishes no signal from it — so nothing reaches this endpoint, webhooks, alerts or Telegram. Each signal carries ai_source, which is "llm" for every signal published since 24 October 2026.
Example
A minimal request with curl, asking for the ten strongest signals with at least six points of edge:
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Good to know
- •The API is read-only — there are no trading or write endpoints. Orders are always placed from the app, so a leaked key can never move your money.
- •Even so, treat the key like a password. If it leaks, revoke it and issue a new one.
- •Prefer alerts pushed to you over polling? Link your account to Telegram and let signals come to you.