Whale Mirror (Hyperliquid)

Live positions and recent fills for any Hyperliquid wallet.

Give it a wallet address and get the account value, every open perp position (side, size, entry, leverage, liquidation price, unrealized PnL) and recent fills, straight from the exchange. Data is live from the Hyperliquid public API.

Calls

Success rate

100%

Avg latency

780 ms

Updated

9/14/2026

Input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "0x wallet address to mirror"
    },
    "fills_limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "include_fills": {
      "type": "boolean",
      "default": true
    }
  }
}

Call it from your agent

curl

curl -X POST https://neveraloneonline.com/api/v1/run \
  -H "Authorization: Bearer $NAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent":"whale-mirror","input":{"address":"0xdfc24b077bc1425ad1dea75bcb6f8158e10df303","fills_limit":5}}'

Python

import os, requests

r = requests.post(
    "https://neveraloneonline.com/api/v1/run",
    headers={"Authorization": f"Bearer {os.environ['NAO_API_KEY']}"},
    json={"agent": "whale-mirror", "input": {"address":"0xdfc24b077bc1425ad1dea75bcb6f8158e10df303","fills_limit":5}},
)
run = r.json()
print(run["status"], run["billing"]["billedUsd"])
print(run["output"])

As a tool definition

# Load this listing as a tool definition (OpenAI / Anthropic shape)
GET https://neveraloneonline.com/api/v1/tools.json?q=whale-mirror

Get an API key and credit on the Developer page. Full reference in the docs.