# Nansen Polymarket Market Screener

> Nansen Polymarket Market Screener is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-11).

Browse, filter, and sort Polymarket prediction markets by volume, liquidity, price, status, and more

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/prediction-market/market-screener?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-market-screener-047f8daa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IAckiUUC7VYcPlceE4OVb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-market-screener-047f8daa -d '<json body>'
```

Example prompt: Show me the top 20 most actively traded Polymarket prediction markets right now — filter to only active ones and sort by 24-hour volume descending, tagging anything related to crypto or Bitcoin.

## When to prefer this

Use this endpoint when you need to discover, browse, or rank Polymarket prediction markets across any topic — especially when sorting or filtering by trading activity metrics like 24hr volume, liquidity, or open interest. Prefer this over the Event Screener when you need market-level granularity rather than event-level aggregates.

## Known failure modes

- Invalid sort_by or order_by field enum value returns 422 validation error
- min_price or max_price below -1 returns validation error
- Pagination page below 1 or per_page above 1000 returns validation error
- Empty results array when no markets match the filter criteria
- Query string exceeding 200 characters returns validation error
- Tags array exceeding 50 items returns validation error
- Payment failure or insufficient USDC balance returns 402 error

## How this service works

Browse and filter all Polymarket prediction markets. Supports sorting by volume,
liquidity, price change, and more. Filter by search query and active/closed status.

**What it helps to answer:**

1. **What are the most active prediction markets right now?**
2. **Which markets have the highest volume or liquidity?**
3. **What new markets have been created recently?**

## Output

A paginated list of prediction market items, each including market ID, question text, event title, slug, active/closed status, volume (24hr/1wk/1mo/total), liquidity, open interest, unique traders, best bid/ask prices, neg-risk flag, market age in hours, creation date, end date, and associated tags.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "MarketScreenerRequest",
 "properties": {
  "tags": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Tags",
   "examples": [
    [
     "Crypto",
     "Bitcoin"
    ]
   ],
   "maxItems": 50,
   "description": "Filter by tags"
  },
  "query": {
   "type": "string",
   "title": "Query",
   "default": "",
   "examples": [
    "bitcoin",
    "election"
   ],
   "maxLength": 200,
   "description": "Search query to filter results"
  },
  "status": {
   "enum": [
    "active",
    "closed",
    ""
   ],
   "type": "string",
   "title": "MarketStatus",
   "description": "Valid status filters for screener endpoints."
  },
  "sort_by": {
   "enum": [
    "volume_24hr",
    "volume",
    "volume_1wk",
    "volume_1mo",
    "liquidity",
    "open_interest",
    "unique_traders_24h",
    "age_hours"
   ],
   "type": "string",
   "title": "ScreenerSortField",
   "description": "Valid sort fields for screener endpoints."
  },
  "neg_risk": {
   "anyOf": [
    {
     "type": "boolean"
    }
   ],
   "title": "Neg Risk",
   "description": "Filter by neg-risk framework (null = no filter)"
  },
  "order_by": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "object",
      "title": "ScreenerSortOrder",
      "required": [
       "field",
       "direction"
      ],
      "properties": {
       "field": {
        "enum": [
         "volume_24hr",
         "volume",
         "volume_1wk",
         "volume_1mo",
         "liquidity",
         "open_interest",
         "unique_traders_24h",
         "age_hours"
        ],
        "type": "string",
        "title": "ScreenerSortField",
        "description": "Valid sort fields for screener endpoints."
       },
       "direction": {
        "enum": [
         "ASC",
         "DESC"
        ],
        "type": "string",
        "title": "SortDirection",
        "description": "Enum for sort directions."
       }
      }
     }
    }
   ],
   "title": "Order By",
   "examples": [
    [
     {
      "field": "volume_24hr",
      "direction": "DESC"
     }
    ]
   ],
   "description": "Sort order"
  },
  "max_price": {
   "type": "number",
   "title": "Max Price",
   "default": -1,
   "minimum": -1,
   "description": "Maximum price filter (-1 = no limit)"
  },
  "min_price": {
   "type": "number",
   "title": "Min Price",
   "default": -1,
   "minimum": -1,
   "description": "Minimum price filter (-1 = no filter)"
  },
  "pagination": {
   "type": "obj
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "MarketScreenerResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "MarketScreenerItem",
    "required": [
     "market_id"
    ],
    "properties": {
     "slug": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Slug",
      "description": "URL slug"
     },
     "tags": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "string"
        }
       }
      ],
      "title": "Tags",
      "description": "Market tags"
     },
     "active": {
      "anyOf": [
       {
        "type": "boolean"
       }
      ],
      "title": "Active",
      "description": "Whether market is active"
     },
     "closed": {
      "anyOf": [
       {
        "type": "boolean"
       }
      ],
      "title": "Closed",
      "description": "Whether market is closed"
     },
     "volume": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Volume",
      "description": "Total volume (USD)"
     },
     "best_ask": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Best Ask",
      "description": "Best ask price"
     },
     "best_bid": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Best Bid",
      "description": "Best bid price"
     },
     "end_date": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       }
      ],
      "title": "End Date",
      "description": "Market end date"
     },
     "event_id": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Event Id",
      "description": "Parent event ID"
     },
     "neg_risk": {
      "anyOf": [
       {
        "type": "boolean"
       }
      ],
      "title": "Neg Risk",
      "description": "Uses neg-risk framework"
     },
     "question": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Question",
      "description": "Market question"
     },
     "age_hours": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Age Hours",
      "description": "Market age in hours"
     },
     "liquidity": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Liquidity",
      "description": "Current liquidity (USD)"
     },
     "market_id": {
      "type": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-market-screener-047f8daa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)