Manifold APImanifold.markets ↗
Search Manifold Markets prediction markets by keyword. Get probabilities, trading volume, resolution status, and creator info via a single endpoint.
What is the Manifold API?
The Manifold Markets API exposes 1 endpoint — search_markets — that returns up to hundreds of prediction markets matching a keyword query, including 10+ fields per market such as current probability, outcome type, trading volume, 24-hour volume, total liquidity, resolution status, and creator details. It supports sorting by score, newest, or liquidity, and filters for open, closed, or resolved markets.
curl -X GET 'https://api.parse.bot/scraper/70abd972-e3f0-4c0c-9426-6d3f743bb5da/search_markets?sort=score&term=AI&limit=5&filter=all&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace manifold-markets-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.manifold_markets_search_api import Manifold, Sort, MarketFilter
client = Manifold()
# Search for open AI-related prediction markets sorted by liquidity
for market in client.markets.search(term="AI", sort=Sort.LIQUIDITY, filter=MarketFilter.OPEN):
print(market.question, market.probability, market.volume, market.creator_username)
Search for prediction markets by keyword. Returns market details including probabilities, trading volume, creator info, and resolution status. Paginates via offset. Each market carries a probability (null for multiple-choice), volume metrics, bettor counts, and timestamps. An empty term returns trending/top markets in the chosen sort order.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order for results. |
| term | string | Search query term. |
| limit | integer | Maximum number of results to return. |
| filter | string | Filter markets by resolution status. |
| offset | integer | Offset for pagination (0-based). |
{
"type": "object",
"fields": {
"sort": "string - sort order used",
"term": "string - search term used",
"count": "integer - number of results returned",
"filter": "string - filter used",
"offset": "integer - current pagination offset",
"markets": "array of Market objects with id, question, slug, url, probability, outcomeType, mechanism, volume, volume24Hours, totalLiquidity, isResolved, uniqueBettorCount, createdTime, closeTime, lastUpdatedTime, lastBetTime, creatorUsername, creatorName, token, pool"
},
"sample": {
"data": {
"sort": "score",
"term": "AI",
"count": 5,
"filter": "all",
"offset": 0,
"markets": [
{
"id": "A319ydGB1B7f4PMOROL3",
"url": "https://manifold.markets/ScottAlexander/in-2028-will-an-ai-be-able-to-gener",
"pool": {
"NO": 18005.04,
"YES": 25704.49
},
"slug": "in-2028-will-an-ai-be-able-to-gener",
"token": "MANA",
"volume": 12257430.16,
"question": "In early 2028, will an AI be able to generate a full high-quality movie to a prompt?",
"closeTime": 1830412740000,
"mechanism": "cpmm-1",
"isResolved": false,
"createdTime": 1676933242898,
"creatorName": "Scott Alexander",
"lastBetTime": 1781132993004,
"outcomeType": "BINARY",
"probability": 0.314,
"volume24Hours": 8253.73,
"totalLiquidity": 20916,
"creatorUsername": "ScottAlexander",
"lastUpdatedTime": 1781132993004,
"uniqueBettorCount": 4477
}
]
},
"status": "success"
}
}About the Manifold API
What the API Returns
The search_markets endpoint queries the Manifold Markets platform for prediction markets matching a keyword term. Each market object in the response includes core identifiers (id, slug, url), the market question, the current probability, outcomeType (e.g. binary, multiple choice), and the mechanism used for trading. Volume data is available both all-time (volume) and over the last 24 hours (volume24Hours), alongside totalLiquidity. Resolution status and creator info are also returned.
Sorting, Filtering, and Pagination
Results can be sorted using the sort parameter: score (default relevance ranking), newest, or liquidity. The filter parameter narrows results to all, open, closed, or resolved markets. Pagination is handled via offset (0-based integer) combined with limit. The response echoes back sort, term, filter, and offset so you can confirm the parameters used, along with a count of how many results were returned in that page.
Response Shape
The top-level response object contains metadata fields (sort, term, count, filter, offset) and a markets array. Each element of markets is a market object. The probability field is a float between 0 and 1 representing the current crowd-estimated probability for binary markets. volume24Hours is useful for identifying currently active or trending markets. Fields like outcomeType and mechanism distinguish binary yes/no markets from multi-outcome or other formats.
The Manifold API is a managed, monitored endpoint for manifold.markets — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when manifold.markets changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official manifold.markets API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track the current probability of political or economic event markets in real time using the
probabilityfield - Build a trending-markets dashboard by sorting on
liquidityor filtering toopenmarkets with highvolume24Hours - Aggregate resolved market outcomes by querying with
filter=resolvedto analyze forecasting accuracy over time - Monitor creator activity by extracting creator info from market objects returned by keyword searches
- Identify newly listed prediction markets by sorting with
sort=newestand paginating through results - Power a topic-specific research feed by querying
termwith subject keywords and filtering to open markets
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Manifold Markets have an official developer API?+
What does the `search_markets` endpoint return for each market?+
id, question, slug, url, current probability, outcomeType, mechanism, all-time volume, volume24Hours, totalLiquidity, resolution status, and creator info. The top-level response also echoes the sort, term, filter, offset, and count used for the query.How does pagination work with this API?+
limit to control how many markets are returned per request and increment offset by that amount to fetch the next page. The response includes a count field showing how many results were returned, which you can use to detect when you've reached the last page.Can I retrieve individual market details or a user's portfolio through this API?+
Does the `probability` field apply to all market types?+
probability field is most directly applicable to binary (yes/no) markets. For markets with outcomeType values indicating multiple outcomes, the field may be absent or represent only one outcome's probability. The outcomeType and mechanism fields in each market object let you identify the market format before relying on probability.