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.
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.