Predict API (Beta)
  1. Markets
  • FAQs
  • Deployed Contracts
  • Guides
    • Understanding the Orderbook
    • [TS] How to authenticate your API requests
    • [PY] How to authenticate your API requests
    • How to create or cancel orders
  • WebSocket
    • General Information
    • Request Format
    • Response Format
    • Subscription Topics
    • Heartbeats
    • Client Example
  • Authorization
    • Get auth message
      GET
    • Get JWT with valid signature
      POST
  • Categories
    • Get categories
      GET
    • Get category by slug
      GET
    • Get all tags
      GET
  • Markets
    • Get markets
      GET
    • Get market by ID
      GET
    • Get market statistics
      GET
    • Get market last sale information
      GET
    • Get the orderbook for a market
      GET
    • Get market timeseries
      GET
    • Get latest market timeseries value
      GET
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Get order match events
      GET
    • Remove orders from the orderbook
      POST
    • Create an order
      POST
    • Remove orders by hash
      POST
  • Accounts
    • Get connected account
      GET
    • Get account activity
      GET
    • Set a referral
      POST
  • Positions
    • Get positions
      GET
    • Get positions by address
      GET
  • Search
    • Search categories and markets
      GET
  • OAuth
    • Finalize a OAuth connection
      POST
    • Get the orders for a OAuth connection
      POST
    • Create an order for a OAuth connection
      POST
    • Cancel the orders for a OAuth connection
      POST
    • Get the positions for a OAuth connection
      POST
  • Schemas
    • AccountData
    • AccountResponse
    • ActivityEvent
    • ActivityEventName
    • ActivityOrderData
    • ActivityResponse
    • AuthMessageData
    • AuthMessageResponse
    • AuthTokenData
    • AuthTokenResponse
    • BulletinBoardUpdate
    • BulletinBoardUpdatesResponse
    • CategoriesResponse
    • CategoryResponse
    • CategorySort
    • CategoryStatsData
    • CategoryStatsResponse
    • CategoryStatus
    • CategoryStatusFilter
    • CategoryTranslationData
    • CategoryTranslationFields
    • CategoryTranslationsResponse
    • CategoryWithStats
    • ContractOrder
    • CreateOrderData
    • CreateOrderRequest
    • CreateOrderResponse
    • CreateOrderResponseData
    • CryptoUpDownVariantData
    • ErrorCode
    • ErrorResponse
    • Fee
    • FeeEventData
    • FeeEventsResponse
    • FeeType
    • LastOrderSettled
    • LastSaleData
    • LastSaleResponse
    • Market
    • MarketResponse
    • MarketRewards
    • MarketSort
    • MarketStatsData
    • MarketStatsResponse
    • OAuthCancelOrdersData
    • MarketStatus
    • OAuthCancelOrdersRequest
    • MarketStatusFilter
    • OAuthCancelOrdersResponse
    • OAuthCreateOrderData
    • MarketTimeseries
    • OAuthCreateOrderRequest
    • MarketTimeseriesLatest
    • MarketTradingStatus
    • OAuthCreateOrderResponse
    • OAuthFinalizeData
    • MarketTranslationData
    • OAuthFinalizeRequest
    • MarketType
    • MarketVariant
    • OAuthFinalizeResponse
    • OAuthOrdersData
    • MarketWithStats
    • MarketsResponse
    • OAuthOrdersRequest
    • MatchData
    • OAuthOrdersResponse
    • MatchesResponse
    • OAuthPositionsData
    • Metric
    • OAuthPositionsRequest
    • OAuthPositionsResponse
    • OrderData
    • OrderFillData
    • OrderResponse
    • OrderStatus
    • OrderStatusFilter
    • OrderStrategy
    • OrderbookData
    • OrderbookResponse
    • OrderbooksResponse
    • OrdersResponse
    • Outcome
    • OutcomeSide
    • OutcomeStatus
    • OutcomeTranslation
    • OutcomeVariantData
    • OutcomeVariantData_SportsTeamOutcomeData
    • PendingYieldData
    • PendingYieldResponse
    • PointsInfo
    • PositionData
    • PositionSort
    • PositionsResponse
    • PostAuthRequest
    • RemoveOrdersData
    • PriceFeedProvider
    • RemoveOrdersRequest
    • RemoveOrdersResponse
    • PriceLevel
    • QuoteType
    • ReferralInfo
    • ReferralStatus
    • RemoveOrdersByHashData
    • RemoveOrdersByHashRequest
    • ReservedBalancePolicy
    • Resolution
    • ResolutionProvider
    • RewardPeriod
    • SearchData
    • SearchResponse
    • SelectTeamsRequest
    • SelfTradePreventionStrategy
    • SetReferralData
    • SetReferralRequest
    • SetReferralResponse
    • SportsDataProvider
    • SportsEventTeam
    • SportsFifaFriendliesVariantData
    • SportsFifaWorldCupVariantData
    • SportsNbaVariantData
    • SportsPropsMarketData
    • SportsTeamOutcomeData
    • Tag
    • TagsResponse
    • Team
    • TeamSide
    • TimeseriesData
    • TimeseriesLatestBatchResponse
    • TimeseriesLatestData
    • TimeseriesLatestResponse
    • TimeseriesPoint
    • TimeseriesResponse
    • TweetCountVariantData
    • VariantData
    • VariantData_CryptoUpDownVariantData
    • VariantData_SportsFifaFriendliesVariantData
    • VariantData_SportsFifaWorldCupVariantData
    • VariantData_SportsNbaVariantData
    • VariantData_SportsPropsMarketData
    • VariantData_TweetCountVariantData
  1. Markets

Get markets

Prod Env
https://api.predict.fun
Prod Env
https://api.predict.fun
GET
https://api.predict.fun
/v1/markets
Get information about markets

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Responses

🟢200
application/json
Response 200
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.predict.fun/v1/markets?first=undefined&after=undefined&isBoosted=undefined&status=undefined&tagIds=undefined&marketVariant=undefined&sort=undefined&hasActiveRewards=undefined' \
--header 'x-api-key: <api-key>'
Response Response Example
{
    "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,
            "resolution": {
                "name": "string",
                "indexSet": 0,
                "onChainId": "string",
                "status": "WON",
                "bestBid": {
                    "price": 0,
                    "size": 0
                },
                "bestAsk": {
                    "price": 0,
                    "size": 0
                },
                "team": {
                    "id": 0,
                    "name": "string",
                    "abbreviation": "string",
                    "alias": "string",
                    "league": "string"
                },
                "variantData": {
                    "type": "SPORTS_FIFA_FRIENDLIES",
                    "provider": "PREDICT_SPORTS",
                    "team": {
                        "id": 0,
                        "name": "string",
                        "abbreviation": "string",
                        "providerTeamId": "string"
                    }
                }
            },
            "oracleQuestionId": "string",
            "conditionId": "string",
            "resolverAddress": "string",
            "outcomes": [
                {}
            ],
            "questionIndex": 0,
            "spreadThreshold": 0,
            "shareThreshold": 0,
            "isBoosted": true,
            "boostStartsAt": "string",
            "boostEndsAt": "string",
            "polymarketConditionIds": [
                "string"
            ],
            "kalshiMarketTicker": "string",
            "categorySlug": "string",
            "createdAt": "string",
            "decimalPrecision": 0,
            "marketVariant": "DEFAULT",
            "variantData": {
                "type": "CRYPTO_UP_DOWN",
                "priceFeedProvider": "PYTH",
                "startPrice": 0,
                "endPrice": 0,
                "priceFeedId": "string",
                "priceFeedSymbol": "string"
            },
            "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"
                    }
                ]
            }
        }
    ]
}
Modified at 2026-06-18 15:52:48
Previous
Get all tags
Next
Get market by ID
Built with