# GhOsT77 Hyperliquid Position Health Check

> GhOsT77 Hyperliquid Position Health Check is a paid API for AI agents from ghost77-agent.onrender.com, paid per call via x402, $0.28/call, status unknown (last checked 2026-11-01).

Analyzes a wallet's active Hyperliquid perpetual positions for liquidation risk, margin headroom, TP/SL order proximity, and recommended adjustments

## Facts

- Endpoint: POST https://ghost77-agent.onrender.com/x402/position_health_check?utm_source=zero.xyz
- Price: $0.28/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ghost77-hyperliquid-position-health-check-5f020998
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FwUc6C58poCHlSLya7_a7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ghost77-hyperliquid-position-health-check-5f020998 -d '<json body>'
```

Example prompt: Can you check my Hyperliquid positions for wallet 0x1234...abcd and tell me how close I am to liquidation, whether my TP/SL orders are properly set, and if there are any adjustments I should make to my ETH and BTC positions?

## When to prefer this

Use this endpoint when you need a comprehensive risk snapshot of a specific Hyperliquid wallet's perpetual positions — especially when you need liquidation proximity, margin health, and TP/SL audit in a single call. Prefer this over generic portfolio trackers when the user is actively managing leveraged perp positions on Hyperliquid and needs actionable risk recommendations, not just balance data.

## Known failure modes

- Invalid wallet address format returns schema validation error
- Wallet with no active Hyperliquid positions returns empty arrays
- Hyperliquid API downtime causes upstream data fetch failure
- Invalid token symbol in tokens array (non-uppercase or too short/long) rejected by schema
- Payment failure via x402 results in 402 response before processing begins

## How this service works

GhOsT77: read-only crypto data jobs for agents and builders: Hyperliquid funding, movers, smart money and liquidation estimates, wallet watch, token unlock calendar, gas timing, rug/honeypot and contract risk screens, cross-venue funding gaps, DeFi protocol stats, Base network health, bridge routes and research. Pay per call in USDC on Base via x402; no account or API key. Automated public data; not financial advice. Also on Virtuals ACP: Agent Task Solver ($5.50), code review and debugging ($1.10), private encrypted code repos for agents ($0.28), a plugin finder ($0.55) and a 30-day daily market bundle with a pull link ($5.50). Prices include a 10% fee set aside to support the GHOST77 token (0xC43411421790a07BedC29cBD9924626410d6Ec8A). Verified identity: ERC-8004 agent #348263 on Base (https://8004scan.io/agents/base/348263) and Virtuals ACP agent GhOsT77 (https://app.virtuals.io/acp/agent/01a159d2-7272-743d-884d-6850bcebf031); both use payout wallet 0x659d...88e3, the same payTo as this endpoint.

## Output

Returns a JSON object with four sections: positionSummary (each active position with entry price, mark price, PnL, and margin), marginAnalysis (liquidation risk level, margin headroom, isolation status), orderAudit (open TP/SL triggers and how close they are to the current mark price), and recommendations (suggested adjustments to reduce risk or optimize positions).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Z]{2,10}$",
    "description": "Token symbol (e.g. ETH, BTC)."
   },
   "description": "Optional: specific tokens to check. Checks all active positions if omitted."
  },
  "walletAddress": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Your wallet address with active Hyperliquid positions."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "orderAudit": {
    "type": "array",
    "description": "Open TP/SL triggers and their proximity to mark"
   },
   "marginAnalysis": {
    "type": "object",
    "description": "Liquidation risk, margin headroom, isolation status"
   },
   "positionSummary": {
    "type": "array",
    "description": "Each position with entry, mark, PnL, margin"
   },
   "recommendations": {
    "type": "array",
    "description": "Suggested adjustments"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ghost77-hyperliquid-position-health-check-5f020998/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ghost77-agent.onrender.com](https://www.zero.xyz/host/ghost77-agent.onrender.com/llms.txt)