Polymarket

Polymarket Market 360

Market Quality & Structure Endpoint

POST/v2/semantic/retrieve/parameterized

Query Parameters

condition_idstring

Ethereum condition ID for the market. This is optional. If you don't pass it, you get insights about all markets ranked by current_volume_24h in desc order.

Example:

"ALL"

min_volume_24hstring

Minimum 24-hour trading volume required for a market to be included. Use this to remove low-activity or noise markets.

Example:

"0"

min_liquidity_percentilestring

Minimum liquidity percentile relative to all active markets. Higher values indicate deeper books and better exit quality.

Example:

"0"

volume_trendstring

Filters markets by recent activity momentum. Allowed values: Spiking, Normal, Declining, Dying Interest, No Trades, ALL.

Example:

"ALL"

min_top1_wallet_pctstring

Minimum percentage of total exposure controlled by the largest wallet. Higher values may indicate whale dominance and potential fragility.

Example:

"0"

max_unique_traders_7dstring

Maximum number of unique traders over the last 7 days. Useful for detecting low-participation or weak-consensus markets.

Example:

"0"

Polymarket Market 360

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 575,
  "params": {
    "condition_id": "ALL",
    "min_volume_24h": "0",
    "min_liquidity_percentile": "0",
    "volume_trend": "ALL",
    "min_top1_wallet_pct": "0",
    "max_unique_traders_7d": "0"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "condition_id": "ALL",
    "max_unique_traders_7d": "0",
    "min_liquidity_percentile": "0",
    "min_top1_wallet_pct": "0",
    "min_volume_24h": "0",
    "volume_trend": "ALL"
  },
  "pagination": {
    "limit": 200,
    "offset": 0,
    "has_more": true
  },
  "data": {
    "results": [
      {
        "condition_id": "0x24fb7c2d95c93a68018e6c4a90d88043bb67d32fd1454924cef8ebdd550228f3",
        "created_at": "2026-02-09T16:53:53.025942Z",
        "current_volume_24h": "44646247.155082",
        "current_volume_7d": "116971972.905561",
        "end_date": "2026-03-31T00:00:00Z",
        "liquidity_percentile": "100.00",
        "liquidity_risk_flag": false,
        "liquidity_tier": "Top 5%",
        "market_active": true,
        "market_closed": false,
        "net_pnl": "102441.064396",
        "no_avg_pnl": "-13.643443",
        "peak_hour_trades": 391,
        "profit_loss_ratio": "2.43",
        "question": "Will Israel launch a major ground offensive in Lebanon by March 31?",
        "slug": "will-israel-launch-a-major-ground-offensive-in-lebanon-by-march-31",
        "snapshot_time": "2026-03-25T18:00:00.010272Z",
        "squeeze_risk_flag": false,
        "top10_wallet_pct": "65.45",
        "top1_wallet_pct": "18.28",
        "top3_wallet_pct": "36.24",
        "trade_concentration_flag": false,
        "trades_per_hour_avg": "213.08",
        "unique_traders_7d": 4941,
        "updated_at": "2026-03-25T18:00:00.010272Z",
        "volume_collapse_risk_flag": false,
        "volume_ratio_24h_to_7d": "267.18",
        "volume_trend": "Spiking",
        "whale_control_flag": false,
        "winning_side": "Yes",
        "yes_avg_pnl": "44.593246"
      }
    ]
  },
  "request_id": ""
}