81trust / 100

Hyperliquid Trader Profile Invoke

by SolEnrich in Company & people data

x402 APIPassing, checked 48 min ago

Live perp positions for a Hyperliquid EVM (0x) address, read from Hyperliquid's public on-chain state. Per-position coin, side, leverage, notional, entry, unrealized PnL, distance-to-liquidation, and risk flags (high/extreme leverage, approaching liquidation, losing). Plus account value, directional bias, profile, weighted leverage, and realized+unrealized PnL over week/month/all-time. The building block for smart-money tracking.

POST https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
179 ms typical, 179 ms slowest 5%
Last check
48 min ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke" \
  -H "content-type: application/json" \
  -d '{"address":"0xd21d931890d27b6e7e2e668f27931e17698e90f1","format":"json"}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.solenrich.com%2Fentrypoints%2Fhyperliquid-trader-profile%2Finvoke
const res = await pay("https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"address":"0xd21d931890d27b6e7e2e668f27931e17698e90f1","format":"json"}),
});
console.log(await res.json());

Example input

{
  "address": "0xd21d931890d27b6e7e2e668f27931e17698e90f1",
  "format": "json"
}

Example output

{
  "output": {
    "account": {
      "margin_used_usd": 8422400,
      "total_notional_usd": 25851000,
      "value_usd": 8864900,
      "withdrawable_usd": 4381.6
    },
    "address": "0xd21d931890d27b6e7e2e668f27931e17698e90f1",
    "directional_bias": "long",
    "fetched_at": 1790035807796,
    "flags": {
      "any_high_leverage": false,
      "any_near_liquidation": false,
      "concentrated_coin": null
    },
    "has_positions": true,
    "pnl": {
      "all_time_usd": 11216000,
      "month_usd": 4660400,
      "week_usd": 4791600
    },
    "positions": [
      {
        "coin": "SOL",
        "current_px": 118.68,
        "dir": "long",
        "distance_to_liq_pct": 23.657,
        "entry_px": 110.34,
        "flags": {
          "approaching_liquidation": false,
          "extreme_leverage": false,
          "high_leverage": false,
          "losing": false
        },
        "leverage": 5,
        "liquidation_px": 90.604,
        "margin_used_usd": 2579000,
        "notional_usd": 10088000,
        "pnl_pct": 37.78,
        "size_tokens": 85001,
        "unrealized_pnl_usd": 708700
      }
    ],
    "profile": "directional_long",
    "totals": {
      "gross_notional_usd": 25851000,
      "net_notional_usd": 25851000,
      "position_count": 6,
      "total_unrealized_pnl_usd": 3430100,
      "weighted_leverage": 4.6874
    },
    "venue": "hyperliquid"
  },
  "run_id": "uuid",
  "status": "succeeded"
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
48 min agoPassed402179 ms$0.012
6 h agoPassed402179 ms$0.012