Resolve a pasted Polymarket/Kalshi/predict.fun market or event URL

Parses url against known host patterns — polymarket.com /event/<slug>/<market-slug> (market) or /event/<slug> (event) or legacy /market/<slug>; kalshi.com ticker/event_id/market_id path segments; predict.fun equivalents. Unrecognized hosts or unmatched paths return an empty /search/simple-shaped body (200) so the frontend can fall back to a normal text search rather than erroring. On a match, resolves the market/event (for an event URL, every outcome market in that event) and returns the same {results, groups?, singles?, meta} shape as /search/simple, enriched with correlations only (ladder classification is skipped — a resolved URL is already a single market/event, not a broad set to collapse).

get/search/resolve-url

Request

Base URL
https://data.kairos.trade
Auth
API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Query parameters

urlstring required

Raw pasted URL (scheme optional — https:// is prepended if missing) or arbitrary text.

Response

Resolved market/event in /search/simple shape, or an empty body if the URL wasn't recognized.

absorbedMarketIdsstring[]

Market/outcome ids already rendered inside classifiedGroups — the overlay should not also render them as standalone rows.

correlationsobject

Map of result market_id -> up to 4 similar cross-venue counterpart markets, sorted by similarity descending.

Example response

{
  "results": [
    {
      "market_id": "KXPRES-28-DJT",
      "provider_id": 1,
      "provider": "kalshi",
      "status": "open"
    }
  ],
  "groups": [
    {
      "representative": {
        "market_id": "KXPRES-28-DJT",
        "provider_id": 1,
        "provider": "kalshi",
        "status": "open"
      },
      "markets": [
        {
          "market_id": "KXPRES-28-DJT",
          "provider_id": 1,
          "provider": "kalshi",
          "status": "open"
        }
      ]
    }
  ],
  "singles": [
    {
      "market_id": "KXPRES-28-DJT",
      "provider_id": 1,
      "provider": "kalshi",
      "status": "open"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.