Skip to main content
POST
/
api
/
v1
/
search
/
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.

​
category
string

Filter to a specific category (e.g., Politics, Crypto, Sports).

​
limit
integer
default:20

Maximum number of results to return.

Required range: x <= 100

Response

Ranked search results with similarity scores

​
query
string

The original search query.

​
count
integer

Number of results returned.

​
results
object[]