nansen-perp_skill

This skill analyzes perpetuals on Hyperliquid, providing screener and leaderboard insights to help you monitor top markets, funding rates, and leading traders.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill nansen-perp

_meta.json280 B
SKILL.md1.3 KB

Overview

This skill provides perpetuals analytics for Hyperliquid markets, offering a screener and trader leaderboard to quickly assess perp market activity. It is built to surface top markets by volume or open interest and highlight leading perpetual traders by PnL over configurable lookback windows. Use it to monitor funding dynamics, market depth, and who’s making the biggest perp moves.

How this skill works

The screener queries Hyperliquid perp market metrics and returns ranked lists based on fields like volume or open interest. The leaderboard aggregates trader PnL over a configurable number of days and ranks addresses by performance. Output supports human-readable tables and CSV exports, and commands accept flexible sorting, limiting, and field selection flags.

When to use it

When you need the top perp markets by trading volume or open interest on Hyperliquid.
When tracking funding rates, market activity, or recent shifts in perp liquidity.
When identifying top-performing perp traders or monitoring PnL trends over time.
When exporting perp market snapshots for research or reporting in CSV.
When investigating token- or wallet-specific perp activity tied to portfolios or addresses.

Best practices

Sort results by the metric most relevant to your question (volume for activity, open_interest for exposure).
Use --limit to control result size before exporting to CSV for downstream analysis.
Run leaderboards with a suitable --days lookback to avoid noise from single-day outliers.
Select only needed fields with --fields to keep outputs concise and focused.
Combine wallet-level commands with portfolio queries to understand exposure and realized vs unrealized PnL.

Example use cases

List the top 20 perp markets by 24h volume to spot where liquidity is concentrated.
Check the top 10 markets by open interest before deploying a large directional perp trade.
Get the top perp traders by 7-day PnL to identify strategies or wallets to monitor.
Export a CSV of screener results for inclusion in periodic trading desk reports.
Query token-specific perp trades or wallet perp positions for post-trade analysis.

FAQ

No. Hyperliquid data does not require a --chain flag.

How do I get token- or wallet-specific perp details?

Use token-specific: nansen research token perp-trades --symbol <SYMBOL>. For wallet positions: nansen research profiler perp-positions --address <addr>.