Search categories and markets

Prod Env

https://api.predict.fun

GET

/v1/search

Full-text search across categories and markets. Returns separate arrays for each type, sorted by relevance.

Default rate limit: 50 RPM

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200

application/json

Response 200

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.predict.fun/v1/search?query&includeResolved&limit' \
--header 'x-api-key: <api-key>'

Response Example

{
    "success": true,
    "data": {
        "categories": [
            {
                "id": 0,
                "slug": "string",
                "title": "string",
                "description": "string",
                "imageUrl": "string",
                "isNegRisk": true,
                "isYieldBearing": true,
                "marketVariant": "DEFAULT",
                "variantData": {
                    "type": "CRYPTO_UP_DOWN",
                    "startPrice": 0,
                    "endPrice": 0,
                    "priceFeedId": "string"
                },
                "createdAt": "string",
                "publishedAt": "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,
                        "isBoosted": true,
                        "boostStartsAt": "string",
                        "boostEndsAt": "string",
                        "polymarketConditionIds": [
                            "string"
                        ],
                        "kalshiMarketTicker": "string",
                        "categorySlug": "string",
                        "createdAt": "string",
                        "decimalPrecision": 2,
                        "marketVariant": "DEFAULT"
                    }
                ],
                "startsAt": "string",
                "endsAt": "string",
                "status": "OPEN",
                "tags": [
                    {
                        "id": "string",
                        "name": "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,
                "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

Get positions by address

Finalize a OAuth connection