Nansen Prediction Markets

Polymarket screeners — discover trending events, top markets by volume, and search for specific markets. Use when browsing what's happening on prediction mar...

Security Scan

The skill's requirements (nansen binary, NANSEN_API_KEY, npm install of nansen-cli) and runtime instructions align with its stated purpose of querying Nansen/Polymarket screeners.

Purpose & Capability

The skill is for running Nansen 'prediction-market' CLI commands. Requiring the 'nansen' binary and an API key named NANSEN_API_KEY is proportionate and expected.

Instruction Scope

SKILL.md only shows specific nansen CLI commands for listing/searching markets and categories. It does not instruct reading unrelated files or environment variables beyond the declared API key. Runtime behavior is limited to running the CLI and returning results.

Install Mechanism

Install uses a node package (nansen-cli) that creates the 'nansen' binary. This is a typical install path but carries the usual npm-installed-package risk: verify package provenance, publisher, and version before installing.

Credentials

Only a single credential (NANSEN_API_KEY, declared as primaryEnv) is required, which matches the need to authenticate to Nansen's API.

Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence or modify other skills or system-wide settings. Autonomous invocation remains possible (platform default).

Assessment

This skill installs the 'nansen' CLI via the npm package 'nansen-cli' and will use your NANSEN_API_KEY to call Nansen's API when invoked. Before installing: (1) confirm the npm package and publisher are legitimate and review package version and npm page; (2) treat the NANSEN_API_KEY as sensitive—use a least-privilege key or scoped token if possible, and be ready to rotate/revoke it if needed; (3) avoid sending any secret or personally-identifying data in search queries since queries go to the external service; (4) consider running the install in a sandbox or restricted environment if you are uncertain; (5) monitor usage of the API key after enabling the skill. Overall the skill is internally consistent with its stated purpose but exercise standard caution around third-party npm packages and API keys.

Prediction Market Screeners

All commands: nansen research prediction-market <sub> [options] (alias: nansen research pm <sub>)

No --chain flag needed — Polymarket runs on Polygon.

# Top events (groups of related markets)
nansen research pm event-screener --sort-by volume_24hr --limit 20
# → event_title, market_count, total_volume, total_volume_24hr, total_liquidity, total_open_interest, tags

# Top markets by 24h volume
nansen research pm market-screener --sort-by volume_24hr --limit 20
# → market_id, question, best_bid, best_ask, volume_24hr, liquidity, open_interest, unique_traders_24h

# 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

# Browse categories
nansen research pm categories --pretty
# → category, active_markets, total_volume_24hr, total_open_interest

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.