Documentation Index Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
Use this file to discover all available pages before exploring further.
Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.
Query Parameters Text search query on market question and description.
JSON object with filter criteria. Accepted keys: platforms (comma-separated or array), categories (comma-separated or array), statuses (comma-separated or array), minVolume (number), minLiquidity (number). Example: {"platforms":"polymarket","categories":"crypto,politics","statuses":"active","minVolume":10000,"minLiquidity":5000}
sortBy
string
default: "volume24hUSD"
Sort field. Possible values: volume24hUSD (24h volume), totalVolumeUSD (all-time volume), liquidityUSD (current liquidity), createdAt (newest first), trendingScore (trending score).
Sort direction. asc or desc.
Number of markets to return (1 to 100).
Response Array of market search results. 24-hour trading volume in USD.
All-time trading volume in USD.
Current liquidity in USD.
Market end date in ISO 8601, or null if not set.
Market creation timestamp in ISO 8601.
Parent event identifier, if this market belongs to a grouped event.
null for standalone markets. Use with
/api/2/pm/event/details to fetch the full event.
Parent event URL-friendly slug. null for standalone markets.
Parent event title. null for standalone markets.
Array of outcome summaries. Pagination metadata. Current page number (1-indexed).
Number of items returned in this page.
Server hostname that handled the request.
Request processing time in milliseconds.
Usage Examples Search by keyword curl -X GET "https://api.mobula.io/api/2/pm/search?input=ethereum&sortBy=volume24hUSD&limit=10"
Filter by category and minimum volume curl -X GET 'https://api.mobula.io/api/2/pm/search?filters={"categories":"crypto","minVolume":10000}&sortBy=liquidityUSD'
Get active markets sorted by trending curl -X GET 'https://api.mobula.io/api/2/pm/search?filters={"statuses":"active"}&sortBy=trendingScore&limit=20'
Example Response { "data" : [ { "platform" : "polymarket" , "marketId" : "0x1234..." , "slug" : "will-eth-reach-10k-2026" , "question" : "Will ETH reach $10,000 by end of 2026?" , "category" : "crypto" , "status" : "active" , "logo" : "https://polymarket.com/images/market.png" , "volume24hUSD" : 45000 , "totalVolumeUSD" : 1250000 , "liquidityUSD" : 320000 , "openInterestUSD" : 580000 , "endDate" : "2026-12-31T23:59:59.000Z" , "createdAt" : "2026-01-15T00:00:00.000Z" , "tradesCount" : 8500 , "outcomes" : [ { "outcomeId" : "71321..." , "label" : "Yes" , "priceUSD" : 0.35 }, { "outcomeId" : "71322..." , "label" : "No" , "priceUSD" : 0.65 } ] } ], "pagination" : { "page" : 1 , "offset" : 0 , "limit" : 50 , "pageEntries" : 1 }, "hostname" : "node-xyz" , "took" : 42 }
