---
title: "Scan a venue for mispriced markets"
method: GET
path: "/agent/scan"
tags: ["Agents"]
---

# Scan a venue for mispriced markets

`GET /agent/scan`

## Request

- Base URL: `https://foresea.ink` (the document declares no server; this is the origin it was published from)
- URL: `https://foresea.ink/agent/scan`
- Auth: none declared

Scan live markets on one or both venues and surface the most mispriced.

Lists active markets (Polymarket and/or Kalshi), forecasts each, compares
against the market price, and returns those whose model-vs-market gap is at
least `min_edge`. `platform` accepts `polymarket`, `kalshi`, or `all`/`both`.
`query` optionally filters to markets whose question contains that keyword
(e.g. `nba`). Bounded by `limit` per venue (max 8) since each market runs a
full forecast; results are cached briefly.

## Query parameters

- `platform` string
- `limit` integer
- `min_edge` number
- `evidence_top_k` integer
- `query` string, nullable

## Response `200`

Successful Response

- AgentScanResponse: Mispriced markets surfaced by the scan agent, ranked by |edge|.
  - `platform` string, required
  - `scanned` integer, required: How many live markets were analysed.
  - `opportunities` ScanOpportunity[]
    - `question` string, required
    - `market_url` string, nullable
    - `outcome` string
    - `market_probability` number, nullable
    - `model_probability` number, nullable
    - `edge` number, nullable
    - `stance` string, nullable
    - `recommendation` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/foresea/apis/foresea-intelligence-api.md) · [All operations](https://skmtc.dev/foresea/apis/foresea-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foresea/apis/foresea-intelligence-api/revisions/b03e49f4385d?raw)