{
  "x402Version": 2,
  "id": 30143,
  "slug": "30143",
  "resource": "https://alphapipeline-eu.onrender.com/v1/derivatives/whale-position-audit",
  "description": "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.",
  "type": "http",
  "resourceType": "Utilities",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x2bcfA4F7E1fA5E96934846A7dEa623398Ed7f752",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000",
      "amountUsd": 0.02,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "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"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "address": "0x31ca8395cf837de08b24da3f660e77761dfb974"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "account_value_usd": 13104.51,
            "data_source": "Hyperliquid clearinghouseState (official public API)",
            "generated_at": {
              "kst": "2026-09-07 21:00:00 KST",
              "utc": "2026-09-07T12:00:00Z"
            },
            "margin_usage_pct": 0.04,
            "notice": "This tool audits a wallet address you already know - it does not discover or rank 'smart money' wallets, because Hyperliquid's public API has no leaderboard or large-trader disclosure endpoint. mark_price is derived from position_value_usd / size (Hyperliquid does not return a separate live quote in this response), so it can lag the true mark price briefly during fast moves. risk_flags are computed from fixed numeric thresholds only (leverage >= 20x -> HIGH_LEVERAGE, distance_to_liquidation_pct < 15 -> NEAR_LIQUIDATION), not a judgment call about the trader. max_leverage and return_on_equity_pct are Hyperliquid's own reported fields (not derived by this tool).",
            "open_position_count": 1,
            "positions": [
              {
                "coin": "ETH",
                "distance_to_liquidation_pct": 4.02,
                "entry_price": 2986.3,
                "leverage": 20,
                "leverage_type": "isolated",
                "liquidation_price": 2866.27,
                "mark_price": 2986.5,
                "max_leverage": 50,
                "position_value_usd": 100.03,
                "return_on_equity_pct": -2.68,
                "side": "LONG",
                "size": 0.0335,
                "unrealized_pnl_usd": -0.0134
              }
            ],
            "risk_flags": [],
            "total_margin_used_usd": 4.97,
            "total_notional_position_usd": 100.03,
            "wallet_address": "0x31ca8395cf837de08b24da3f660e77761dfb974",
            "withdrawable_usd": 13099.55
          },
          "type": "json"
        }
      },
      "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"
      }
    }
  },
  "tags": [
    "crypto",
    "derivatives",
    "hyperliquid",
    "risk",
    "bazaar"
  ],
  "sourceHost": "alphapipeline-eu.onrender.com",
  "lastUpdated": "2026-10-08T06:14:11.011Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T06:14:10.806Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "address": "0x31ca8395cf837de08b24da3f660e77761dfb974"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "account_value_usd": 13104.51,
              "data_source": "Hyperliquid clearinghouseState (official public API)",
              "generated_at": {
                "kst": "2026-09-07 21:00:00 KST",
                "utc": "2026-09-07T12:00:00Z"
              },
              "margin_usage_pct": 0.04,
              "notice": "This tool audits a wallet address you already know - it does not discover or rank 'smart money' wallets, because Hyperliquid's public API has no leaderboard or large-trader disclosure endpoint. mark_price is derived from position_value_usd / size (Hyperliquid does not return a separate live quote in this response), so it can lag the true mark price briefly during fast moves. risk_flags are computed from fixed numeric thresholds only (leverage >= 20x -> HIGH_LEVERAGE, distance_to_liquidation_pct < 15 -> NEAR_LIQUIDATION), not a judgment call about the trader. max_leverage and return_on_equity_pct are Hyperliquid's own reported fields (not derived by this tool).",
              "open_position_count": 1,
              "positions": [
                {
                  "coin": "ETH",
                  "distance_to_liquidation_pct": 4.02,
                  "entry_price": 2986.3,
                  "leverage": 20,
                  "leverage_type": "isolated",
                  "liquidation_price": 2866.27,
                  "mark_price": 2986.5,
                  "max_leverage": 50,
                  "position_value_usd": 100.03,
                  "return_on_equity_pct": -2.68,
                  "side": "LONG",
                  "size": 0.0335,
                  "unrealized_pnl_usd": -0.0134
                }
              ],
              "risk_flags": [],
              "total_margin_used_usd": 4.97,
              "total_notional_position_usd": 100.03,
              "wallet_address": "0x31ca8395cf837de08b24da3f660e77761dfb974",
              "withdrawable_usd": 13099.55
            },
            "type": "json"
          }
        },
        "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"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "alphapipeline-eu.onrender.com",
    "manifest_name": "alphapipeline-eu.onrender.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {
      "account_value_usd": null,
      "data_source": "string",
      "generated_at": {
        "kst": "string",
        "utc": "string"
      },
      "margin_usage_pct": null,
      "notice": null,
      "open_position_count": 0,
      "positions": [],
      "risk_flags": [],
      "total_margin_used_usd": null,
      "total_notional_position_usd": null,
      "wallet_address": "string",
      "withdrawable_usd": null
    },
    "type": "string"
  }
}