REST APIMarkets
Get markets
GET
Get information about markets with optional filters and sorting.
ApiKeyAuthheader
x-api-key<token>API key authentication via the x-api-key header.
first?integerPage size, from 1 to 100. Defaults to 20. A value outside that range is clamped.
Format
int32after?stringThe cursor from the previous page, to get the next one.
Length
length <= 1024isBoosted?booleanDeprecatedDeprecated. Boosts are no longer used.
hasActiveRewards?booleanOnly markets with a reward period running now (true), or only markets without
one (false). Omit it to get both.
status?stringOnly open or only resolved markets. Paused markets count as neither, so they are only listed when this is omitted.
Value in
"OPEN""RESOLVED"tagIds?stringOnly markets whose category has at least one of these tag IDs, comma-separated. Entries that are not numbers are ignored.
marketVariant?stringOnly markets of this variant.
Value in
"DEFAULT""SPORTS_MATCH""CRYPTO_UP_DOWN""TWEET_COUNT""SPORTS_TEAM_MATCH""SPORTS_NBA""SPORTS_FIFA_WORLD_CUP""SPORTS_EXACT_SCORE""SPORTS_HALFTIME_RESULT""SPORTS_PROPS""SPORTS_FIFA_FRIENDLIES""ESPORTS_LOL""ESPORTS_CS2""ESPORTS_DOTA2""SPORTS_FIRST_TO_SCORE""SPORTS_TOTAL_CORNERS""SPORTS_SECOND_HALF_RESULT""UP_DOWN"sort?stringWithout it, markets are grouped by category, with categories in the platform's own ranking and markets in their order within the category.
Value in
"CHANCE_24H_CHANGE_ASC""CHANCE_24H_CHANGE_DESC""VOLUME_24H_ASC""VOLUME_24H_DESC""VOLUME_24H_CHANGE_ASC""VOLUME_24H_CHANGE_DESC""VOLUME_TOTAL_ASC""VOLUME_TOTAL_DESC""REWARD_RATE_ASC""REWARD_RATE_DESC"includeStats?booleanWhether to fill in stats with volume and liquidity figures. Defaults to false,
which leaves stats null.
application/json; charset=utf-8- response
Response for GET /v1/markets
success*booleancursor?stringdata*array<>curl -X GET 'https://api.predict.fun/v1/markets'Example Response
{ "success": true, "cursor": "string", "data": [ { "id": 0, "imageUrl": "string", "title": "string", "question": "string", "description": "string", "tradingStatus": "OPEN", "status": "REGISTERED", "isVisible": true, "isNegRisk": true, "isYieldBearing": true, "feeRateBps": 0, "makerFeeBps": 0, "resolution": { "name": "string", "indexSet": 0, "onChainId": "string", "status": "WON", "bestBid": { "price": 0.1, "size": 0.1 }, "bestAsk": { "price": 0.1, "size": 0.1 }, "team": { "id": 0, "name": "string", "abbreviation": "string", "alias": "string", "league": "string" }, "variantData": { "type": "ESPORTS_DOTA2", "provider": "PREDICT_SPORTS", "team": { "id": 0, "name": "string", "abbreviation": "string", "providerTeamId": "string", "isHome": true, "record": { "wins": 0, "losses": 0, "draws": 0, "overtimeLosses": 0 }, "color": "string" } }, "variantDetails": { "sports": { "provider": "PREDICT_SPORTS", "team": { "id": 0, "name": "string", "abbreviation": "string", "providerTeamId": "string", "isHome": true, "record": { "wins": 0, "losses": 0, "draws": 0, "overtimeLosses": 0 }, "color": "string" } } } }, "oracleQuestionId": "string", "conditionId": "string", "resolverAddress": "string", "outcomes": [ { "name": "string", "indexSet": 0, "onChainId": "string", "status": "WON", "bestBid": { "price": 0.1, "size": 0.1 }, "bestAsk": { "price": 0.1, "size": 0.1 }, "team": { "id": 0, "name": "string", "abbreviation": "string", "alias": "string", "league": "string" }, "variantData": { "type": "ESPORTS_DOTA2", "provider": "PREDICT_SPORTS", "team": { "id": 0, "name": "string", "abbreviation": "string", "providerTeamId": "string", "isHome": true, "record": { "wins": 0, "losses": 0, "draws": 0, "overtimeLosses": 0 }, "color": "string" } }, "variantDetails": { "sports": { "provider": "PREDICT_SPORTS", "team": { "id": 0, "name": "string", "abbreviation": "string", "providerTeamId": "string", "isHome": true, "record": { "wins": 0, "losses": 0, "draws": 0, "overtimeLosses": 0 }, "color": "string" } } } } ], "questionIndex": 0, "spreadThreshold": 0.1, "shareThreshold": 0, "isBoosted": true, "boostStartsAt": "string", "boostEndsAt": "string", "polymarketConditionIds": [ "string" ], "kalshiMarketTicker": "string", "categorySlug": "string", "seriesSlug": "string", "createdAt": "string", "decimalPrecision": 0, "marketVariant": "DEFAULT", "variantData": { "type": "CRYPTO_UP_DOWN", "priceFeedProvider": "PYTH", "startPrice": 0.1, "endPrice": 0.1, "priceFeedId": "string", "priceFeedSymbol": "string" }, "variantDetails": { "sports": { "provider": "PREDICT_SPORTS", "team": { "id": 0, "name": "string", "abbreviation": "string", "providerTeamId": "string", "isHome": true, "record": { "wins": 0, "losses": 0, "draws": 0, "overtimeLosses": 0 }, "color": "string" }, "line": 0.1, "gameNumber": 0 } }, "team": { "id": 0, "name": "string", "abbreviation": "string", "alias": "string", "league": "string" }, "marketType": "SPORTS_MONEYLINE", "rewards": { "current": { "hourlyRate": 0, "startsAt": "string", "endsAt": "string" }, "schedule": [ { "hourlyRate": 0, "startsAt": "string", "endsAt": "string" } ] }, "stats": { "totalLiquidityUsd": 0.1, "liquidity3cAskUsd": 0.1, "volumeTotalUsd": 0.1, "volume24hUsd": 0.1 } } ]}