Skip to content

dProLabs/dpro-hyperliquid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Hyperliquid-dPro

An agent skill for Hyperliquid DEX and dPro onchain analytics.

One skill surface covering market reads, account management, spot/perp/HIP-3 trading, and dPro onchain analytics β€” built for AI agent environments like Claude Code, OpenClaw, Codex, and OpenCode.


Get Started β€” Tutorials First

If you're new here, start with the tutorials. They are designed to take you from zero to productive in four steps, using natural language the whole way.

# Tutorial What you'll learn
1 Market Radar Check prices, order books, candles, and top movers with natural language
2 Account Radar Add read-only accounts, monitor positions, balances, orders, and trades
3 Onchain Reads Query holder distribution, liquidation heatmaps, and leaderboards
4 Trading Desk Set up API accounts, transfer funds, and place perp/spot/HIP-3 orders

Read tutorials 1–3 before jumping into trading. Building up context first makes the trading flow much easier.


Quick Install

Clawhub (recommended)

clawhub install github:dProLabs/Hyperliquid-dPro

Claude Code

/plugin marketplace add dProLabs/Hyperliquid-dPro
/plugin install dpro-hl

Or manually:

git clone https://github.com/dProLabs/Hyperliquid-dPro.git .claude/skills/dpro-hl
cd .claude/skills/dpro-hl && npm install

Then add to your agent config:

Skills: .claude/skills/dpro-hl/SKILL.md

Other Environments

Environment Config
Cursor .cursor-plugin/plugin.json
Codex .codex/INSTALL.md
OpenCode .opencode/INSTALL.md

Local Development

git clone https://github.com/dProLabs/Hyperliquid-dPro.git
cd Hyperliquid-dPro
npm install

What It Can Do

  • Market data β€” quotes, books, candles, movers, overview, market listing
  • Account management β€” encrypted multi-account storage, balances, positions, orders, fills
  • Trading β€” explicit spot, perp, and hip3 order namespaces with risk controls
  • Fund transfers β€” spot/perp transfer using master-wallet signing
  • Onchain analytics β€” mids, holder distribution, liquidation maps, leaderboard (via dPro API)
  • Flexible invocation β€” canonical commands, slash-style input, or natural language
  • Programmatic API β€” runHyperliquidSkill(...) entry point for automation

Usage Examples

dpro-hl quote BTC
dpro-hl book ETH --levels 5
dpro-hl movers --top 5
dpro-hl positions
dpro-hl perp order limit buy 0.01 BTC 50000
dpro-hl transfer 10 --to perp
dpro-hl onchain mids

Programmatic

import { runHyperliquidSkill } from './scripts/entry.mjs';

const quote = await runHyperliquidSkill('dpro-hl quote BTC');
console.log(quote);

Reference Docs

Document Description
SKILL.md Routing, execution, and safety policies
references/commands.md Full command surface β€” all commands, flags, and argument shapes
references/onchain.md Onchain endpoint behavior and normalization
references/troubleshooting.md Symptom-to-fix diagnostic guide

Safety Highlights

  • Live writes require an explicit market namespace: spot, perp, or hip3
  • Transfers use the top-level command: dpro-hl transfer <usd> [--to perp|spot]
  • Private keys are AES-encrypted at rest β€” never stored in plain text
  • Prefer runtime password input over inline password flags
  • Onchain reads are read-only (dPro API at https://api.d.pro/)

Project Structure

docs/                           # Tutorials β€” start here
references/                     # Full command + onchain + troubleshooting docs
scripts/
β”œβ”€β”€ entry.mjs                   # Single entry point: runHyperliquidSkill()
β”œβ”€β”€ auto-upgrade.mjs            # Per-invocation auto-upgrade checks
β”œβ”€β”€ parser.mjs                  # Input parsing (command + natural language)
β”œβ”€β”€ router.mjs                  # AST -> command handler dispatch
β”œβ”€β”€ format.mjs                  # Structured result -> text output
β”œβ”€β”€ clients/                    # info / exchange / onchain API clients
β”œβ”€β”€ resolvers/                  # Asset, account, market resolution
β”œβ”€β”€ commands/                   # market / account / trade / transfer / onchain
└── tests/                      # Unit tests (node:test)

Referral

Join Hyperliquid: https://app.hyperliquid.xyz/join/DPRO1

License

MIT

About

🧠 dPro + Hyperliquid operational toolkit for spot, perp, and HIP-3 trading and onchain analytics, with market/account reads, readiness checks, and secure fund transfers.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors