# Nansen Prediction Market Event Screener

> Nansen Prediction Market Event Screener is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Screens and filters prediction market events using Nansen's smart money analytics to surface relevant trading opportunities

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/prediction-market/event-screener
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-1c28192d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_agL68mHArL3j7sm2D__bR

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 api-nansen-ai-1c28192d
```

Example prompt: Can you pull up the current prediction market event screener from Nansen and show me what events are active right now, especially anything with significant smart money activity?

## When to prefer this

Use this endpoint when you need to discover and screen prediction market events with the backing of Nansen's smart money wallet labels and on-chain flow analytics — particularly when looking for events that smart money wallets are actively participating in. Prefer this over generic prediction market APIs when Nansen's labeling intelligence is needed to filter signal from noise.

## Known failure modes

- Invalid or missing filter parameters return 400 bad request
- Authentication failure returns 401 if API key is invalid
- No events matching filters returns empty result set
- Rate limiting or payment failure returns 402 or 429
- Server error returns 500 if upstream data pipeline is unavailable

## How this service works

Get Prediction Market Event Screener

## Output

A list of prediction market events with associated metadata, market statistics, and smart money signals — including event names, categories, liquidity, volume, and any Nansen-labeled wallet activity to help identify high-conviction opportunities.

## Example request

```json
{
 "tags": [],
 "query": "bitcoin",
 "status": "active",
 "sort_by": "volume",
 "neg_risk": false,
 "max_liquidity": -1,
 "min_liquidity": 500,
 "min_volume_24hr": 50,
 "max_open_interest": -1,
 "min_open_interest": 100
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "EventScreenerRequest",
 "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": "SortOrder[ScreenerSortField]",
      "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"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 10
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "EventScreenerResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "EventScreenerItem",
    "required": [
     "event_id"
    ],
    "properties": {
     "tags": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "string"
        }
       }
      ],
      "title": "Tags",
      "description": "Event tags"
     },
     "markets": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "object",
         "title": "EventScreenerMarket",
         "required": [
          "market_id",
          "question"
         ],
         "properties": {
          "best_ask": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Best Ask"
          },
          "best_bid": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Best Bid"
          },
          "end_date": {
           "anyOf": [
            {
             "type": "string",
             "format": "date-time"
            }
           ],
           "title": "End Date"
          },
          "question": {
           "type": "string",
           "title": "Question"
          },
          "market_id": {
           "type": "string",
           "title": "Market Id"
          },
          "volume_24hr": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Volume 24Hr"
          },
          "open_interest": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Open Interest"
          },
          "last_trade_price": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Last Trade Price"
          },
          "volume_change_pct": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Volume Change Pct"
          },
          "unique_traders_24h": {
           "anyOf": [
            {
             "type": "integer"
            }
           ],
           "title": "Unique Traders 24H"
          },
          "one_day_price_change": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "One Day Price Change"

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-1c28192d/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)