# hlrisk

> Pay-per-call x402 APIs on Base USDC. No accounts, no API keys, no subscriptions. Flagship: real-time Hyperliquid BTC/ETH perpetual futures liquidation risk index.

Standard x402 flow: request an endpoint, receive an HTTP 402 with payment details in both the PAYMENT-REQUIRED header and the JSON response body, sign and resend with an x402-aware client.

## Endpoints

- [Liquidation Risk Index](https://hlrisk.paidapis.net/api/hl-liquidation-risk): $0.03 USDC. Hyperliquid BTC/ETH perpetual futures liquidation risk index — notional at risk if leveraged price moves ±1%/3%/5%, position closest to liquidation, funding rate. Built from real on-chain position data, not a statistical estimate.
- [Backstop Liquidations](https://hlrisk.paidapis.net/api/hl-liquidations): $0.02 USDC. Hyperliquid BTC/ETH perpetual futures backstop liquidations in the last hour: total USD, count, biggest single event.
- [Ethereum Gas Price](https://hlrisk.paidapis.net/api/gas-price): $0.005 USDC. Current Ethereum mainnet gas price, in Gwei.
- [Relayed Block Number](https://hlrisk.paidapis.net/api/relay/block-number): $0.003 USDC. Current Ethereum block number, resold from an upstream x402 provider with a small markup.
- [Subscription Unlock](https://hlrisk.paidapis.net/api/subscribe): $0.002 USDC. Unlocks subscriber content for 5 minutes from time of payment.
- [Direct USDC Transfer](https://hlrisk.paidapis.net/api/transfer): $0.001–$5.00 USDC. Direct transfer of a caller-specified USDC amount to the receiving wallet.
- [Example Endpoint](https://hlrisk.paidapis.net/api/premium-data): $0.01 USDC. Demo endpoint, not part of the core product.

## Machine-readable specs

- [OpenAPI spec](https://hlrisk.paidapis.net/openapi.json): full OpenAPI 3.1 spec with x-payment-info pricing per route.
- [.well-known/x402 manifest](https://hlrisk.paidapis.net/.well-known/x402): legacy discovery manifest listing resource URLs.