Metadata-Version: 2.4
Name: regard-cli
Version: 0.15.0rc7
Summary: AI trading partner for the unified speculator — Hyperliquid + Polymarket
Author: tab55
License-Expression: MIT
License-File: LICENSE
Keywords: agent,cli,defi,hyperliquid,polymarket,regard,trading
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: eth-account>=0.11.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: hyperliquid-python-sdk>=0.22.0
Requires-Dist: py-clob-client-v2>=0.0.2
Requires-Dist: pydantic>=2.12
Requires-Dist: typer>=0.9.0
Requires-Dist: web3>=7.0.0
Provides-Extra: dev
Requires-Dist: mypy>=1.20; extra == 'dev'
Requires-Dist: pydantic[mypy]>=2.12; extra == 'dev'
Requires-Dist: ruff>=0.15; extra == 'dev'
Provides-Extra: test
Requires-Dist: hypothesis>=6.0; extra == 'test'
Requires-Dist: pytest>=8.0; extra == 'test'
Requires-Dist: syrupy>=4.0; extra == 'test'
Description-Content-Type: text/markdown

# regard-cli

AI trading partner for the unified speculator. Multi-venue trading CLI consumed by the [regard-computer](https://github.com/akegaviar/tabtabtabTABtab) Claude Code skill.

## Install

```bash
uv tool install regard-cli
```

## Usage

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

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

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

## Auth

Set `HYPERLIQUID_AGENT_KEY` env var with your Hyperliquid agent wallet key (can trade, cannot withdraw). Master address auto-resolved via `userRole` API.

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

## Design

- Venue-first sub-commands (`regard hl`, `regard poly`, ...)
- Output envelope: `{"ok": true, "data": ..., "meta": {"timestamp": ...}}`
- Structured errors with type/code/message, recovery hints, retryable flag
- Exit codes: 0=success, 2=validation, 3=auth, 4=venue, 5=rate_limit, 6=network
- Field projection via `--fields`
- HIP-3 asset auto-resolution (e.g. `TSLA` → `xyz:TSLA`)
- CLI-first, MCP-ready — every command maps 1:1 to an MCP tool definition

## License

MIT
