---
title: "On-demand market analysis"
method: GET
path: "/v1/analyze/market/{slug}"
tags: ["Analyze"]
---

# On-demand market analysis

`GET /v1/analyze/market/{slug}`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/analyze/market/{slug}`
- Auth: HTTP bearer

**Min tier: `free`.** Live-computed structured intelligence object for a market: smart-money probability, market price, divergence, top positions, sentiment, and 24h flow. Deterministic (no LLM). Cached ~30s.

## Path parameters

- `slug` string, required

## Response `200`

Market analysis object.

- MarketAnalysis
  - `market_slug` string
  - `market_title` string, nullable
  - `market_category` string, nullable
  - `condition_id` string, nullable
  - `smart_money_prob` number, nullable
  - `market_price` number, nullable
  - `divergence` number, nullable: smart_money_prob - market_price.
  - `sample_wallets` integer
  - `top_positions` object[]
    - `address` string
    - `market_side` 'YES' | 'NO'
    - `volume` number, nullable
    - `trade_count` integer, nullable
    - `wallet_type` string, nullable
    - `win_rate` number, nullable
    - `total_pnl` number, nullable
    - `polymarket_name` string, nullable
  - `sentiment` Sentiment
    - `sentiment` string, nullable: Label: bullish / bearish / mixed.
    - `yes_ratio` number, nullable
    - `yes_volume` number, nullable
    - `no_volume` number, nullable
    - `total_whale_volume` number, nullable
    - `unique_whales` integer, nullable
  - `flow_24h` object
    - `window_minutes` integer
    - `whales_only` boolean
    - `relaxed` boolean
    - `total_volume` number, nullable
    - `net_yes` number, nullable
    - `net_no` number, nullable
    - `buckets` object[]
  - `computed_at` string, date-time

## Other responses

- `400`: Malformed parameters or a rejected guardrail (e.g. unfiltered trades query, cluster blowup, window > 90 days).
- `401`: Missing, invalid, or revoked API key. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `403`: Key valid but its tier is below this endpoint's minimum. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `404`: The requested resource was not found.
- `429`: Hourly or monthly rate limit exceeded.

---

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