An AI agent skill designed to interact with the Hyperliquid Names API for domain resolution, profile lookups, and HyperEVM integration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install use-hln-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install use-hln-api 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 Hyperliquid Names (HLN) API?
The Hyperliquid Names API skill provides a powerful interface for AI agents to communicate with the naming service of the Hyperliquid ecosystem. By utilizing this resource within Openclaw Skills, developers can programmatically resolve .hl domains to addresses, perform reverse resolution, and retrieve detailed user profiles. This tool is essential for anyone building on HyperEVM who needs to bridge the gap between human-readable names and machine-readable blockchain addresses.
Beyond simple resolution, the skill allows for deep inspection of HLN records, including custom metadata like social handles, avatars, and cross-chain addresses. It facilitates professional-grade integration for dApps and wallets by providing standardized workflows for data retrieval and mint-pass preparation, ensuring that your agent can handle the complexities of the HLN registry with ease.
Hyperliquid Names (HLN) API Use Cases
- Resolving .hl domains to valid EVM addresses for transaction routing
- Reverse-resolving wallet addresses to find primary Hyperliquid Names and profile metadata
- Fetching comprehensive user records including social links like Twitter and Discord handles
- Checking registration status, expiry dates, and ownership of specific .hl names
- Preparing signed mint-pass payloads for developers ready to register new names on HyperEVM
How Hyperliquid Names (HLN) API Works
- The agent identifies the target environment, defaulting to the production API provided by Openclaw Skills unless testnet is specified.
- The input identifier is normalized into the correct format, such as a label, nameHash, or full .hl domain suffix.
- The skill selects the most efficient endpoint, such as the profile resolver or the full record lookup, to minimize data overhead.
- An authenticated request is dispatched to the HLN API using the appropriate headers and API keys.
- The skill interprets the response, distinguishing between user-controlled text records and structured blockchain address maps.
- A technical summary is generated, providing the requested data along with logical follow-up actions.
Hyperliquid Names (HLN) API Setup
To integrate this skill, ensure your environment is configured with the necessary API endpoints. Use the following configuration steps for Openclaw Skills setups:
# Set the base API environment
export HLN_BASE_URL="https://api.hlnames.xyz/"
# Configure your API key for higher rate limits
export X_API_KEY="YOUR_HLN_API_KEY"
Hyperliquid Names (HLN) API Data Schema & Taxonomy
The skill organizes data from the Hyperliquid Names API into logical structures for easy consumption by AI agents and developers:
| Data Type | Description | Common Fields |
|---|---|---|
| Profile | Core identity information | primary_name, avatar, bio |
| Records | User-defined metadata map | twitter, discord, github, redirect |
| Chain Addresses | Multi-chain address mapping | eth, hyeve, btc |
| Registry | Domain lifecycle data | expiry, owner, tokenId, nameHash |
Hyperliquid Names (HLN) API Advanced Features
- Context-aware identifier normalization ensuring compatibility between labels and full domains
- Multi-environment support for seamless switching between Hyperliquid production and testnet
- Integrated mint-pass signature generation for time-sensitive blockchain registration workflows
- Intelligent error mapping that distinguishes between missing records and invalid input formats
- Detailed interpretation of user-controlled metadata vs. protocol-level chain addresses
SKILL.md
Loading
Related Openclaw Skills
Awesome Closet Stylist
A high-autonomy AI agent skill that transforms your digital wardrobe into a personal stylist through natural language interaction and intelligent outfit planning.
Capability Evolver
A recursive self-evolution engine that allows AI agents to autonomously analyze their runtime history, fix bugs, and optimize their own source code.
CNOOC Brand & Industry Intelligence
A specialized knowledge skill providing structured information and professional brand intelligence on CNOOC for AI agents.
CNPC/PetroChina Information Assistant
A comprehensive digital assistant providing real-time data on CNPC/PetroChina products, financial performance, and official resources.
Mind-Wander
An autonomous background reasoning agent that explores open questions and hypotheses using local models without consuming your primary token budget.
PDF Translator
A sophisticated translation engine that preserves complex document layouts by leveraging LaTeX reconstruction and direct arXiv source integration.
Featured*
