Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Replaced by regard-cli

hyperliquid-cli

Agent-first CLI for Hyperliquid perpetual futures trading. Thin Python wrapper over hyperliquid-python-sdk.

Install

uv tool install hyperliquid-cli

Usage

# Read commands (no auth needed)
hl prices BTC ETH
hl book BTC --depth 10
hl assets TSLA
hl funding BTC --history
hl candles BTC 1h --limit 50

# Account commands (needs HL_PRIVATE_KEY or --address)
hl status
hl balance
hl positions
hl orders
hl fills

# Write commands (needs HL_PRIVATE_KEY)
hl order BTC buy 0.1 --market
hl order BTC buy 0.1 95000 --tp 100000 --sl 90000
hl cancel 77738308
hl cancel-all BTC
hl leverage BTC 10

Auth

Set HL_PRIVATE_KEY env var with your Hyperliquid API wallet key (can trade but cannot withdraw).

Read-only commands work without auth using --address.

Design

  • JSON-only output (stdout), debug/warnings to stderr
  • Rich exit codes (0=success, 1=input, 2=auth, 3=API, 4=asset, 5=rejected)
  • Structured errors with recovery hints
  • Field projection via --fields
  • HIP-3 asset auto-resolution (e.g. TSLA → xyz:TSLA)
  • Trade logging to data/trades.jsonl

License

MIT

Metadata

Release files for hyperliquid-cli 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hyperliquid-cli 0.1.1
File Size Uploaded
hyperliquid_cli-0.1.1.tar.gz 92.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hyperliquid-cli 0.1.1
File Interpreter ABI Platform
hyperliquid_cli-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 107.8 kB

Release files / hyperliquid_cli-0.1.1.tar.gz

Download URL hyperliquid_cli-0.1.1.tar.gz
Size 92.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e16e9533de08b7ed130ef6f1883b728f5ddbcff80446829d00321f0fa1286fc5
BLAKE2b-256 checksum
How to use checksums
06195b7555f56cac2dd62256d288fc1538a1125471c21da601e10e7091670a91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 17, 2026.

Transparency log

Release files / hyperliquid_cli-0.1.1-py3-none-any.whl

Download URL hyperliquid_cli-0.1.1-py3-none-any.whl
Size 15.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f6508c173b68f6a43b213ec8458e5fae845cacecf29c17049385df3cece0617e
BLAKE2b-256 checksum
How to use checksums
81e3d23806f9b221ecdfba580b310253217104c057ab6d5e55b463245887c295
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 17, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page