async-hyperliquid 1.2.0__tar.gz → 1.2.1__tar.gz

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.1] - 2026-11-03
+
+### Changed
+
+- Accept `sz=0` in order and modify requests; it is encoded as `"0"` and left to
+  the exchange to validate. Negative sizes are still rejected, and `place_twap()`
+  still requires a positive size.
+- Reload metadata once when a lookup misses the cached snapshot, so markets
+  listed after the first load resolve without `refresh_metadata()`. A failed
+  reload keeps the last snapshot and the lookup still raises `ValueError`.
+- Reject non-finite or non-positive order prices with
+  `price must be finite and greater than zero`; a positive price that rounds to
+  zero now reports `order price is below market precision`.
+- Market orders raise `ProtocolError` when the mid price is not finite and
+  positive, instead of reporting an invalid order price.
+
 ## [1.2.0] - 2026-11-03
 
 ### Added

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-hyperliquid
-Version: 1.2.0
+Version: 1.2.1
 Summary: Async Hyperliquid client using aiohttp
 Keywords: dex,hyperliquid,async,aiohttp,trading,cryptocurrency,defi
 Author: Yuki
@@ -36,7 +36,7 @@ Description-Content-Type: text/markdown
 
 [![CI](https://github.com/owlyfi/async-hyperliquid/actions/workflows/ci.yml/badge.svg)](https://github.com/owlyfi/async-hyperliquid/actions/workflows/ci.yml)
 [![Documentation Status](https://readthedocs.org/projects/async-hyperliquid/badge/?version=latest)](https://async-hyperliquid.readthedocs.io/en/latest/)
-[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg?v=1.2.0)](https://pypi.org/project/async-hyperliquid/)
+[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg?v=1.2.1)](https://pypi.org/project/async-hyperliquid/)
 
 `async-hyperliquid` is a typed, asynchronous Python client for the Hyperliquid
 REST API. It provides credential-free market and account queries through

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/owlyfi/async-hyperliquid/actions/workflows/ci.yml/badge.svg)](https://github.com/owlyfi/async-hyperliquid/actions/workflows/ci.yml)
 [![Documentation Status](https://readthedocs.org/projects/async-hyperliquid/badge/?version=latest)](https://async-hyperliquid.readthedocs.io/en/latest/)
-[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg?v=1.2.0)](https://pypi.org/project/async-hyperliquid/)
+[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg?v=1.2.1)](https://pypi.org/project/async-hyperliquid/)
 
 `async-hyperliquid` is a typed, asynchronous Python client for the Hyperliquid
 REST API. It provides credential-free market and account queries through

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/docs/coin-name-mapping.md

@@ -13,6 +13,13 @@ The first lookup loads metadata. Concurrent cold lookups share one load;
 `refresh_metadata()` explicitly replaces the last complete snapshot. A partial
 or inconsistent response is rejected without publishing partial state.
 
+A lookup for a coin missing from the cached snapshot reloads metadata once
+before raising, so markets listed after the first load resolve without an
+explicit refresh. If that reload fails, the last snapshot stays in place and the
+lookup still raises `ValueError`. Misses are not cached: every lookup of an
+unknown coin repeats the reload, so validate user input before it reaches a hot
+path.
+
 ## Asset spaces
 
 | Market | Asset ID |

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/docs/howto/markets.rst

@@ -17,7 +17,8 @@ helpers instead of deriving protocol offsets in application code.
 The first metadata lookup loads one immutable snapshot. Concurrent cold
 lookups share that load. ``refresh_metadata()`` atomically replaces the last
 complete snapshot; malformed or inconsistent metadata is rejected before it is
-published.
+published. A lookup for a coin missing from the cached snapshot reloads
+metadata once before raising ``ValueError``.
 
 Coin forms
 ----------

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/docs/locale/zh_CN/LC_MESSAGES/coin-name-mapping.po

@@ -63,6 +63,19 @@ msgstr ""
 "首次查询会加载元数据。并发冷查询共享同一次加载；`refresh_metadata()` 会显式替换最近一次完整快照。"
 "不完整或不一致的响应会被拒绝，且不会发布部分状态。"
 
+#: ../../coin-name-mapping.md:16
+msgid ""
+"A lookup for a coin missing from the cached snapshot reloads metadata "
+"once before raising, so markets listed after the first load resolve "
+"without an explicit refresh. If that reload fails, the last snapshot stays "
+"in place and the lookup still raises `ValueError`. Misses are not cached: "
+"every lookup of an unknown coin repeats the reload, so validate user input "
+"before it reaches a hot path."
+msgstr ""
+"若查询的 coin 不在缓存快照中，会先重新加载一次元数据再抛出错误，因此首次加载之后新上线的市场无需显式刷新即可解析。"
+"如果这次重新加载失败，会保留上一次的快照，查询仍然抛出 `ValueError`。未命中的结果不会被缓存："
+"每次查询未知 coin 都会重新加载一次，因此请在用户输入进入热路径之前先做校验。"
+
 #: ../../coin-name-mapping.md:16 667c70e0123949059329339edf3f8ca6
 msgid "Asset spaces"
 msgstr "资产编号空间"

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/docs/locale/zh_CN/LC_MESSAGES/howto/markets.po

@@ -34,10 +34,12 @@ msgid ""
 "The first metadata lookup loads one immutable snapshot. Concurrent cold "
 "lookups share that load. ``refresh_metadata()`` atomically replaces the "
 "last complete snapshot; malformed or inconsistent metadata is rejected "
-"before it is published."
+"before it is published. A lookup for a coin missing from the cached "
+"snapshot reloads metadata once before raising ``ValueError``."
 msgstr ""
 "首次元数据查询会加载一个不可变快照。并发的冷查询会共享该加载。``refresh_metadata()`` 会原子地替换最后一个完整快照；"
-"格式错误或不一致的元数据会在发布前被拒绝。"
+"格式错误或不一致的元数据会在发布前被拒绝。若查询的 coin 不在缓存快照中，会先重新加载一次元数据，"
+"仍未命中才抛出 ``ValueError``。"
 
 #: ../../howto/markets.rst:23 a74ae47aabbf4ba5817d21a500d064ae
 msgid "Coin forms"

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "async-hyperliquid"
-version = "1.2.0"
+version = "1.2.1"
 requires-python = ">=3.12"
 description = "Async Hyperliquid client using aiohttp"
 authors = [{ name = "Yuki", email = "yuqi.lyle@gmail.com" }]

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/src/async_hyperliquid/_internal/encoding.py

@@ -19,8 +19,10 @@ def _round_size(value: float, size_decimals: int) -> float | int:
 
 def _normalize_size(value: float, size_decimals: int) -> float | int:
     size = float(value)
-    if not math.isfinite(size) or size <= 0:
-        raise ValueError("size must be finite and greater than zero")
+    if not math.isfinite(size) or size < 0:
+        raise ValueError("size must be finite and non-negative")
+    if size == 0:
+        return 0
     rounded = _round_size(size, size_decimals)
     if rounded <= 0:
         raise ValueError("order size is below market precision")
@@ -49,13 +51,15 @@ def _normalize_price(
     value: float | str, *, max_decimals: int, is_outcome: bool
 ) -> float | int:
     price = float(value)
+    if not math.isfinite(price) or price <= 0:
+        raise ValueError("price must be finite and greater than zero")
     if is_outcome and not OUTCOME_MIN_PRICE <= price <= OUTCOME_MAX_PRICE:
         raise ValueError("outcome price must be between 0.00001 and 0.99999 USDC")
     rounded = _round_price(
         price, OUTCOME_PRICE_DECIMALS if is_outcome else max_decimals
     )
     if rounded <= 0:
-        raise ValueError("order value is below market precision")
+        raise ValueError("order price is below market precision")
     return rounded
 
 

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/src/async_hyperliquid/_internal/metadata.py

@@ -251,8 +251,16 @@ def _build_metadata(
     )
 
 
+def _is_outcome_coin(coin: str) -> bool:
+    return coin.startswith(("#", "+"))
+
+
+def _is_known_coin(snapshot: _MetadataSnapshot, coin: str) -> bool:
+    return _is_outcome_coin(coin) or coin in snapshot.coin_by_alias
+
+
 def _outcome_market_info(coin: str) -> _MarketInfo | None:
-    if not coin.startswith(("#", "+")):
+    if not _is_outcome_coin(coin):
         return None
     raw_encoding = coin[1:]
     if not raw_encoding.isascii() or not raw_encoding.isdecimal():

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/src/async_hyperliquid/client.py

@@ -57,6 +57,8 @@ def _coin_dex(coin: str) -> str:
 def _market_price(
     mid: float, *, is_buy: bool, slippage: float, is_outcome: bool
 ) -> float:
+    if not math.isfinite(mid) or mid <= 0:
+        raise ProtocolError("mid price must be finite and greater than zero")
     price = mid * (1 + slippage if is_buy else 1 - slippage)
     if not is_outcome:
         return price
@@ -484,6 +486,8 @@ class AsyncHyperliquid:
         if market.is_spot and reduce_only:
             raise ValueError("spot orders cannot be reduce-only")
         rounded_size = _normalize_size(size, market.size_decimals)
+        if rounded_size == 0:
+            raise ValueError("TWAP size must be greater than zero")
         details: EncodedTwapDetails | None = None
         if trigger_px is not None or stop_px is not None:
             encoded_trigger_px = (

{async_hyperliquid-1.2.0 → async_hyperliquid-1.2.1}/src/async_hyperliquid/info.py

@@ -1,4 +1,5 @@
 import asyncio
+import logging
 from collections.abc import Sequence
 from types import TracebackType
 from typing import Literal, Self, cast, overload
@@ -23,9 +24,10 @@ from ._internal.metadata import (
     _MarketInfo,
     _MetadataSnapshot,
     _build_metadata,
+    _is_known_coin,
     _market_info,
 )
-from .errors import ProtocolError
+from .errors import HyperliquidError, ProtocolError
 from .types import CandleInterval, JsonObject, JsonValue, Network
 from .types.info import (
     AccountState,
@@ -73,6 +75,9 @@ from .types.info import (
 )
 
 
+logger = logging.getLogger(__name__)
+
+
 class InfoClient:
     """Asynchronous, credential-free client for Hyperliquid Info endpoints."""
 
@@ -506,15 +511,32 @@ class InfoClient:
             snapshot = await self._load_metadata()
             self._metadata = snapshot
 
-    async def coin_name(self, coin: str) -> str:
+    async def _metadata_for(self, *coins: str) -> _MetadataSnapshot:
+        cold = self._metadata is None
         snapshot = await self._ensure_metadata()
+        if cold or all(_is_known_coin(snapshot, coin) for coin in coins):
+            return snapshot
+        async with self._get_metadata_lock():
+            # Concurrent misses on the same stale snapshot share one reload.
+            if self._metadata is snapshot:
+                try:
+                    self._metadata = await self._load_metadata()
+                except (HyperliquidError, TimeoutError):
+                    # Keep the miss a ValueError raised by the caller's lookup.
+                    logger.debug("metadata refresh after a miss failed", exc_info=True)
+                    return snapshot
+            # Refreshes only replace a published snapshot, never clear it.
+            return cast(_MetadataSnapshot, self._metadata)
+
+    async def coin_name(self, coin: str) -> str:
+        snapshot = await self._metadata_for(coin)
         name = snapshot.coin_by_alias.get(coin)
         if name is None:
             raise ValueError(f"unknown coin: {coin}")
         return name
 
     async def coin_symbol(self, coin: str) -> str:
-        snapshot = await self._ensure_metadata()
+        snapshot = await self._metadata_for(coin)
         name = snapshot.coin_by_alias.get(coin)
         if name is None:
             raise ValueError(f"unknown coin: {coin}")
@@ -530,14 +552,14 @@ class InfoClient:
         return (await self._market_info(coin)).size_decimals
 
     async def _market_info(self, coin: str) -> _MarketInfo:
-        return _market_info(await self._ensure_metadata(), coin)
+        return _market_info(await self._metadata_for(coin), coin)
 
     async def _market_infos(self, coins: Sequence[str]) -> tuple[_MarketInfo, ...]:
-        snapshot = await self._ensure_metadata()
+        snapshot = await self._metadata_for(*coins)
         return tuple(_market_info(snapshot, coin) for coin in coins)
 
     async def spot_token_metadata(self, coin: str) -> SpotToken:
-        snapshot = await self._ensure_metadata()
+        snapshot = await self._metadata_for(coin)
         name = snapshot.coin_by_alias.get(coin)
         token = None if name is None else snapshot.spot_token_by_coin.get(name)
         if token is None:
@@ -548,7 +570,7 @@ class InfoClient:
         return (await self.spot_token_metadata(coin))["tokenId"]
 
     async def mark_price(self, coin: str) -> float:
-        snapshot = await self._ensure_metadata()
+        snapshot = await self._metadata_for(coin)
         name = snapshot.coin_by_alias.get(coin)
         if name is None:
             raise ValueError(f"unknown coin: {coin}")