hydromancer-skills

skill
$ git clone https://github.com/joshavenue/hydromancer-skills.git ~/.claude/skills/hydromancer-hyperliquid
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 7 days ago
  • Low visibility — Only 0 GitHub stars
Code Gecti
  • Code scan — Scanned 4 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Hydromancer provides Hyperliquid APIs, real-time data streams, orderbook data, and historical datasets.

Needs a Hydromancer API key in HYDROMANCER_API_KEY for the REST and WebSocket helpers (Python 3.9+). Reservoir downloads use your own AWS credentials (requester pays). Agents other than Claude Code: point them at SKILL.md.
README.md

Hydromancer Hyperliquid skill

Disclosure: maintained by the Hydromancer team; the author works at Hydromancer.

An Agent Skill that teaches coding agents (Claude Code, Codex, Cursor and others that read SKILL.md) how to use Hyperliquid data from Hydromancer:

  • REST API (POST /info): positions for one or up to 1,000 wallets per request, orders, fills with cursor paging, funding, liquidations, oracle and mark prices, candles, vaults, staking, builder-code data, PnL, HIP-3 and HIP-4 markets.
  • WebSocket streams: trades, fills, liquidations, BBO, L2 and L4 order books, TP/SL, funding, user and builder events, with session replay after reconnects.
  • Reservoir: historical Hyperliquid data (fills, 1-second candles, daily snapshots, 1-minute L2 books) as Parquet on AWS S3; requester-pays, so AWS bills your account for requests and transfer.

Install

Claude Code, as a plugin:

/plugin marketplace add joshavenue/hydromancer-skills
/plugin install hydromancer-hyperliquid@hydromancer

Or as a personal skill:

git clone https://github.com/joshavenue/hydromancer-skills.git ~/.claude/skills/hydromancer-hyperliquid

Or per project: copy the folder into .claude/skills/hydromancer-hyperliquid/. Other agents: point them at SKILL.md; the references/ files load on demand.

Requirements

  • A Hydromancer API key in HYDROMANCER_API_KEY (how to get one).
  • Python 3.9+ for scripts/hydromancer.py (standard library only). scripts/stream_trades.py needs websockets. Tested versions are pinned in requirements.txt (and the optional SDK, by commit, in requirements-sdk.txt); install them with pip install -r requirements.txt (add -r requirements-sdk.txt for the SDK).
  • AWS credentials for Reservoir (the bucket is requester-pays; no Hydromancer key needed).

Contents

SKILL.md                  overview, essentials and pitfalls (loaded first)
references/rest-api.md    request shape, tested examples, endpoint catalog
references/websocket.md   messages, heartbeat, sessions and replay, limits, channel catalog
references/reservoir.md   S3 paths, AWS CLI and DuckDB access, cost control
references/rate-limits.md weights, windowed endpoints, 429 handling
references/recipes.md     whale tracking, wallet trade history, builder revenue, liquidations, local L4 book, HIP-4, backtesting
scripts/hydromancer.py    REST helper: info, positions, fills (cursor paging), liquidations, usage
scripts/stream_trades.py  WebSocket trades stream with heartbeat handling
requirements.txt          exact package versions the skill was tested with
requirements-sdk.txt      optional Hydromancer SDK, pinned to a commit

Links

Docs · llms.txt · Python SDK · Reservoir · Discord

License

MIT

Yorumlar (0)

Sonuc bulunamadi