Predict Public API
Predict’s public APIs provide unauthenticated access to catalog, account, outcome market-data, and order queue reads. Use REST for request-response access and recovery snapshots, then subscribe to the realtime API for matching live state.
Base URL
Send public API requests to the staging base URL:
What you can build
Use the API to:
- Browse topics, categories, and series that organize the Predict catalog.
- Discover active or settled events and their associated participants.
- Resolve events to outcomes, external provider identities, prices, trades, holders, statistics, and timeseries.
- Read account profiles, open positions and orders, fills, activity, cashflows, PnL, volume, and fees.
- Track current order queue position and subscribe to normalized updates over one WebSocket.
- Read the Hyperliquid identifiers required by direct trading clients.
From catalog data to trading
An outcome is the tradable object in the catalog. After deployment, its hl_id identifies the corresponding Hyperliquid market used by the Predict TypeScript client to place and cancel orders.
Continue with the Predict API quick start, connect to the realtime API, or browse the Predict REST API reference.