1m-trade 0.3.0__tar.gz

1m_trade-0.3.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

1m_trade-0.3.0/MANIFEST.in

@@ -0,0 +1,11 @@
+include README.md
+include LICENSE
+include pyproject.toml
+
+recursive-include src *.py
+global-exclude *.pyc
+recursive-exclude **/__pycache__ *
+
+# 避免把临时的脚本目录打进包里（此仓库当前代码已迁移到 src/）。
+recursive-exclude scripts *
+

1m_trade-0.3.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: 1m-trade
+Version: 0.3.0
+Summary: Hyperliquid trading and query CLI (HIP-3 supported)
+License: MIT
+Keywords: hyperliquid,trading,dex,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: hyperliquid-python-sdk
+Requires-Dist: websockets<12.0,>=11.0
+Requires-Dist: python-dotenv
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: eth-account
+Requires-Dist: requests
+Requires-Dist: msgpack
+Requires-Dist: web3
+Requires-Dist: eth-abi
+Requires-Dist: eth-utils
+Dynamic: license-file
+
+# 1m-trade
+
+Hyperliquid trading and query CLI (HIP-3 supported).
+
+## Install
+
+```bash
+pip install 1m-trade
+```
+
+## Usage
+
+The CLI command is `hl1m`.
+
+It loads environment variables from:
+
+1. `OPENCLAW_STATE_DIR` (if set)
+2. `OPENCLAW_HOME/.openclaw/.1m-trade/.env`
+3. `~/.openclaw/.1m-trade/.env`
+
+### Query examples
+
+```bash
+hl1m query-user-state
+hl1m query-open-orders
+hl1m query-meta
+hl1m query-kline --coin BTC --period 1m --start 1700000000000 --end 1700003600000
+```
+
+### Trading examples
+
+> 需要设置私钥环境变量（例如 `HYPERLIQUID_PRIVATE_KEY`，或 `HYPERLIQUID_PRIVATE_KEY_ENC` + `HYPERLIQUID_PK_ENC_PASSWORD`）。
+
+```bash
+hl1m place-order --coin BTC --is-buy true --qty 0.01 --limit-px 60000 --tif Gtc
+hl1m market-order --coin BTC --is-buy true --qty 0.01 --slippage 0.02
+hl1m cancel-order --coin BTC
+hl1m update-leverage --coin BTC --leverage 5 --is-cross true
+hl1m market-close --coin BTC --qty 0.01 --slippage 0.02
+```
+
+### Wallet examples
+
+```bash
+hl1m create-wallet
+hl1m init-wallet --pri_key 0xYourPrivateKey
+hl1m init-wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m init_wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m send-private-key --target openclaw_target
+hl1m start-listener
+hl1m register-wallet 0xYourDepositAddress
+```
+
+## License
+
+MIT
+

1m_trade-0.3.0/README.md

@@ -0,0 +1,57 @@
+# 1m-trade
+
+Hyperliquid trading and query CLI (HIP-3 supported).
+
+## Install
+
+```bash
+pip install 1m-trade
+```
+
+## Usage
+
+The CLI command is `hl1m`.
+
+It loads environment variables from:
+
+1. `OPENCLAW_STATE_DIR` (if set)
+2. `OPENCLAW_HOME/.openclaw/.1m-trade/.env`
+3. `~/.openclaw/.1m-trade/.env`
+
+### Query examples
+
+```bash
+hl1m query-user-state
+hl1m query-open-orders
+hl1m query-meta
+hl1m query-kline --coin BTC --period 1m --start 1700000000000 --end 1700003600000
+```
+
+### Trading examples
+
+> 需要设置私钥环境变量（例如 `HYPERLIQUID_PRIVATE_KEY`，或 `HYPERLIQUID_PRIVATE_KEY_ENC` + `HYPERLIQUID_PK_ENC_PASSWORD`）。
+
+```bash
+hl1m place-order --coin BTC --is-buy true --qty 0.01 --limit-px 60000 --tif Gtc
+hl1m market-order --coin BTC --is-buy true --qty 0.01 --slippage 0.02
+hl1m cancel-order --coin BTC
+hl1m update-leverage --coin BTC --leverage 5 --is-cross true
+hl1m market-close --coin BTC --qty 0.01 --slippage 0.02
+```
+
+### Wallet examples
+
+```bash
+hl1m create-wallet
+hl1m init-wallet --pri_key 0xYourPrivateKey
+hl1m init-wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m init_wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m send-private-key --target openclaw_target
+hl1m start-listener
+hl1m register-wallet 0xYourDepositAddress
+```
+
+## License
+
+MIT
+

1m_trade-0.3.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "1m-trade"
+version = "0.3.0"
+description = "Hyperliquid trading and query CLI (HIP-3 supported)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["hyperliquid", "trading", "dex", "cli"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+  "hyperliquid-python-sdk",
+  "websockets>=11.0,<12.0",
+  "python-dotenv",
+  "cryptography>=42.0.0",
+  "eth-account",
+  "requests",
+  "msgpack",
+  "web3",
+  "eth-abi",
+  "eth-utils",
+]
+
+[project.scripts]
+"hl1m" = "hl1m_cli.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["hl1m_cli*"]
+

1m_trade-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

1m_trade-0.3.0/src/1m_trade.egg-info/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: 1m-trade
+Version: 0.3.0
+Summary: Hyperliquid trading and query CLI (HIP-3 supported)
+License: MIT
+Keywords: hyperliquid,trading,dex,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: hyperliquid-python-sdk
+Requires-Dist: websockets<12.0,>=11.0
+Requires-Dist: python-dotenv
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: eth-account
+Requires-Dist: requests
+Requires-Dist: msgpack
+Requires-Dist: web3
+Requires-Dist: eth-abi
+Requires-Dist: eth-utils
+Dynamic: license-file
+
+# 1m-trade
+
+Hyperliquid trading and query CLI (HIP-3 supported).
+
+## Install
+
+```bash
+pip install 1m-trade
+```
+
+## Usage
+
+The CLI command is `hl1m`.
+
+It loads environment variables from:
+
+1. `OPENCLAW_STATE_DIR` (if set)
+2. `OPENCLAW_HOME/.openclaw/.1m-trade/.env`
+3. `~/.openclaw/.1m-trade/.env`
+
+### Query examples
+
+```bash
+hl1m query-user-state
+hl1m query-open-orders
+hl1m query-meta
+hl1m query-kline --coin BTC --period 1m --start 1700000000000 --end 1700003600000
+```
+
+### Trading examples
+
+> 需要设置私钥环境变量（例如 `HYPERLIQUID_PRIVATE_KEY`，或 `HYPERLIQUID_PRIVATE_KEY_ENC` + `HYPERLIQUID_PK_ENC_PASSWORD`）。
+
+```bash
+hl1m place-order --coin BTC --is-buy true --qty 0.01 --limit-px 60000 --tif Gtc
+hl1m market-order --coin BTC --is-buy true --qty 0.01 --slippage 0.02
+hl1m cancel-order --coin BTC
+hl1m update-leverage --coin BTC --leverage 5 --is-cross true
+hl1m market-close --coin BTC --qty 0.01 --slippage 0.02
+```
+
+### Wallet examples
+
+```bash
+hl1m create-wallet
+hl1m init-wallet --pri_key 0xYourPrivateKey
+hl1m init-wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m init_wallet --address 0xYourPublicAddress --pri_key 0xYourPrivateKey
+hl1m send-private-key --target openclaw_target
+hl1m start-listener
+hl1m register-wallet 0xYourDepositAddress
+```
+
+## License
+
+MIT
+

1m_trade-0.3.0/src/1m_trade.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/1m_trade.egg-info/PKG-INFO
+src/1m_trade.egg-info/SOURCES.txt
+src/1m_trade.egg-info/dependency_links.txt
+src/1m_trade.egg-info/entry_points.txt
+src/1m_trade.egg-info/requires.txt
+src/1m_trade.egg-info/top_level.txt
+src/hl1m_cli/__init__.py
+src/hl1m_cli/__main__.py
+src/hl1m_cli/cli.py
+src/hl1m_cli/constants.py
+src/hl1m_cli/exchange.py
+src/hl1m_cli/info.py
+src/hl1m_cli/secrets.py
+src/hl1m_cli/wallet.py

1m_trade-0.3.0/src/1m_trade.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

1m_trade-0.3.0/src/1m_trade.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hl1m = hl1m_cli.cli:main

1m_trade-0.3.0/src/1m_trade.egg-info/requires.txt

@@ -0,0 +1,10 @@
+hyperliquid-python-sdk
+websockets<12.0,>=11.0
+python-dotenv
+cryptography>=42.0.0
+eth-account
+requests
+msgpack
+web3
+eth-abi
+eth-utils

1m_trade-0.3.0/src/1m_trade.egg-info/top_level.txt

@@ -0,0 +1 @@
+hl1m_cli

1m_trade-0.3.0/src/hl1m_cli/__init__.py

@@ -0,0 +1,10 @@
+"""
+Hyperliquid trading and query helpers.
+
+This package exposes a CLI entry point via `hl1m`.
+"""
+
+from .cli import main
+
+__all__ = ["main"]
+

1m_trade-0.3.0/src/hl1m_cli/__main__.py

@@ -0,0 +1,6 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    main()
+

1m_trade-0.3.0/src/hl1m_cli/cli.py

@@ -0,0 +1,210 @@
+import argparse
+import time
+import json
+from pathlib import Path
+import os
+
+from dotenv import load_dotenv
+
+from .info import query_info
+from .exchange import exchange_order
+from .wallet import create_wallet, init_wallet, register_wallet, send_private_key_to_target, start_listener
+from .secrets import get_env_path, init_env_file
+
+def load_env(override: bool = False) -> bool:
+    """
+    Load the OpenClaw state `.env` file (path来自 `secrets.get_env_path()`).
+    """
+
+    # Ensure state directory + .env exists (create empty file if needed).
+    init_env_file()
+    env_path = get_env_path()
+
+    # Load via python-dotenv (supports override/interpolation)
+    success = load_dotenv(env_path, override=override)
+
+    if success:
+        print(f"Loaded OpenClaw env: {env_path}")
+    else:
+        print(f"Failed to load or empty: {env_path}")
+
+    return success
+
+
+def str2bool(v):
+    if isinstance(v, bool):
+        return v
+    if v.lower() in ("yes", "true", "t", "1"):
+        return True
+    elif v.lower() in ("no", "false", "f", "0"):
+        return False
+    else:
+        raise argparse.ArgumentTypeError("Boolean value expected.")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Hyperliquid SDK full-feature CLI (HIP-3 supported)")
+    parser.add_argument("--testnet", action="store_true", help="Use testnet")
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # ==================== query cli params====================
+    subparsers.add_parser("query-user-state", help="Query user state (positions + balances)").add_argument(
+        "--address", help="Optional address (derived from private key by default)"
+    )
+    subparsers.add_parser("query-open-orders", help="Query open orders")
+    subparsers.add_parser("query-fills", help="Query fills / trade history")
+    subparsers.add_parser("query-meta", help="Query asset metadata (all symbols)")
+    subparsers.add_parser("query-mids", help="Query mid prices (all symbols)")
+
+    # define K line params
+    query_kline = subparsers.add_parser("query-kline", help="Query kline/candles for a symbol")
+    query_kline.add_argument("--coin", required=True, help="Symbol, e.g. BTC or xyz:TSLA")
+    query_kline.add_argument(
+        "--period",
+        required=True,
+        help="Kline period: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M",
+    )
+    # default start and end
+    end = int(time.time() * 1000)
+    start = end - 86400000
+    query_kline.add_argument("--start", default=start, type=int, help="Start time (ms). Default: last 24 hours")
+    query_kline.add_argument("--end", type=int, default=end, help="End time (ms). Default: now")
+
+    # ==================== trade cli params ====================
+    order_parser = subparsers.add_parser("place-order", help="Place a limit order (HIP-3 supported)")
+    order_parser.add_argument("--coin", required=True, help="Symbol, e.g. BTC or xyz:TSLA")
+    order_parser.add_argument("--is-buy", type=str2bool, required=True, help="True=buy (long), False=sell (short)")
+    order_parser.add_argument("--qty", type=float, required=True, help="Size/quantity")
+    order_parser.add_argument("--limit-px", type=float, required=True, help="Limit price")
+    order_parser.add_argument("--tif", choices=["Gtc", "Ioc", "Alo"], default="Gtc", help="Time in force")
+    order_parser.add_argument("--reduce-only", action="store_true", help="Reduce-only")
+
+    market_parser = subparsers.add_parser("market-order", help="Place a market order (recommended for HIP-3)")
+    market_parser.add_argument("--coin", required=True, help="Symbol, e.g. BTC or xyz:TSLA")
+    market_parser.add_argument("--is-buy", type=str2bool, required=True, help="True=buy (long), False=sell (short)")
+    market_parser.add_argument("--qty", required=True, type=float, help="Size/quantity")
+    market_parser.add_argument("--slippage", type=float, default=0.02, help="Slippage tolerance (default: 2%)")
+
+    market_close_parser = subparsers.add_parser("market-close", help="Close a position with a market order (recommended for HIP-3)")
+    market_close_parser.add_argument("--coin", required=True, help="Symbol, e.g. BTC or xyz:TSLA")
+    market_close_parser.add_argument("--qty", required=True, type=float, help="Size/quantity")
+    market_close_parser.add_argument("--slippage", type=float, default=0.02, help="Slippage tolerance (default: 2%)")
+
+    cancel_parser = subparsers.add_parser("cancel-order", help="Cancel orders")
+    cancel_parser.add_argument("--oid", type=int, help="Order ID")
+    cancel_parser.add_argument("--coin", help="Symbol, e.g. BTC or xyz:TSLA")
+
+    lev_parser = subparsers.add_parser("update-leverage", help="Update leverage")
+    lev_parser.add_argument("--coin", required=True, help="Symbol")
+    lev_parser.add_argument("--leverage", type=int, required=True, help="Leverage (integer)")
+    lev_parser.add_argument("--is-cross", type=str2bool, default=True, help="True=cross margin")
+
+    iso_margin_parser = subparsers.add_parser("update-isolated-margin", help="Transfer isolated margin for HIP-3")
+    iso_margin_parser.add_argument("--amount", type=int, required=True, help="Transfer amount")
+    iso_margin_parser.add_argument("--coin", required=True, help="Symbol, e.g. BTC or xyz:TSLA")
+
+    # ==================== wallet cli params ====================
+    create_wallet_parser = subparsers.add_parser("create-wallet", help="Create funding wallet (encrypt + persist)")
+    create_wallet_parser.add_argument("openclaw_target", nargs="?", help="Optional OpenClaw user id (Stage 3: send private key)")
+    create_wallet_parser.add_argument(
+        "--lang",
+        choices=["zh", "en"],
+        default="en",
+        help="Language for Stage 3 private-key message (zh/en)",
+    )
+
+    init_wallet_parser = subparsers.add_parser("init-wallet", help="Init wallet with user-provided address + private key")
+    init_wallet_parser.add_argument("--address", required=False, help="Optional wallet public address (0x...). If omitted, derive from --pri_key")
+    init_wallet_parser.add_argument("--pri_key", required=True, help="Wallet private key (0x...)")
+
+    # Backward/compat alias (underscore version)
+    init_wallet_alias_parser = subparsers.add_parser("init_wallet", help="Alias of init-wallet")
+    init_wallet_alias_parser.add_argument("--address", required=False, help="Optional wallet public address (0x...). If omitted, derive from --pri_key")
+    init_wallet_alias_parser.add_argument("--pri_key", required=True, help="Wallet private key (0x...)")
+
+    send_pk_parser = subparsers.add_parser("send-private-key", help="Send private key via OpenClaw message (Stage 3)")
+    send_pk_parser.add_argument("--target", required=True, help="OpenClaw user id / target")
+    send_pk_parser.add_argument(
+        "--lang",
+        choices=["zh", "en"],
+        default="en",
+        help="Language for the private-key message (zh/en)",
+    )
+
+    subparsers.add_parser("start-listener", help="Bridge ALL USDC via Relay and activate Hyperliquid L1")
+
+    register_wallet_parser = subparsers.add_parser(
+        "register-wallet",
+        help="Register HYPERLIQUID_WALLET_ADDRESS from .env with api.1m-trade.com",
+    )
+    register_wallet_parser.add_argument("--quiet", action="store_true", help="Suppress success message")
+
+    args = parser.parse_args()
+    needs_env = args.command not in {"create-wallet", "register-wallet", "init-wallet", "init_wallet"}
+    env_loaded = True
+    if needs_env:
+        env_loaded = load_env()
+
+    # about query
+    if args.command.startswith("query-"):
+        if env_loaded is False:
+            print("Warning: env file not found (required for querying)")
+            return
+        result = query_info(parser=parser)
+        print(json.dumps(result, indent=2, default=str))
+        return
+
+    # about trade
+    if args.command in [
+        "place-order",
+        "market-order",
+        "cancel-order",
+        "update-leverage",
+        "market-close",
+        "update-isolated-margin",
+    ]:
+        if env_loaded is False:
+            print("Warning: env file not found (required for trading)")
+            return
+        result = exchange_order(parser)
+        print(json.dumps(result, indent=2, default=str))
+        return
+
+    # about wallet
+    if args.command in {"init-wallet", "init_wallet"}:
+        ok_addr = init_wallet(args.address, args.pri_key)
+        if ok_addr is None:
+            raise SystemExit(1)
+        return
+
+    if args.command == "create-wallet":
+        create_wallet(
+            openclaw_target=getattr(args, "openclaw_target", None),
+            lang=args.lang,
+        )
+        return
+
+    if args.command == "send-private-key":
+        out = send_private_key_to_target(args.target, lang=args.lang)
+        print(json.dumps(out, indent=2, default=str))
+        return
+
+    if args.command == "start-listener":
+        if env_loaded is False:
+            print("Warning: env file not found (start-listener will likely fail to decrypt private key)")
+        ok = start_listener()
+        if not ok:
+            raise SystemExit(1)
+        return
+
+    if args.command == "register-wallet":
+        ok = register_wallet(notice=not bool(getattr(args, "quiet", False)))
+        if not ok:
+            raise SystemExit(1)
+        return
+
+
+if __name__ == "__main__":
+    main()
+

1m_trade-0.3.0/src/hl1m_cli/constants.py

@@ -0,0 +1,50 @@
+"""
+Package-wide static configuration.
+
+Note: keep values inside this package (not inside .venv/.site-packages) so they
+are versioned and included when publishing to PyPI.
+"""
+
+# Relay lightning funding + auto transfer to HL
+RPC_URL = "https://arb1.arbitrum.io/rpc"
+HL_API_URL = "https://api.hyperliquid.xyz/exchange"
+RELAY_API_URL = "https://api.relay.link/quote/v2"
+REGISTER_1M_TRADE_API = "https://api.1m-trade.com/api/register"
+REGISTER_CONSENT_ENV = "ONE_M_TRADE_REGISTER_CONSENT"
+
+# Chain IDs
+ARB_CHAIN_ID = 42161
+HL_CHAIN_ID = 1337
+
+# Native token (Arbitrum ETH)
+HL_USDC_ADDRESS = "0x00000000000000000000000000000000"
+NATIVE_TOKEN = "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
+
+ERC20_ABI = [
+    {
+        "type": "function",
+        "name": "balanceOf",
+        "stateMutability": "view",
+        "inputs": [{"name": "account", "type": "address"}],
+        "outputs": [{"name": "", "type": "uint256"}],
+    },
+    {
+        "type": "function",
+        "name": "decimals",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [{"name": "", "type": "uint8"}],
+    },
+]
+
+# Hyperliquid referrer code
+REFERRER_CODE = "HYPERCLAW"
+
+# OpenClaw state
+OPENCLAW_STATE_SUBDIR = ".1m-trade"
+OPENCLAW_ENV_FILENAME = ".env"
+
+# Encrypted private key env var names (at-rest encryption)
+PRIVATE_KEY_ENC_KEY = "HYPERLIQUID_PRIVATE_KEY_ENC"
+PRIVATE_KEY_ENC_PASSWORD_KEY = "HYPERLIQUID_PK_ENC_PASSWORD"
+