Find related markets — Adjacent News API

/api/v1/news/{id}/marketsGET

Find markets semantically related to a news article using AI embeddings

Authorization

bearerAuth *Bearer <token>

Clerk session JWT, or an API key (the ak_ prefix), sent as a Bearer token or an ?api_key= query parameter. Each endpoint requires the read scope for its resource (e.g. org:rates:read for rates). Token in: header

Query Parameters

min_similarity?number

Minimum cosine similarity a result must reach. Omit to use the deployment's configured floor (SIMILARITY_MIN_SCORE, default 0.35), which exists so a query with no genuinely related items returns an empty list rather than its closest unrelated one. The floor is calibrated to the embedding model in use and is not comparable across models. Pass 0 to disable filtering and see the raw ranking.

Default: 0.35Min: 0Max: 1

page?integer

Page number

Default: 1Min: 1

per_page?integer

Items per page

Default: 100Min: 1Max: 500

Response

200 · Paginated related markets

data?object[]

Show item properties

market_id?string

similarity?number

name?stringnull

description?stringnull

category?stringnull

platform?stringnull

latest_price?numbernull

meta?object

Show properties

total?integer

Total number of records matching the request across every page, not just the number returned in this one.

page?integer

The 1-based page number this response covers.

per_page?integer

Maximum number of items on a page. The last page may hold fewer.

total_pages?integer

Number of pages available at this per_page. It is at least 1, even when nothing matched.

has_next?boolean

True when a page exists after this one.

has_prev?boolean

True when this is not the first page.

Request example

curl -X GET "https://api.adjacent.markets/api/v1/news/<id>/markets" \
  -H "Authorization: Bearer <token>"

Response example

{
  "data": [
    {
      "market_id": "kalshi:SENATEPA-26-R",
      "similarity": 0.89,
      "name": "Will a Republican win the 2026 Pennsylvania U.S. Senate election?",
      "platform": "kalshi"
    },
    {
      "market_id": "kalshi:GOVPA-26-R",
      "similarity": 0.76,
      "name": "Will a Republican win the 2026 Pennsylvania Governor election?",
      "platform": "kalshi"
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}