{"openapi":"3.1.0","info":{"title":"paidapis.net — hlrisk","version":"1.0.0","description":"Pay-per-call x402 API for real-time Hyperliquid BTC/ETH liquidation risk: notional at risk if price moves ±1%/3%/5%, the position closest to liquidation, and the funding rate, computed from real on-chain position data. USDC on Base, no API keys, no subscriptions.","contact":{"url":"https://paidapis.net","email":"chachiaidev@gmail.com"},"x-guidance":"Pay via x402 (exact scheme, USDC on Base mainnet, eip155:8453) to access any route below. /api/hl-liquidation-risk is the flagship endpoint: real-time Hyperliquid BTC/ETH liquidation proximity data. /api/hl-liquidations reports rare backstop-liquidation events only, not all liquidations. /api/transfer takes a required `amount` query parameter (USDC, max 5)."},"paths":{"/api/premium-data":{"get":{"summary":"Example premium data endpoint","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Data"},"402":{"description":"Payment required"}}}},"/api/transfer":{"get":{"summary":"Direct transfer of a caller-specified USDC amount to the receiving wallet","parameters":[{"name":"amount","in":"query","required":true,"schema":{"type":"string"},"description":"USDC amount to transfer, e.g. \"0.01\" (max 5 per policy)"}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"dynamic","currency":"USD","min":"0.001","max":"5.00"}},"responses":{"200":{"description":"Transfer confirmation"},"402":{"description":"Payment required"}}}},"/api/gas-price":{"get":{"summary":"Current Ethereum mainnet gas price, in Gwei","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Gas price data"},"402":{"description":"Payment required"}}}},"/api/relay/block-number":{"get":{"summary":"Relays the current Ethereum block number, bought from an upstream x402 provider and resold with a small markup","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.003"}},"responses":{"200":{"description":"Block number + margin data"},"402":{"description":"Payment required"}}}},"/api/subscribe":{"get":{"summary":"Unlocks /api/subscriber-content for 5 minutes from time of payment","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002"}},"responses":{"200":{"description":"Subscription confirmation"},"402":{"description":"Payment required"}}}},"/api/hl-liquidations":{"get":{"summary":"Hyperliquid BTC/ETH perpetual futures backstop liquidations in the last hour: total USD, count, biggest single event","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Liquidation summary"},"402":{"description":"Payment required"}}}},"/api/hl-liquidation-risk":{"get":{"summary":"Hyperliquid BTC/ETH perpetual futures liquidation risk index: notional at risk if leveraged price moves ±1%/3%/5%, closest-to-liquidation position, funding rate","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Liquidation risk index"},"402":{"description":"Payment required"}}}}}}