{
  "query": "<string>",
  "count": 123,
  "results": [
    {
      "market_id": "<string>",
      "exchange": "<string>",
      "title": "<string>",
      "category": "<string>",
      "closed": true,
      "score": 123,
      "delphi_id": "<string>"
    }
  ]
}

Semantic Market Search

Search markets by meaning using AI-powered semantic search. Unlike keyword search, this understands natural language queries like “will interest rates go down” and finds relevant markets even if they use different wording.

Uses hybrid scoring that combines:

Semantic similarity — matches meaning using embeddings across both market titles and rules
Keyword boost — exact keyword matches in titles get a relevance boost

Searches across all supported exchanges: Kalshi, Polymarket, Limitless, Predict.fun, Opinion Labs, Gemini, Manifold, ForecastEx, and PredictIt.

Requires Max, Admin, or Enterprise plan.

Use cases

Find markets using natural language descriptions
Discover markets you wouldn’t find with keyword search
Search by concept rather than exact market titles
Cross-exchange market discovery by topic

Example

Request: POST /api/v1/search/semantic
Header: X-API-Key: YOUR_API_KEY
Body: {"query": "fed rate cuts by summer", "active_only": true, "limit": 10}

POST

api

semantic

{
  "query": "<string>",
  "count": 123,
  "results": [
    {
      "market_id": "<string>",
      "exchange": "<string>",
      "title": "<string>",
      "category": "<string>",
      "closed": true,
      "score": 123,
      "delphi_id": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Your API key (get one from the test-key endpoint above)

Body

application/json

query

string

required

Natural language search query.

Example:

"fed rate cuts by summer"

exchange

enum<string>[]

Filter to specific exchanges. If omitted, searches all exchanges.

Available options:

kalshi,

polymarket,

limitless,

predictfun,

opinion,

gemini,

manifold,

forecastex,

predictit

active_only

boolean

default:false

If true, only returns markets that are not closed.

Response

Ranked search results with similarity scores

query

string

The original search query.

count

integer

Number of results returned.

results

object[]

Show child attributes

Search Delphi Markets Get Market Cluster Info