Predict API (Beta)
  1. Categories
Predict API (Beta)
  • FAQs
  • 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
  • Orders
    • Get order by hash
      GET
    • Get orderbook for specific market
      GET
    • Get orders
      GET
    • Create an order
      POST
    • Optimistically cancel orders
      POST
  • Categories
    • Get categories
      GET
    • Get category by slug
      GET
  • Markets
    • Get markets
      GET
    • Get market statistics
      GET
    • Get market last sale information
      GET
    • Get market activity
      GET
  • Positions
    • Get your positions
      GET
  • Season
    • Get leaderboard
      GET
    • Get season totals
      GET
  • Blast
    • Blast multiplier addresses
      GET
  • OAuth
    • Finalize a OAuth connection
    • Get the orders for a OAuth connection
    • Create an order for a OAuth connection
    • Cancel the orders for a OAuth connection
    • Get the positions for a OAuth connection
  • ZeroDev
    • Validate a user op
  1. Categories

Get categories

GET
/categories
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

Query Params
first
string 
optional
a string that will be parsed into a number
after
string 
optional
a string
status
enum<string> 
optional
Allowed values:
OPENRESOLVED

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-sepolia.predict.fun/categories?first&after&status'

Responses

🟢200OK
application/json
Response 200
Body
success
boolean 
required
a boolean
cursor
string  | null 
required
a string
data
array [object {11}] 
required
id
number 
required
a number
slug
string 
required
a string
title
string 
required
a string
description
string 
required
a string
imageUrl
string 
required
a string
isNegRisk
boolean 
required
a boolean
createdAt
string 
required
date string
markets
array [object {21}] 
required
startsAt
string 
required
date string
status
enum<string> 
required
Allowed values:
OPENRESOLVED
tags
array [object {2}] 
required
Example
{
  "success": true,
  "cursor": "string",
  "data": [
    {
      "id": 0,
      "slug": "string",
      "title": "string",
      "description": "string",
      "imageUrl": "string",
      "isNegRisk": true,
      "createdAt": "string",
      "markets": [
        {
          "id": 0,
          "imageUrl": "string",
          "title": "string",
          "question": "string",
          "description": "string",
          "status": "REGISTERED",
          "isNegRisk": 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,
          "pointAllocationBps": 0,
          "spreadThreshold": 0,
          "shareThreshold": 0,
          "polymarketConditionIds": [
            "string"
          ],
          "categorySlug": "string",
          "createdAt": "string",
          "decimalPrecision": 2
        }
      ],
      "startsAt": "string",
      "status": "OPEN",
      "tags": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    }
  ]
}
Previous
Optimistically cancel orders
Next
Get category by slug
Built with