hookmind (Python)

Python SDK for the HookMind Protocol — AI-powered dynamic fees and impermanent loss insurance for Uniswap v4 on Unichain.

Install

pip install hookmind

Requires Python ≥ 3.10.

Quick start

import asyncio
from hookmind import Agent

async def main():
    async with Agent(api_key="hm_your_key") as agent:
        # Health check
        pong = await agent.ping()
        print(pong.version, pong.chain_id)

        # Live pool state
        pools = await agent.get_pools()
        fee   = await agent.get_fee(pools[0].pool_id)
        print(f"Current fee: {fee.current_fee} bps → recommended: {fee.recommended_fee} bps")

        # IL Insurance vault
        stats = await agent.get_vault_stats()
        quote = await agent.get_quote("0xYourLPAddress")
        print(f"Premium: {quote.premium} USDC  Max payout: {quote.max_payout} USDC")

asyncio.run(main())

Class reference

Agent

from hookmind import Agent

agent = Agent(
    api_key="hm_your_key",
    api_url="https://hookmind-api.fly.dev",  # optional
    timeout=30.0,                             # optional, seconds
)
# Use as async context manager (recommended) or call await agent.close() manually

Signals

signals = await agent.get_signals(limit=20)
signal  = await agent.submit_signal(
    signal={
        "poolId": "0xb60e6d...",
        "fee": 500,
        "volatilityScore": 4500,
        "nonce": 1,
        "chainId": 1301,
    },
    private_key_hex="0x_your_key",
)

Pools & fees

pools = await agent.get_pools()
pool  = await agent.get_pool("0xb60e6d...")
fee   = await agent.get_fee("0xb60e6d...")
sim   = await agent.simulate_fee(SimulateParams(base_fee=300, sigma2=5000, sigma2_max=10000))

IL Insurance vault

stats = await agent.get_vault_stats()
quote = await agent.get_quote("0xLP...", tick_lower=-887272, tick_upper=887272)

Operators

operators = await agent.get_operators()
operator  = await agent.get_operator("0xAddress")
await agent.register_operator("0x_ecdsa_public_key")

Real-time WebSocket stream

async for event in agent.listen():
    print(event["type"], event["data"])

Types

from hookmind import (
    Signal, PoolData, FeeRecommendation,
    SimulateParams, SimulationResult,
    VaultStats, ILQuote,
    Operator, ApiKey, PingResult,
    HookMindError,
)

Error handling

from hookmind import HookMindError

try:
    pool = await agent.get_pool("0xbad...")
except HookMindError as e:
    print(e.code, e.status, str(e))

Links

• Protocol docs
• TypeScript SDK
• GitHub

License

MIT © 2026 HookMind Protocol Contributors