nansen-prediction-market

Original：🇺🇸 English
Translated

Polymarket prediction market analytics — screener, OHLCV, orderbook, holders, trades, PnL. Use when researching prediction markets, checking market prices, or analyzing trader positions.

3installs
Sourcenansen-ai/nansen-cli
Added on

NPX Install

npx skill4agent add nansen-ai/nansen-cli nansen-prediction-market

Tags

Translated version includes tags in frontmatter
prediction-market-analyticspolymarket-toolsnansen-climarket-researchpnl-analysis

SKILL.md Content

View Translation Comparison →

Prediction Market Analytics (Polymarket)

All commands: 
nansen research prediction-market <sub> [options]
(alias: 
nansen research pm <sub>
)
No 
--chain
flag needed — Polymarket runs on Polygon.

Screeners

bash
# Top markets by 24h volume
nansen research pm market-screener --sort-by volume_24hr --limit 20

# Search for specific markets
nansen research pm market-screener --query "bitcoin" --limit 10

# Find resolved/closed markets
nansen research pm market-screener --status closed --limit 10

# Screen events (groups of related markets)
nansen research pm event-screener --sort-by volume_24hr --limit 20
Sort options: 
volume_24hr
, 
volume
, 
volume_1wk
, 
volume_1mo
, 
liquidity
, 
open_interest
, 
unique_traders_24h
, 
age_hours
Screeners return active/open markets by default. Use 
--status closed
for resolved markets.

OHLCV & Orderbook

bash
nansen research pm ohlcv --market-id 654412 --sort period_start:desc --limit 50
nansen research pm orderbook --market-id 654412

Holders & Positions

bash
nansen research pm top-holders --market-id 654412 --limit 10
nansen research pm position-detail --market-id 654412 --limit 20

Trades

bash
# Trades for a specific market
nansen research pm trades-by-market --market-id 654412 --limit 20

# Trades for a specific address
nansen research pm trades-by-address --address 0x1234... --limit 20

PnL

bash
# PnL leaderboard for a market
nansen research pm pnl-by-market --market-id 654412 --limit 20

# PnL breakdown for a trader
nansen research pm pnl-by-address --address 0x1234...

Categories

bash
nansen research pm categories --pretty

Flags

FlagPurpose
--market-id
Market ID (required for most endpoints)
--address
EVM address (for trades-by-address, pnl-by-address)
--sort-by
Screener sort field (e.g. 
volume_24hr
)
--sort
Sort field:direction for non-screener endpoints
--query
Search text (screeners only)
--status
active
or 
closed
(screeners only, default: active)
--limit
Number of results
--fields
Select specific fields
--table
Human-readable table output
--format csv
CSV export

Notes

  • All address endpoints expect Polygon (EVM) addresses.
  • --market-id
    is a numeric ID from the screener, not a slug.
  • Non-screener endpoints (ohlcv, trades, pnl, etc.) work with any market ID regardless of status.