Files
himself65__finance-skills/opencli-plugins/hyperliquid/mids.js
T
Alex Yang 8072082fda feat: add hyperliquid-reader skill + opencli plugin (#76)
* feat: add hyperliquid-reader skill + opencli plugin

Add a read-only Hyperliquid (app.hyperliquid.xyz) reader, mirroring the
tradingview-reader pattern. Unlike TradingView's CDP attach, Hyperliquid
exposes a fully public info API (POST https://api.hyperliquid.xyz/info),
so this needs no API key, wallet, login, or desktop app.

opencli plugin (opencli-plugins/hyperliquid/) — 12 read-only commands:
- Market data: markets, spot-markets, mids, book, candles,
  funding-history, funding-compare (cross-venue HL/Binance/Bybit
  funding-arb screen).
- Account by 0x address: account, positions, spot-balances,
  open-orders, fills.

Skill (plugins/data-providers/skills/hyperliquid-reader/) — SKILL.md
(5-step + error reference), README.md, references/commands.md.

Registrations: root opencli-plugin.json, data-providers plugin.json
(description + keywords), marketplace.json, root README table.

Verification: 31 unit tests pass against captured live wire shapes;
all 12 command data paths smoke-tested end-to-end against the live API.
SKILL.md description is 1019 chars (< 1024 lint cap), no angle brackets.

No trade execution: the plugin exposes no write/exchange endpoints.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

* refactor: scope hyperliquid-reader to market data only

Drop the account-by-address commands (account, positions, spot-balances,
open-orders, fills) and their lib/account.js + lib/orders.js helpers and
tests. Remove the now-unused normalizeAddress helper from lib/api.js.

The reader is now market-data only: markets, spot-markets, mids, book,
candles, funding-history, funding-compare (7 commands). Updated SKILL.md,
both READMEs, references/commands.md, the plugin/marketplace manifests,
and the root README table accordingly.

21 unit tests pass; all 7 market-data data paths re-verified live.
2026-06-07 16:21:26 -07:00

35 lines
1.1 KiB
JavaScript

/**
* hyperliquid mids — current mid price for every market via `allMids`.
* Perp mids are keyed by coin name; spot mids by "@<index>", resolved to the
* pair name via `spotMeta`.
*/
import { cli, Strategy } from '@jackwener/opencli/registry';
import { infoFetch } from './lib/api.js';
import { resolveMids } from './lib/markets.js';
cli({
site: 'hyperliquid',
name: 'mids',
description: 'Current mid price for every perp + spot market (allMids)',
access: 'read',
strategy: Strategy.PUBLIC,
browser: false,
args: [
{ name: 'coin', help: 'Case-insensitive substring filter (e.g. BTC). Omit for all markets.' },
],
columns: ['coin', 'mid'],
func: async (args) => {
const [allMids, spotMeta] = await Promise.all([
infoFetch({ type: 'allMids' }),
infoFetch({ type: 'spotMeta' }),
]);
const rows = resolveMids(allMids, spotMeta, args.coin);
if (args.coin && rows.length === 0) {
throw new Error(`No market matching "${args.coin}".`);
}
rows.sort((a, b) => String(a.coin).localeCompare(String(b.coin)));
return rows;
},
});