Skip to main content
GET
/
api
/
v1
/
markets
/
{id}
/
similar
Find similar markets
curl --request GET \
  --url https://v2.api.adj.news/api/v1/markets/{id}/similar \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "market_id": "<string>",
      "ticker": "<string>",
      "platform": "<string>",
      "question": "<string>",
      "probability": 123,
      "volume": 123,
      "status": "<string>",
      "category": "<string>",
      "end_date": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}
Find markets semantically similar to a given market using AI-powered vector embeddings.

​
Path Parameters

​
id
string
required
The unique market identifier to find similar markets for.

​
Query Parameters

​
limit
integer
default:10
Maximum number of similar markets to return (1-100).
​
min_similarity
number
Minimum similarity threshold (0.0-1.0). Use 0.5-0.7 for reasonably related markets.

​
Response

{
  "data": [
    {
      "market_id": "SENATEAZ-26-R",
      "ticker": "SENATEAZ-26-R",
      "platform": "kalshi",
      "question": "Will the Republican party win the Senate seat in Arizona",
      "probability": 62.0,
      "volume": 1250.0,
      "status": "active",
      "similarity": 0.92
    }
  ],
  "total": 1
}
FieldTypeDescription
market_idstringUnique identifier
tickerstringStandardized ticker
platformstringSource platform
questionstringMarket question
probabilitynumberCurrent probability (0-100)
volumenumberTotal trading volume
statusstringMarket status
similaritynumberSemantic similarity score (0.0-1.0)

​
Similarity Score Interpretation

ScoreInterpretation
0.9-1.0Nearly identical
0.7-0.9Highly related
0.5-0.7Moderately related
0.3-0.5Loosely related

​
Examples

# Find similar markets
curl "https://v2.api.adj.news/api/v1/markets/SENATECO-26-R/similar?limit=5" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Only highly similar
curl "https://v2.api.adj.news/api/v1/markets/SENATECO-26-R/similar?min_similarity=0.7" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Errors

StatusDescription
404Market not found

Authorizations

​
Authorization
string
header
required

Auth0 JWT Bearer token

Path Parameters

​
id
string
required

Market ID

Query Parameters

​
limit
integer
default:10

Max results

​
min_similarity
number
default:0

Minimum similarity (0.0-1.0)

Response

200 - application/json

Similar markets

​
data
object[]
​
total
integer