Predict API (Beta)
  1. Markets
Predict API (Beta)
  • 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
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Get order match events
      GET
    • Create an order
      POST
    • Remove orders from the orderbook
      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
  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
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.predict.fun/v1/markets?first&after&isBoosted&status&tagIds&marketVariant&sort' \
--header 'x-api-key: <api-key>'
Response Response Example
{
    "success": true,
    "cursor": "string",
    "data": [
        {
            "id": 0,
            "imageUrl": "string",
            "title": "string",
            "question": "string",
            "description": "string",
            "status": "REGISTERED",
            "isNegRisk": true,
            "isYieldBearing": true,
            "feeRateBps": 0,
            "resolution": {
                "name": "string",
                "indexSet": 0,
                "onChainId": "string",
                "status": "WON"
            },
            "oracleQuestionId": "string",
            "conditionId": "string",
            "resolverAddress": "string",
            "outcomes": [
                {
                    "name": "string",
                    "indexSet": 0,
                    "onChainId": "string",
                    "status": "WON"
                }
            ],
            "questionIndex": 0,
            "spreadThreshold": 0,
            "shareThreshold": 0,
            "isBoosted": true,
            "boostStartsAt": "string",
            "boostEndsAt": "string",
            "polymarketConditionIds": [
                "string"
            ],
            "kalshiMarketTicker": "string",
            "categorySlug": "string",
            "createdAt": "string",
            "decimalPrecision": 2,
            "marketVariant": "DEFAULT",
            "variantData": {
                "type": "CRYPTO_UP_DOWN",
                "startPrice": 0,
                "endPrice": 0,
                "priceFeedId": "string"
            }
        }
    ]
}
Modified at 2026-01-31 16:05:09
Previous
Get all tags
Next
Get market by ID
Built with