Nansen Perp Analytics for Openclaw

A dedicated analytics engine for Hyperliquid perpetual markets and trader performance metrics.

hurcannansen
v1.0.0
Mar 4, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install nansen-perp

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install nansen-perp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Nansen Perp Analytics?

The Nansen Perp skill enables automated research and data retrieval for Hyperliquid perpetuals. By integrating this skill into Openclaw Skills, developers can programmatically monitor market trends, volume spikes, and leaderboard shifts. It serves as a bridge between the Nansen intelligence platform and AI-driven trading workflows, providing high-fidelity data on perp markets and wallet-specific exposures without leaving your terminal or agent environment.

Nansen Perp Analytics Use Cases

  • Identifying high-volume perpetual markets on Hyperliquid.
  • Tracking the open interest of specific assets to gauge market sentiment.
  • Following top-performing traders via the PnL leaderboard to see successful strategies.
  • Researching specific token perpetual trades for deeper market analysis.
  • Monitoring individual wallet positions and overall portfolio DeFi exposure.

How Nansen Perp Analytics Works

  1. The AI agent identifies a request for perpetual market data or trader performance.
  2. Openclaw Skills triggers the Nansen CLI using the required NANSEN_API_KEY environment variable.
  3. The system executes specific research commands such as perp screener or perp leaderboard.
  4. Data is retrieved from Nansen's specialized Hyperliquid-specific endpoints.
  5. The agent processes the raw output to provide actionable insights or structured data summaries to the user.

Nansen Perp Analytics Setup

To install the necessary components for this skill and enable it within your Openclaw Skills setup, use the following commands:

npm install -g nansen-cli

You must also set your Nansen API key in your environment to authenticate requests:

export NANSEN_API_KEY='your_nansen_api_key'

Nansen Perp Analytics Data Schema & Taxonomy

The skill organizes perpetual data into clear technical categories using the following metadata taxonomy:

Category Key Metrics
Market Screener Volume, Open Interest, Funding Rates
Leaderboard PnL, Win Rate, Rank (based on days)
Token Trades Symbol-specific perp trade history and flow
Profiler Wallet-specific perp positions and entries
Portfolio Total DeFi exposure and perp collateral

Nansen Perp Analytics Advanced Features

  • Configurable lookback periods for leaderboards using the --days flag to track short-term or long-term performance.
  • Granular field selection using the --fields flag to reduce data overhead and focus on specific metrics.
  • Seamless transition between market-level screening and wallet-level profiling for deep-dive investigations.
  • Support for CSV formatting and human-readable tables to facilitate downstream data analysis within Openclaw Skills workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*