Api Endpoint

AlphaPipeline Whale Position Audit

Audit a Hyperliquid wallet address you already know: every open perpetual position with side, size, leverage, unrealized PnL, liquidation price, and distance-to-liquidation percentage. Does not discover or rank wallets - Hyperliquid's public API has no leaderboard endpoint, so this only audits an address you supply. Paid in USDC on Base.

Open interactive test console

Offering

Provider
alphapipeline-eu.onrender.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Blockchain And Crypto
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://alphapipeline-eu.onrender.com/v1/derivatives/whale-position-audit
MIME type
application/json
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
Crypto, Derivatives, hyperliquid, Risk

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x2bcfA4F7E1fA5E96934846A7dEa623398Ed7f752"
  }
]

Observed health

Status
Healthy
Latest latency
319 ms
Average latency
397 ms
HTTP status
402
Last checked
Reachability
100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "Hyperliquid/EVM wallet address to audit (0x...)."
        }
      },
      "required": [
        "address"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "address": {
              "description": "Hyperliquid/EVM wallet address to audit (0x...).",
              "type": "string"
            }
          },
          "required": [
            "address"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "account_value_usd": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Account Value Usd"
            },
            "data_source": {
              "title": "Data Source",
              "type": "string"
            },
            "generated_at": {
              "properties": {
                "kst": {
                  "title": "Kst",
                  "type": "string"
                },
                "utc": {
                  "title": "Utc",
                  "type": "string"
                }
              },
              "required": [
                "utc",
                "kst"
              ],
              "title": "TimestampPair",
              "type": "object"
            },
            "margin_usage_pct": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Margin Usage Pct"
            },
            "notice": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Notice"
            },
            "open_position_count": {
              "title": "Open Position Count",
              "type": "integer"
            },
            "positions": {
              "default": [],
              "items": {
                "properties": {
                  "coin": {
                    "title": "Coin",
                    "type": "string"
                  },
                  "distance_to_liquidation_pct": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "abs(mark_price - liquidation_price) / mark_price * 100. Null when Hyperliquid reports no liquidation price for this position.",
                    "title": "Distance To Liquidation Pct"
                  },
                  "entry_price": {
                    "title": "Entry Price",
                    "type": "number"
                  },
                  "leverage": {
                    "title": "Leverage",
                    "type": "number"
                  },
                  "leverage_type": {
                    "description": "cross or isolated, as reported by Hyperliquid.",
                    "title": "Leverage Type",
                    "type": "string"
                  },
                  "liquidation_price": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Liquidation Price"
                  },
                  "mark_price": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Derived as position_value_usd / size, since clearinghouseState does not return a live mark price directly. Not a separately-fetched live quote.",
                    "title": "Mark Price"
                  },
                  "max_leverage": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Hyperliquid's own reported leverage ceiling for this asset/account setting - not the leverage actually in use (see 'leverage' for that).",
                    "title": "Max Leverage"
                  },
                  "position_value_usd": {
                    "title": "Position Value Usd",
                    "type": "number"
                  },
                  "return_on_equity_pct": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Hyperliquid's own reported return-on-equity for this position, as a percentage. This is Hyperliquid's own ROE definition, which can differ from a naive unrealized_pnl_usd / margin_used calculation.",
                    "title": "Return On Equity Pct"
                  },
                  "side": {
                    "description": "LONG or SHORT, derived from the sign of Hyperliquid's szi (signed size).",
                    "title": "Side",
                    "type": "string"
                  },
                  "size": {
                    "title": "Size",
                    "type": "number"
                  },
                  "unrealized_pnl_usd": {
                    "title": "Unrealized Pnl Usd",
                    "type": "number"
                  }
                },
                "required": [
                  "coin",
                  "side",
                  "size",
                  "entry_price",
                  "position_value_usd",
                  "leverage",
                  "leverage_type",
                  "unrealized_pnl_usd"
                ],
                "title": "WhalePosition",
                "type": "object"
              },
              "title": "Positions",
              "type": "array"
            },
            "risk_flags": {
              "default": [],
              "items": {
                "type": "string"
              },
              "title": "Risk Flags",
              "type": "array"
            },
            "total_margin_used_usd": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total Margin Used Usd"
            },
            "total_notional_position_usd": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total Notional Position Usd"
            },
            "wallet_address": {
              "title": "Wallet Address",
              "type": "string"
            },
            "withdrawable_usd": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Withdrawable Usd"
            }
          },
          "required": [
            "generated_at",
            "wallet_address",
            "open_position_count",
            "data_source"
          ],
          "title": "WhalePositionAuditResponse",
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}