Predict API (Beta)
  1. Categories
Predict API (Beta)
  • FAQs
  • Deployed Contracts
  • Guides
    • Understanding the Orderbook
    • How to authenticate your API requests
    • How to create or cancel orders
  • Authorization
    • Get auth message
      GET
    • Get JWT with valid signature
      POST
  • Accounts
    • Get connected account
      GET
    • Set a referral
      POST
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Create an order
      POST
    • Remove orders from the orderbook
      POST
  • Categories
    • Get categories
      GET
    • Get category by slug
      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
  • Positions
    • Get positions
      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
    • Sample Schemas
      • Pet
      • Category
      • Tag
  1. Categories

Get categories

Prod Env
https://api.predict.fun
Prod Env
https://api.predict.fun
GET
https://api.predict.fun
/v1/categories
INFO
Markets within RESOLVED categories are not tradable. You can filter them with the status query parameter.
Get categories information and their 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/categories?first&after&status' \
--header 'x-api-key: <api-key>'
Response Response Example
{
    "success": true,
    "cursor": "string",
    "data": [
        {
            "id": 0,
            "slug": "string",
            "title": "string",
            "description": "string",
            "imageUrl": "string",
            "isNegRisk": true,
            "isYieldBearing": true,
            "marketVariant": "DEFAULT",
            "createdAt": "string",
            "markets": [
                {
                    "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,
                    "polymarketConditionIds": [
                        "string"
                    ],
                    "kalshiMarketTicker": "string",
                    "categorySlug": "string",
                    "createdAt": "string",
                    "decimalPrecision": 2
                }
            ],
            "startsAt": "string",
            "status": "OPEN",
            "tags": [
                {
                    "id": "string",
                    "name": "string"
                }
            ]
        }
    ]
}
Modified at 2025-12-12 17:28:17
Previous
Remove orders from the orderbook
Next
Get category by slug
Built with