Market Public API
The Market Public API provides access to prediction market events, markets, and related information. Most endpoints are publicly accessible without authentication.
Base URL: https://market-api.probable.markets
API Version: 1.0.0
Overview
This API allows you to:
- Browse and search events and markets
- Get detailed information about specific events and markets
- Filter by tags, status, and other criteria
Authentication
All endpoints are public and do not require authentication.
Rate Limiting
Results are cached using Redis:
- Event listings: 5 minutes
- Market listings: 3 minutes
- Individual events/markets: 2 minutes
- Search results: 3 minutes (when cache=true)
Endpoints
Events
- List Events - Get paginated list of events
- Get Event by ID - Get event details by numeric ID
- Get Event by Slug - Get event details by slug
- Get Event Tags - Get tags for an event
Markets
- List Markets - Get paginated list of markets
- Get Market by ID - Get market details by ID
- Get Market by Polymarket ID - Get market by Polymarket identifier
- Get Market by BSC Question ID - Get market by BSC question ID
Tags
- List Tags - Get all available tags
Search
- Search Events and Markets - Full-text search with filtering
Response Format
All endpoints return JSON responses. Paginated endpoints include a pagination object with metadata about the results.