nansen-search

What This Skill Does

The nansen-search skill acts as your gateway to the vast Nansen database, allowing the OpenClaw AI agent to resolve ambiguous queries into precise on-chain data. Whether you are dealing with a vague project name, a wallet address, or a well-known industry figure, this skill bridges the gap between natural language input and structured blockchain intelligence. By querying the Nansen index, the agent can retrieve critical metadata such as smart contract addresses, token symbols, and entity classifications, which serve as the foundation for deeper analytical tasks. It is designed to be the first step in any research workflow, ensuring the agent has the correct identification before moving on to advanced profiling or historical analysis.

Installation

To integrate this skill into your environment, run the following command in your terminal within the OpenClaw framework: clawhub install openclaw/skills/skills/hurcannansen/nansen-search Ensure your agent configuration includes the necessary API credentials required for Nansen data access. Once installed, the skill is automatically registered to the agent's command registry and can be invoked during natural language interactions.

Use Cases

This skill is indispensable for DeFi traders, blockchain researchers, and developers who need real-time data verification. Common use cases include:

• Token Resolution: Quickly mapping a trending meme coin name to its specific contract address on a specific chain.
• Entity Tracking: Identifying the wallet addresses associated with known entities like exchanges, protocols, or public figures.
• Portfolio Context: Retrieving the entity identity behind an anonymous-looking wallet address before running a detailed analysis.
• Asset Discovery: Searching for assets across multiple chains using a single, unified search interface.

Example Prompts

1. "Search for the token address of PEPE on Ethereum so I can analyze its current holder distribution."
2. "Can you find the entity associated with the wallet 0x71C7656EC7ab88b098defB751B7401B5f6d8976F?"
3. "Look up the top 5 entities related to the name 'Vitalik' and provide their known addresses."

Tips & Limitations

• Case Insensitivity: You don't need to worry about capitalization; the search engine is case-insensitive, making it user-friendly for ad-hoc queries.
• Refining Results: Use the --type flag to significantly improve query speed and result relevance, especially when the search term is a common word.
• Chaining: This skill is a prerequisite. Always perform a search first to confirm your inputs before passing them to the nansen-token or nansen-profiler skills.
• Limitations: The search is limited by the Nansen index coverage. If a token is extremely new or off-chain, it may not appear in the database. Use the --limit flag to avoid overwhelming the agent with excessive search results.