nansen-perp

What This Skill Does

The nansen-perp skill provides a powerful interface for accessing real-time and historical perpetual futures market data directly from the Hyperliquid exchange. It acts as an analytical bridge between the OpenClaw agent and the Nansen research engine, allowing users to query high-level market metrics, sort assets by volume or open interest, and identify top-performing traders on the Hyperliquid platform. Whether you are performing deep-dive research into market sentiment, tracking institutional capital flow, or auditing your own trading performance, this skill consolidates complex on-chain data into actionable insights.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/hurcannansen/nansen-perp

Ensure that your OpenClaw agent has the necessary permissions to interface with external API endpoints before execution.

Use Cases

1. Market Surveillance: Quickly identify which assets are currently driving the most volatility on Hyperliquid by sorting markets by volume or open interest.
2. Alpha Discovery: Use the leaderboard functionality to monitor the most profitable traders over the last week. This allows users to track successful strategies and adjust their own risk management protocols accordingly.
3. Portfolio Audit: Leverage the integrated portfolio and profiler commands to quickly assess exposure to specific perpetual contracts across various wallets.
4. Data Reporting: Utilize the --format csv flag to export complex market data for use in external spreadsheets or quantitative modeling tools.

Example Prompts

1. "Find me the top 10 perp markets on Hyperliquid sorted by open interest to identify potential breakout candidates."
2. "Show me the leaderboard for the top perp traders on Hyperliquid over the past 7 days to see who is currently leading in PnL."
3. "Export the volume data for the current top 20 perp markets into a CSV format so I can analyze the distribution in Excel."

Tips & Limitations

• Efficiency: Always use the --limit flag when requesting large datasets to optimize response times and reduce network overhead.
• Data Granularity: The nansen-perp skill focuses specifically on Hyperliquid; for broader market context across other exchanges, check the documentation for other Nansen-related skills.
• Default Lookback: Remember that the leaderboard default lookback period is 30 days. If you require current market trends, explicitly set the --days flag to a smaller window like 7 or 1.
• Output Formatting: Use the --table flag when interacting with the agent via chat for the most readable, human-friendly summary of the market data returned.