hyperscope-plugins
Query and analyze Hyperliquid trader and market data via the Hyperscope APIs. Covers live state and historical analytics.
Open source Open in the app JSON README (API)
About
Query and analyze Hyperliquid trader and market data via the Hyperscope APIs. Covers live state and historical analytics.
Details
- Kind
- Plugins
- Topic
- Marketing & analytics
- Publisher
- hyperscope-sh
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-06-01T15:03:36Z
- Repository state
- ativo
- Language
- Shell
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
hyperscope-sh/hyperscope-plugins/hyperscope-plugins
README
# Hyperscope Plugins Agent skills for the [Hyperscope](https://hyperscope.sh) APIs. Distributed as a Claude Code plugin marketplace, with a curl-based installer for any agent that reads `SKILL.md`. ## Available plugins | Plugin | Skill | Description | |--------|-------|-------------| | [`hyperscope`](./plugins/hyperscope) | `hyperliquid` | Query Hyperliquid blockchain data. Auto-routes between raw `/info` RPC and curated Data API analytics. | ## API key (optional) The Hyperscope APIs have a free tier of **1000 requests/day** that works without any key (applies to both `data.hyperscope.sh` and `info.hyperscope.sh`). For higher limits, create a project at [hyperscope.sh](https://hyperscope.sh) → Dashboard → your project → **Agent** tab. The skill works either way — without a key it uses the free tier, with a key it switches to authenticated (credit-metered) mode. ## Install (Claude Code plugin) In Claude Code, run these **as two separate commands** (Claude Code only parses one slash command per prompt — pasting both at once will fail): ``` /plugin marketplace add hyperscope-sh/hyperscope-plugins ``` ``` /plugin install hyperscope@hyperscope-plugins ``` That's it — the skill is usable immediately on the free tier. To raise your limit, save a key to the location the skill checks: ```bash mkdir -p ~/.hyperscope && echo 'HYPERSCOPE_API_KEY=hs_...' > ~/.hyperscope/.env && chmod 600 ~/.hyperscope/.env ``` The skill checks `$HYPERSCOPE_API_KEY` first, then `~/.hyperscope/.env`. If you prefer a shell env var, append `export HYPERSCOPE_API_KEY=hs_...` to `~/.zshrc` or `~/.bashrc` instead. ## Install (npx skills, any agent) For a one-line install across Claude Code, Cursor, Codex CLI, Gemini CLI, and other agents that read `SKILL.md`: ```bash npx skills add hyperscope-sh/hyperscope-plugins ``` This auto-detects your harness and writes the skill to the right location (e.g. `.claude/skills/hyperliquid/`). To raise your daily limit, save a key to the location the skill checks: ```bash mkdir -p ~/.hyperscope && echo 'HYPERSCOPE_API_KEY=hs_...' > ~/.hyperscope/.env && chmod 600 ~/.hyperscope/.env ``` ## Install (curl, any agent) For project-scoped install or to write the API key in one shot: ```bash # With a key (writes it to .env automatically) curl -fsSL https://raw.githubusercontent.com/hyperscope-sh/hyperscope-plugins/main/install.sh \ | bash -s -- hyperscope <YOUR_API_KEY> # Without a key (free tier, 1000/day) curl -fsSL https://raw.githubusercontent.com/hyperscope-sh/hyperscope-plugins/main/install.sh \ | bash -s -- hyperscope ``` The skill installs into: - `<current-git-repo>/.claude/skills/hyperliquid/` (project-scoped, default in a git repo) - or `~/.claude/skills/hyperliquid/` (default outside a git repo) Force one or the other with `--local` / `--global`: ```bash curl -fsSL .../install.sh | bash -s -- hyperscope <KEY> --global ``` When provided, the key is written to the skill's local `.env` **and** to `~/.hyperscope/.env` (both chmod 600), so the skill works the same regardless of how you installed it. Nothing leaves your machine. Rerun anytime to upgrade or rotate. ## Source This repo is auto-synced from the [hyperscope monorepo](https://github.com/hyperscope-sh/hyperscope) on every change. Open issues or PRs there. ## Repo layout ``` . ├── .claude-plugin/ │ └── marketplace.json # marketplace manifest ├── plugins/ │ └── hyperscope/ │ ├── .claude-plugin/ │ │ └── plugin.json # plugin manifest │ └── skills/ │ └── hyperliquid/ │ ├── SKILL.md │ └── .env.example ├── install.sh # curl installer (non-Claude-Code path) └── README.md ```