async-hyperliquid 1.0.0__tar.gz → 1.1.0__tar.gz

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.1.0] - 2026-09-14
+
+### Added
+
+- Add `InfoClient.extra_agents()` with typed API-wallet responses.
+- Add `reversed=True` to `InfoClient.user_fills()` time-range queries to request
+  the newest fills first; `start_time` is required when enabled.
+
+### Fixed
+
+- Cover ascending and mixed-order fill responses to detect unintended client-side
+  sorting, and verify reversed fill queries against complete reference windows.
+
 ## [1.0.0] - 2026-08-17
 
 ### Added

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-hyperliquid
-Version: 1.0.0
+Version: 1.1.0
 Summary: Async Hyperliquid client using aiohttp
 Keywords: dex,hyperliquid,async,aiohttp,trading,cryptocurrency,defi
 Author: Yuki
@@ -26,7 +26,7 @@ Requires-Dist: eth-utils>=5.3.1,<6.0.0
 Requires-Dist: coincurve>=21.0.0
 Requires-Python: >=3.12
 Project-URL: Homepage, https://github.com/owlyfi/async-hyperliquid
-Project-URL: Documentation, https://async-hyperliquid.readthedocs.io/
+Project-URL: Documentation, https://async-hyperliquid.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/owlyfi/async-hyperliquid
 Project-URL: Issues, https://github.com/owlyfi/async-hyperliquid/issues
 Project-URL: Changelog, https://github.com/owlyfi/async-hyperliquid/blob/main/CHANGELOG.md
@@ -35,8 +35,8 @@ Description-Content-Type: text/markdown
 # Async Hyperliquid
 
 [![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/?badge=latest)
-[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg)](https://pypi.org/project/async-hyperliquid/)
+[![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.1.0)](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
@@ -87,13 +87,36 @@ async def main() -> None:
         network=Network.TESTNET,
     ) as client:
         result = await client.place_order("BTC", True, 0.001, 0, is_market=True)
-        print(result)
+        if result["status"] == "err":
+            raise RuntimeError(result["response"])
+        status = result["response"]["data"]["statuses"][0]
+        if isinstance(status, dict) and "error" in status:
+            raise RuntimeError(status["error"])
+        print(status)
 
 
 asyncio.run(main())
 ```
 
-Learn more in the [Read the Docs documentation](https://async-hyperliquid.readthedocs.io/),
+Learn more in the [Read the Docs documentation](https://async-hyperliquid.readthedocs.io/en/latest/),
 [API reference](https://async-hyperliquid.readthedocs.io/en/latest/reference/index.html),
 [migration guide](https://async-hyperliquid.readthedocs.io/en/latest/migration-0.5-to-1.0.html),
 [changelog](CHANGELOG.md), and [license](LICENSE).
+
+## Benchmarks
+
+The overall signing benchmark values below are from a parity-gated `1.0.0rc1`
+local CPU reference run. They are not network latency or exchange throughput.
+See the detailed [benchmarks/README.md](benchmarks/README.md) manual for the
+full methodology, parity gate, and per-operation results.
+
+<!-- signing-benchmark:overall:start -->
+| Library | Geometric-mean throughput | Relative to SDK |
+|---|---:|---:|
+| async-hyperliquid | 24,641 ops/s | 1.460x |
+| Official SDK | 16,874 ops/s | 1.000x |
+| CCXT | 803 ops/s | 0.0476x |
+
+The geometric mean gives each of the five operations equal weight, preventing
+the faster `action_hash` workload from dominating the score.
+<!-- signing-benchmark:overall:end -->

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/README.md

@@ -1,8 +1,8 @@
 # Async Hyperliquid
 
 [![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/?badge=latest)
-[![PyPI](https://img.shields.io/pypi/v/async-hyperliquid.svg)](https://pypi.org/project/async-hyperliquid/)
+[![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.1.0)](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
@@ -53,13 +53,36 @@ async def main() -> None:
         network=Network.TESTNET,
     ) as client:
         result = await client.place_order("BTC", True, 0.001, 0, is_market=True)
-        print(result)
+        if result["status"] == "err":
+            raise RuntimeError(result["response"])
+        status = result["response"]["data"]["statuses"][0]
+        if isinstance(status, dict) and "error" in status:
+            raise RuntimeError(status["error"])
+        print(status)
 
 
 asyncio.run(main())
 ```
 
-Learn more in the [Read the Docs documentation](https://async-hyperliquid.readthedocs.io/),
+Learn more in the [Read the Docs documentation](https://async-hyperliquid.readthedocs.io/en/latest/),
 [API reference](https://async-hyperliquid.readthedocs.io/en/latest/reference/index.html),
 [migration guide](https://async-hyperliquid.readthedocs.io/en/latest/migration-0.5-to-1.0.html),
 [changelog](CHANGELOG.md), and [license](LICENSE).
+
+## Benchmarks
+
+The overall signing benchmark values below are from a parity-gated `1.0.0rc1`
+local CPU reference run. They are not network latency or exchange throughput.
+See the detailed [benchmarks/README.md](benchmarks/README.md) manual for the
+full methodology, parity gate, and per-operation results.
+
+<!-- signing-benchmark:overall:start -->
+| Library | Geometric-mean throughput | Relative to SDK |
+|---|---:|---:|
+| async-hyperliquid | 24,641 ops/s | 1.460x |
+| Official SDK | 16,874 ops/s | 1.000x |
+| CCXT | 803 ops/s | 0.0476x |
+
+The geometric mean gives each of the five operations equal weight, preventing
+the faster `action_hash` workload from dominating the score.
+<!-- signing-benchmark:overall:end -->

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/benchmarks/README.md

@@ -372,15 +372,18 @@ divided by the provider aggregate median, so higher is better.
 The overall score gives each of the five operations equal weight. It is the
 geometric mean of their aggregate throughputs:
 
+<!-- signing-benchmark:overall:start -->
 | Library | Geometric-mean throughput | Relative to SDK |
 |---|---:|---:|
 | async-hyperliquid | 24,641 ops/s | 1.460x |
 | Official SDK | 16,874 ops/s | 1.000x |
 | CCXT | 803 ops/s | 0.0476x |
 
-The geometric mean prevents the much faster `action_hash` workload from
-dominating the result merely because it has a larger absolute ops/s value. The
-same five workloads, versions, and weighting must be used for comparisons.
+The geometric mean gives each of the five operations equal weight, preventing
+the faster `action_hash` workload from dominating the score.
+<!-- signing-benchmark:overall:end -->
+
+The same five workloads, versions, and weighting must be used for comparisons.
 
 ## Correctness verification
 

async_hyperliquid-1.1.0/docs/_static/language-switcher.css

@@ -0,0 +1,14 @@
+.sidebar-language-switch {
+  align-items: center;
+  display: flex;
+  font-size: 0.875rem;
+  gap: 0.5rem;
+  justify-content: center;
+  margin: -0.5rem 0 0.75rem;
+}
+
+.sidebar-language-switch a[aria-current="page"] {
+  color: var(--color-foreground-primary);
+  font-weight: 600;
+  text-decoration: none;
+}

async_hyperliquid-1.1.0/docs/_templates/sidebar/language-switcher.html

@@ -0,0 +1,15 @@
+<nav class="sidebar-language-switch" aria-label="Documentation language">
+  {% if documentation_is_hosted %}
+  <a href="https://async-hyperliquid.readthedocs.io/en/{{ documentation_version|e }}/{{ pagename|e }}.html"
+     lang="en"{% if documentation_language == "en" %} aria-current="page"{% endif %}>English</a>
+  <span aria-hidden="true">|</span>
+  <a href="https://async-hyperliquid.readthedocs.io/zh-cn/{{ documentation_version|e }}/{{ pagename|e }}.html"
+     lang="zh-CN"{% if documentation_language == "zh-cn" %} aria-current="page"{% endif %}>简体中文</a>
+  {% else %}
+  <a href="{{ documentation_root_prefix|e }}en/{{ pagename|e }}.html"
+     lang="en"{% if documentation_language == "en" %} aria-current="page"{% endif %}>English</a>
+  <span aria-hidden="true">|</span>
+  <a href="{{ documentation_root_prefix|e }}zh_CN/{{ pagename|e }}.html"
+     lang="zh-CN"{% if documentation_language == "zh-cn" %} aria-current="page"{% endif %}>简体中文</a>
+  {% endif %}
+</nav>

async_hyperliquid-1.1.0/docs/conf.py

@@ -0,0 +1,94 @@
+import os
+import re
+from importlib.metadata import metadata, version as package_version
+
+
+project = "async-hyperliquid"
+release = package_version(project)
+version = release
+
+requires_python = metadata(project)["Requires-Python"]
+minimum_python = requires_python.removeprefix(">=")
+if minimum_python == requires_python:
+    raise RuntimeError(
+        "documentation expects a minimum-only Requires-Python package constraint"
+    )
+
+rst_prolog = "\n".join(
+    (
+        f".. |minimum-python| replace:: {minimum_python}",
+        f".. |requires-python| replace:: ``{requires_python}``",
+    )
+)
+
+extensions = [
+    "myst_parser",
+    "sphinx.ext.autodoc",
+    "sphinx_copybutton",
+    "sphinx_inline_tabs",
+]
+
+locale_dirs = ["locale/"]
+gettext_compact = False
+gettext_uuid = True
+
+exclude_patterns = ["_build"]
+html_theme = "furo"
+html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
+
+_HOSTED_TO_SPHINX_LANGUAGE = {"en": "en", "zh-cn": "zh_CN"}
+_SPHINX_TO_HOSTED_LANGUAGE = {
+    value: key for key, value in _HOSTED_TO_SPHINX_LANGUAGE.items()
+}
+_READTHEDOCS_VERSION = os.environ.get("READTHEDOCS_VERSION", "latest")
+_IS_READTHEDOCS = os.environ.get("READTHEDOCS") == "True"
+if not re.fullmatch(r"[a-z0-9._-]+", _READTHEDOCS_VERSION, flags=re.ASCII):
+    raise RuntimeError(
+        "READTHEDOCS_VERSION must be a non-empty Read the Docs version slug"
+    )
+
+rtd_language = os.environ.get("READTHEDOCS_LANGUAGE")
+if rtd_language is not None:
+    try:
+        language = _HOSTED_TO_SPHINX_LANGUAGE[rtd_language]
+    except KeyError as exc:
+        raise RuntimeError(
+            f"unsupported Read the Docs language: {rtd_language}"
+        ) from exc
+
+html_title = project
+templates_path = ["_templates"]
+html_static_path = ["_static"]
+html_css_files = ["language-switcher.css"]
+html_sidebars = {
+    "**": [
+        "sidebar/brand.html",
+        "sidebar/language-switcher.html",
+        "sidebar/search.html",
+        "sidebar/scroll-start.html",
+        "sidebar/navigation.html",
+        "sidebar/ethical-ads.html",
+        "sidebar/scroll-end.html",
+        "sidebar/variant-selector.html",
+    ]
+}
+
+
+def _add_documentation_context(app, pagename, templatename, context, doctree):
+    del templatename, doctree
+    rendered_language = app.config.language or "en"
+    try:
+        context["documentation_language"] = _SPHINX_TO_HOSTED_LANGUAGE[
+            rendered_language
+        ]
+    except KeyError as exc:
+        raise RuntimeError(
+            f"unsupported Sphinx documentation language: {rendered_language}"
+        ) from exc
+    context["documentation_version"] = _READTHEDOCS_VERSION
+    context["documentation_is_hosted"] = _IS_READTHEDOCS
+    context["documentation_root_prefix"] = "../" * (pagename.count("/") + 1)
+
+
+def setup(app):
+    app.connect("html-page-context", _add_documentation_context)

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/docs/howto/index.rst

@@ -1,7 +1,8 @@
 How-to guides
 =============
 
-These guides group public operations by workflow:
+Choose the guide for the outcome you need, then follow its safety and response
+steps before copying an example:
 
 * :doc:`info-queries` covers credential-free market and account reads.
 * :doc:`markets` explains canonical coin names and metadata-derived IDs.
@@ -9,8 +10,8 @@ These guides group public operations by workflow:
   cancellation, and closing.
 * :doc:`routing` explains main accounts, API wallets, subaccounts, vaults, and
   endpoint trust boundaries.
-* :doc:`transfers-administration` identifies fund-moving, paid, administrative,
-  outcome, and validator actions without presenting ready-to-run destructive
-  snippets.
+* :doc:`transfers-administration` covers fund-moving operations with explicit
+  signed-action examples, plus paid, administrative, outcome, and validator
+  actions.
 * :doc:`lifecycle-reconciliation` covers sessions, errors, nonce ownership, and
   ambiguous signed outcomes.

{async_hyperliquid-1.0.0 → async_hyperliquid-1.1.0}/docs/howto/info-queries.rst

@@ -43,6 +43,7 @@ address identifies a signing role and normally has no portfolio of its own.
        state = await info.account_state(account_address, dexs=("", "xyz"))
        orders = await info.open_orders(account_address, frontend=True)
        fills = await info.user_fills(account_address, aggregate_by_time=True)
+       agents = await info.extra_agents(account_address)
        status = await info.order_status(account_address, order_id)
 
 ``account_state()`` combines spot state, base perpetual state, and the requested
@@ -62,6 +63,21 @@ Timestamps are integer milliseconds. ``user_fills()`` requires ``start_time``
 when ``end_time`` is supplied. Funding and non-funding ledger methods require a
 start time and accept an optional end time.
 
+Pass ``reversed=True`` with ``start_time`` to request the newest page of fills
+within a time range. The client sends ``reversed`` to ``userFillsByTime`` and
+preserves the upstream response order. Omitting it keeps the existing request
+behavior:
+
+.. code-block:: python
+
+   async with InfoClient() as info:
+       fills = await info.user_fills(
+           account_address,
+           start_time=0,
+           end_time=end_time_ms,
+           reversed=True,
+       )
+
 Response handling
 -----------------