{ "components": { "schemas": { "X402Challenge": { "properties": { "accepts": { "items": { "properties": { "amount": { "type": "string" }, "asset": { "type": "string" }, "maxTimeoutSeconds": { "type": "integer" }, "network": { "type": "string" }, "payTo": { "type": "string" }, "scheme": { "type": "string" } }, "type": "object" }, "type": "array" }, "error": { "type": "string" }, "x402Version": { "example": 2, "type": "integer" } }, "type": "object" } }, "securitySchemes": { "x402": { "description": "x402 payment payload (base64 EIP-3009). Obtain pricing from the 402 challenge.", "in": "header", "name": "X-PAYMENT", "type": "apiKey" } } }, "info": { "contact": { "email": "hello@v1337.org", "name": "v1337", "url": "https://intel.v1337.org/" }, "description": "First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).", "title": "Hyperliquid-data", "version": "1.1.0" }, "openapi": "3.1.0", "paths": { "/healthz": { "get": { "description": "Health check. Free ops/discovery endpoint (no payment).", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "Health check", "tags": [ "ops" ] } }, "/openapi.json": { "get": { "description": "OpenAPI 3.1 catalog (canonical; x402scan OpenAPI-first). Free ops/discovery endpoint (no payment).", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "OpenAPI 3.1 catalog (canonical; x402scan OpenAPI-first)", "tags": [ "ops" ] } }, "/v1/analytics/anti-survivors": { "get": { "description": "Wallets that consistently stay net-negative. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "anti_survivors", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Wallets that consistently stay net-negative", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/backstop-events": { "get": { "description": "Recent backstop / HLP / ADL-tagged liquidations. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "backstop_events", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recent backstop / HLP / ADL-tagged liquidations", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/biggest-losses": { "get": { "description": "Largest realized-PnL losses. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "biggest_losses", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Largest realized-PnL losses", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/biggest-wins": { "get": { "description": "Largest realized-PnL wins. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "biggest_wins", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Largest realized-PnL wins", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/closed-positions/recent": { "get": { "description": "Most recent closed positions. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "recent_closed_positions", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Most recent closed positions", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/coin-alpha-map": { "get": { "description": "Per-coin alpha map (skill/edge ranking). First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "coin_alpha_map", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-coin alpha map (skill/edge ranking)", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/compare": { "get": { "description": "Side-by-side per-wallet aggregate comparison. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "compare", "parameters": [ { "in": "query", "name": "addresses", "required": true, "schema": { "example": "0xabc,0xdef", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Side-by-side per-wallet aggregate comparison", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/global-stats": { "get": { "description": "Aggregate ledger stats (wallets, fills, volume, PnL). First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "global_stats", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Aggregate ledger stats (wallets, fills, volume, PnL)", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/hidden-gems": { "get": { "description": "Under-the-radar profitable wallets. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "hidden_gems", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Under-the-radar profitable wallets", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/hour-profitability": { "get": { "description": "Realized PnL bucketed by hour of day. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "hour_profitability", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Realized PnL bucketed by hour of day", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/lethal-coins": { "get": { "description": "Coins with the worst aggregate trader PnL. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "lethal_coins", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Coins with the worst aggregate trader PnL", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/lifecycle": { "get": { "description": "One position lifecycle by id. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "lifecycle", "parameters": [ { "in": "query", "name": "id", "required": true, "schema": { "example": "12345", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "One position lifecycle by id", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/lifecycles/recent": { "get": { "description": "Most recent reconstructed position lifecycles. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "recent_lifecycles", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Most recent reconstructed position lifecycles", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/market-concentration": { "get": { "description": "Top-5 coin volume share (concentration). First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_concentration", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Top-5 coin volume share (concentration)", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/max-pain-events": { "get": { "description": "Concentrated liquidation cascades by time bucket. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "max_pain_events", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } }, { "in": "query", "name": "bucketMin", "required": false, "schema": { "default": 10, "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Concentrated liquidation cascades by time bucket", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/most-traded": { "get": { "description": "Most-traded coins by volume. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "most_traded", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Most-traded coins by volume", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/newcomer-whales": { "get": { "description": "Recently-arrived high-volume wallets. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "newcomer_whales", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "withinDays", "required": false, "schema": { "default": 7, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recently-arrived high-volume wallets", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/one-month-wonders": { "get": { "description": "Profitable last-30d but flat/negative all-time. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "one_month_wonders", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Profitable last-30d but flat/negative all-time", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/perfect-exits": { "get": { "description": "Closed positions ranked by return-on-notional. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "perfect_exits", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Closed positions ranked by return-on-notional", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/persistent-winners": { "get": { "description": "Survivors filtered to a higher trade threshold. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "persistent_winners", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Survivors filtered to a higher trade threshold", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/style-distribution": { "get": { "description": "Distribution of trading styles (hold time). First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "style_distribution", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Distribution of trading styles (hold time)", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/survivors": { "get": { "description": "Wallets that consistently stay net-positive. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "survivors", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Wallets that consistently stay net-positive", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/token-leaderboard": { "get": { "description": "Top traders for one coin. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "token_leaderboard", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Top traders for one coin", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/top-liquidators": { "get": { "description": "Wallets with the most liquidation fills. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "top_liquidators", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Wallets with the most liquidation fills", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/top-pnl-coins": { "get": { "description": "Coins ranked by aggregate realized trader PnL. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "top_pnl_coins", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Coins ranked by aggregate realized trader PnL", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/analytics/top-volume-wallets": { "get": { "description": "Highest-volume wallets by notional traded. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "top_volume_wallets", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Highest-volume wallets by notional traded", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/assets": { "get": { "description": "List tracked assets (mark, OI, funding, 24h vol). First-party Hyperliquid assets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Free sample (try-before-pay).", "operationId": "list_assets", "responses": { "200": { "content": { "application/json": { "example": { "assets": [ { "coin": "BTC", "dayNtlVlm": 2818554578.339452, "funding": -0.000001189, "isDelisted": false, "markPx": 59326, "maxLeverage": 40, "midPx": 59325.5, "openInterest": 36026.04382, "oraclePx": 59356, "premium": -0.0005054249, "prevDayPx": 59409, "szDecimals": 5 } ], "count": 230, "source": "first-party" }, "schema": { "properties": { "assets": { "items": { "properties": { "coin": { "type": "string" }, "dayNtlVlm": { "type": "number" }, "funding": { "type": "number" }, "isDelisted": { "type": "boolean" }, "markPx": { "type": "number" }, "maxLeverage": { "type": "number" }, "midPx": { "type": "number" }, "openInterest": { "type": "number" }, "oraclePx": { "type": "number" }, "premium": { "type": "number" }, "prevDayPx": { "type": "number" }, "szDecimals": { "type": "number" } }, "type": "object" }, "type": "array" }, "count": { "type": "number" }, "source": { "type": "string" } }, "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "List tracked assets (mark, OI, funding, 24h vol)", "tags": [ "assets" ], "x-gate": "free" } }, "/v1/assets/cross-market": { "get": { "description": "Perp + spot cross-market view for one asset. First-party Hyperliquid assets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cross_market_asset", "parameters": [ { "in": "query", "name": "canonical", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Perp + spot cross-market view for one asset", "tags": [ "assets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/assets/detail": { "get": { "description": "Live asset row (info API). First-party Hyperliquid assets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "asset", "parameters": [ { "in": "query", "name": "canonical", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Live asset row (info API)", "tags": [ "assets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/cohorts/daily": { "get": { "description": "Per-day cohort aggregates. First-party Hyperliquid cohorts data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohorts_daily", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-day cohort aggregates", "tags": [ "cohorts" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/cohorts/summary": { "get": { "description": "Cohort summary (tiered counts + aggregates). First-party Hyperliquid cohorts data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_summary", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "bySize": [ { "avgWinRatePct": 47.8, "profitableSharePct": 37.88, "tier": "nano", "totalRealizedPnl": -2328024.25, "totalVolume": 1101450089.7, "wallets": 108985 } ], "coverage": { "coverageDays": 7, "coverageHours": 167, "maxQueryableDays": 7, "maxQueryableWindow": "7d", "newestMs": 1782883110966, "oldestMs": 1782282469519 }, "fillsScanned": 48146117, "source": "node_fills ledger", "walletsTracked": 125362, "window": "all" }, "schema": { "properties": { "available": { "type": "boolean" }, "bySize": { "items": { "properties": { "avgWinRatePct": { "type": "number" }, "profitableSharePct": { "type": "number" }, "tier": { "type": "string" }, "totalRealizedPnl": { "type": "number" }, "totalVolume": { "type": "number" }, "wallets": { "type": "number" } }, "type": "object" }, "type": "array" }, "coverage": { "properties": { "coverageDays": { "type": "number" }, "coverageHours": { "type": "number" }, "maxQueryableDays": { "type": "number" }, "maxQueryableWindow": { "type": "string" }, "newestMs": { "type": "number" }, "oldestMs": { "type": "number" } }, "type": "object" }, "fillsScanned": { "type": "number" }, "source": { "type": "string" }, "walletsTracked": { "type": "number" }, "window": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Cohort summary (tiered counts + aggregates)", "tags": [ "cohorts" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/cohorts/tier": { "get": { "description": "Wallets in one cohort tier. First-party Hyperliquid cohorts data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_tier", "parameters": [ { "in": "query", "name": "tierType", "required": true, "schema": { "example": "size", "type": "string" } }, { "in": "query", "name": "tier", "required": true, "schema": { "example": "mega", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "by", "required": false, "schema": { "default": "realizedPnl", "example": "volume", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Wallets in one cohort tier", "tags": [ "cohorts" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/cohorts/tier/positions": { "get": { "description": "Open positions held by one cohort tier. First-party Hyperliquid cohorts data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_tier_positions", "parameters": [ { "in": "query", "name": "tierType", "required": true, "schema": { "example": "size", "type": "string" } }, { "in": "query", "name": "tier", "required": true, "schema": { "example": "mega", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 200, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Open positions held by one cohort tier", "tags": [ "cohorts" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/cohorts/tier/trades": { "get": { "description": "Recent trades by one cohort tier. First-party Hyperliquid cohorts data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_tier_trades", "parameters": [ { "in": "query", "name": "tierType", "required": true, "schema": { "example": "size", "type": "string" } }, { "in": "query", "name": "tier", "required": true, "schema": { "example": "mega", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recent trades by one cohort tier", "tags": [ "cohorts" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/copy-trade": { "get": { "description": "Copy-trade signals from top traders’ live positions. First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "copy_trade", "parameters": [ { "in": "query", "name": "wallets", "required": false, "schema": { "example": "0xabc,0xdef", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 10, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Copy-trade signals from top traders’ live positions", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/leaderboard": { "get": { "description": "Rank every tracked wallet by realized PnL, volume, trades, or win rate (time-windowed). First-party Hyperliquid analytics data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "leaderboard_live", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "by", "required": false, "schema": { "default": "realizedPnl", "example": "volume", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "fillsScanned": 48144697, "ranked": [ { "address": "0x7fdafde5cfb5465924316eced2d3715494c517d1", "closedPositions": 70897, "coinsTraded": 15, "fees": -2034.724, "firstSeen": 1782282601182, "lastSeen": 1782883005777, "liquidations": 504, "pnlTier": "elite", "rank": 1, "realizedPnl": 4139448.9, "sizeTier": "large", "trades": 132530, "volume": 203921216.56, "winRatePct": 71.86 } ], "source": "node_fills ledger", "walletsTracked": 125361, "window": "all" }, "schema": { "properties": { "available": { "type": "boolean" }, "fillsScanned": { "type": "number" }, "ranked": { "items": { "properties": { "address": { "type": "string" }, "closedPositions": { "type": "number" }, "coinsTraded": { "type": "number" }, "fees": { "type": "number" }, "firstSeen": { "type": "number" }, "lastSeen": { "type": "number" }, "liquidations": { "type": "number" }, "pnlTier": { "type": "string" }, "rank": { "type": "number" }, "realizedPnl": { "type": "number" }, "sizeTier": { "type": "string" }, "trades": { "type": "number" }, "volume": { "type": "number" }, "winRatePct": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "type": "string" }, "walletsTracked": { "type": "number" }, "window": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Rank every tracked wallet by realized PnL, volume, trades, or win rate (time-windowed)", "tags": [ "analytics" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/cohort-bias": { "get": { "description": "Per-tier long/short bias for one coin. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_bias", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-tier long/short bias for one coin", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/cohort-bias/history": { "get": { "description": "Forward-sampled cohort-bias history for one coin. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "cohort_bias_history", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Forward-sampled cohort-bias history for one coin", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/coins/long-short": { "get": { "description": "Long/short split for one coin. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "coin_long_short", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Long/short split for one coin", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/liquidation-heatmap": { "get": { "description": "Approximate liquidation-price heatmap for one coin. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "liquidation_heatmap", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "maxWallets", "required": false, "schema": { "default": 30, "type": "integer" } }, { "in": "query", "name": "bands", "required": false, "schema": { "default": 20, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "bands": [ { "exposureNotional": 53394098.86, "priceBand": "64848.18-66381.91", "wallets": 1 } ], "coin": "BTC", "markPx": 59326, "note": "approximate — sampled top holders' live liquidation prices bucketed into price bands; not exhaustive", "sampledWallets": 2, "source": "info API clearinghouseState + node_fills ledger" }, "schema": { "properties": { "available": { "type": "boolean" }, "bands": { "items": { "properties": { "exposureNotional": { "type": "number" }, "priceBand": { "type": "string" }, "wallets": { "type": "number" } }, "type": "object" }, "type": "array" }, "coin": { "type": "string" }, "markPx": { "type": "number" }, "note": { "type": "string" }, "sampledWallets": { "type": "number" }, "source": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Approximate liquidation-price heatmap for one coin", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/long-short": { "get": { "description": "Aggregate long/short notional split (optional coin). First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "long_short", "parameters": [ { "in": "query", "name": "coin", "required": false, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "coin": "BTC", "longNotional": 641592276.4, "longPct": 44.79, "longShortRatio": 0.8113, "shortNotional": 790824619.5, "source": "node_fills ledger", "window": "all" }, "schema": { "properties": { "available": { "type": "boolean" }, "coin": { "type": "string" }, "longNotional": { "type": "number" }, "longPct": { "type": "number" }, "longShortRatio": { "type": "number" }, "shortNotional": { "type": "number" }, "source": { "type": "string" }, "window": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Aggregate long/short notional split (optional coin)", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/long-short/history": { "get": { "description": "Forward-sampled long/short history (optional coin). First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "long_short_history", "parameters": [ { "in": "query", "name": "coin", "required": false, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Forward-sampled long/short history (optional coin)", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/mark-dislocations": { "get": { "description": "Mark/oracle dislocations across all coins (optional coin). First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "mark_dislocations", "parameters": [ { "in": "query", "name": "coin", "required": false, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Mark/oracle dislocations across all coins (optional coin)", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/oi-history": { "get": { "description": "Forward-sampled open-interest history (optional coin via ?coin=). First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "oi_history", "parameters": [ { "in": "query", "name": "coin", "required": false, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Forward-sampled open-interest history (optional coin via ?coin=)", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/coins": { "get": { "description": "Per-coin risk snapshot. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "coin_risk", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "24h", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-coin risk snapshot", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/coins/history": { "get": { "description": "Forward-sampled per-coin risk history + funding tail. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "coin_risk_history", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Forward-sampled per-coin risk history + funding tail", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/coins/mark-dislocations": { "get": { "description": "Mark/oracle dislocation for one coin. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "mark_dislocations", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Mark/oracle dislocation for one coin", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/liquidations/recent": { "get": { "description": "Recent liquidation fills. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "recent_liquidations", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recent liquidation fills", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/liquidations/summary": { "get": { "description": "Liquidation summary (fills + wallets liquidated). First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "liquidation_summary", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Liquidation summary (fills + wallets liquidated)", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/live/risk/overview": { "get": { "description": "Aggregate market-risk overview. First-party Hyperliquid live data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "risk_overview", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "24h", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "funding": { "highest": [ { "coin": "AR", "funding": 0.00009166 } ], "lowest": [ { "coin": "CELO", "funding": -0.00031974 } ] }, "globalLongShort": { "longNotional": 1687901418.2, "longPct": 41.93, "longShortRatio": 0.7221, "shortNotional": 2337559450.06 }, "markets": 175, "source": "first-party", "totalOiNotional": 6396027637.52 }, "schema": { "properties": { "funding": { "properties": { "highest": { "items": { "properties": { "coin": { "type": "string" }, "funding": { "type": "number" } }, "type": "object" }, "type": "array" }, "lowest": { "items": { "properties": { "coin": { "type": "string" }, "funding": { "type": "number" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "globalLongShort": { "properties": { "longNotional": { "type": "number" }, "longPct": { "type": "number" }, "longShortRatio": { "type": "number" }, "shortNotional": { "type": "number" } }, "type": "object" }, "markets": { "type": "number" }, "source": { "type": "string" }, "totalOiNotional": { "type": "number" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Aggregate market-risk overview", "tags": [ "live" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/candles": { "get": { "description": "OHLCV candles. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_candles", "parameters": [ { "in": "query", "name": "symbol", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "interval", "required": false, "schema": { "default": "1h", "type": "string" } }, { "in": "query", "name": "lookbackMs", "required": false, "schema": { "default": 86400000, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "example": { "candles": [ { "c": 59303, "h": 59433, "l": 59039, "n": 18727, "o": 59172, "t": 1782878400000, "v": 2048.23976 } ], "coin": "BTC", "interval": "1h", "source": "first-party" }, "schema": { "properties": { "candles": { "items": { "properties": { "c": { "type": "number" }, "h": { "type": "number" }, "l": { "type": "number" }, "n": { "type": "number" }, "o": { "type": "number" }, "t": { "type": "number" }, "v": { "type": "number" } }, "type": "object" }, "type": "array" }, "coin": { "type": "string" }, "interval": { "type": "string" }, "source": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "OHLCV candles", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/historical-oi": { "get": { "description": "Forward-sampled open-interest history for one coin. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_historical_oi", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Forward-sampled open-interest history for one coin", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/official-oi": { "get": { "description": "Official open interest (notional) for one coin. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "official_oi", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "coin": "BTC", "markPx": 59326, "oiNotional": 2137275957.02, "openInterest": 36025.95754, "source": "first-party" }, "schema": { "properties": { "coin": { "type": "string" }, "markPx": { "type": "number" }, "oiNotional": { "type": "number" }, "openInterest": { "type": "number" }, "source": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Official open interest (notional) for one coin", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/onchain": { "get": { "description": "On-chain markPx/oraclePx from HyperCore precompiles (chain-999 public-RPC basket), cross-checked vs the info API. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "chain_oracle", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "On-chain markPx/oraclePx from HyperCore precompiles (chain-999 public-RPC basket), cross-checked vs the info API", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/orderbook": { "get": { "description": "L2 order book. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_orderbook", "parameters": [ { "in": "query", "name": "symbol", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "asks": [ { "n": 29, "price": 59326, "size": 5.73208 }, { "n": 3, "price": 59327, "size": 0.00071 } ], "bids": [ { "n": 18, "price": 59325, "size": 7.36572 }, { "n": 6, "price": 59324, "size": 1.65972 } ], "coin": "BTC", "source": "first-party", "time": 1782883109851 }, "schema": { "properties": { "asks": { "items": { "properties": { "n": { "type": "number" }, "price": { "type": "number" }, "size": { "type": "number" } }, "type": "object" }, "type": "array" }, "bids": { "items": { "properties": { "n": { "type": "number" }, "price": { "type": "number" }, "size": { "type": "number" } }, "type": "object" }, "type": "array" }, "coin": { "type": "string" }, "source": { "type": "string" }, "time": { "type": "number" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "L2 order book", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/overview": { "get": { "description": "Aggregate market overview (total OI, 24h volume). First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Free sample (try-before-pay).", "operationId": "market_overview", "responses": { "200": { "content": { "application/json": { "example": { "markets": 175, "source": "first-party", "topByVolume": [ { "coin": "BTC", "volume24h": 2818497381.18 }, { "coin": "ETH", "volume24h": 847028710.46 } ], "totalOpenInterest": 6396231573.95, "totalVolume24h": 4861911546.15 }, "schema": { "properties": { "markets": { "type": "number" }, "source": { "type": "string" }, "topByVolume": { "items": { "properties": { "coin": { "type": "string" }, "volume24h": { "type": "number" } }, "type": "object" }, "type": "array" }, "totalOpenInterest": { "type": "number" }, "totalVolume24h": { "type": "number" } }, "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "Aggregate market overview (total OI, 24h volume)", "tags": [ "markets" ], "x-gate": "free" } }, "/v1/markets/price": { "get": { "description": "Mark price, oracle, funding, OI. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_price", "parameters": [ { "in": "query", "name": "symbol", "required": true, "schema": { "example": "BTC", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "coin": "BTC", "fundingRate": -0.000001242, "markPrice": 59325, "midPrice": 59325.5, "openInterest": 36025.87012, "oraclePrice": 59355, "prevDayPx": 59409, "source": "first-party", "volume24h": 2818495883.0872517 }, "schema": { "properties": { "coin": { "type": "string" }, "fundingRate": { "type": "number" }, "markPrice": { "type": "number" }, "midPrice": { "type": "number" }, "openInterest": { "type": "number" }, "oraclePrice": { "type": "number" }, "prevDayPx": { "type": "number" }, "source": { "type": "string" }, "volume24h": { "type": "number" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Mark price, oracle, funding, OI", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/markets/technical-indicators": { "get": { "description": "RSI + SMA computed server-side from one bounded candle fetch. First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_technical_indicators", "parameters": [ { "in": "query", "name": "symbol", "required": true, "schema": { "example": "BTC", "type": "string" } }, { "in": "query", "name": "interval", "required": false, "schema": { "default": "1h", "type": "string" } }, { "in": "query", "name": "period", "required": false, "schema": { "default": 14, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "RSI + SMA computed server-side from one bounded candle fetch", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/mcp/dispatch": { "post": { "description": "MCP dispatch — run any tool with {tool,args}. Generic MCP dispatch — invokes any first-party tool by name; paid per-call via x402 (USDC on Base), same as the named routes.", "requestBody": { "content": { "application/json": { "schema": { "properties": { "args": { "additionalProperties": true, "type": "object" }, "tool": { "enum": [ "anti_survivors", "asset", "backstop_events", "biggest_losses", "biggest_wins", "chain_oracle", "cohort_bias", "cohort_bias_history", "cohort_summary", "cohort_tier", "cohort_tier_positions", "cohort_tier_trades", "cohorts_daily", "coin_alpha_map", "coin_long_short", "coin_risk", "coin_risk_history", "compare", "copy_trade", "cross_market_asset", "global_stats", "hidden_gems", "hour_profitability", "leaderboard", "leaderboard_live", "lethal_coins", "lifecycle", "liquidation_heatmap", "liquidation_summary", "list_assets", "long_short", "long_short_history", "mark_dislocations", "market_candles", "market_concentration", "market_historical_oi", "market_orderbook", "market_overview", "market_positions", "market_price", "market_technical_indicators", "max_pain_events", "most_traded", "newcomer_whales", "official_oi", "oi_history", "one_month_wonders", "perfect_exits", "persistent_winners", "predictions_cross_product_overlap", "predictions_daily_volume", "predictions_markets", "predictions_most_active", "predictions_outcome", "predictions_outcomes", "predictions_questions", "predictions_recent_settlements", "predictions_top_traders", "predictions_trader_outcomes", "recent_closed_positions", "recent_lifecycles", "recent_liquidations", "recent_trades", "risk_overview", "style_distribution", "survivors", "token_leaderboard", "top_liquidators", "top_pnl_coins", "top_volume_wallets", "trader_closed_position_stats", "trader_closed_positions", "trader_daily", "trader_demo", "trader_drawdown_curve", "trader_ledger_stats", "trader_lifecycle_summary", "trader_lifecycles", "trader_performance", "trader_profile", "trader_tokens", "trader_trades", "verify", "wallet_drawdown_curve" ], "type": "string" } }, "required": [ "tool" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "MCP dispatch — run any tool with {tool,args}", "tags": [ "mcp" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/mcp/tools": { "get": { "description": "MCP tool catalog (all first-party). Free ops/discovery endpoint (no payment).", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "MCP tool catalog (all first-party)", "tags": [ "mcp" ] } }, "/v1/openapi.json": { "get": { "description": "This OpenAPI spec (alias of /openapi.json). Free ops/discovery endpoint (no payment).", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "This OpenAPI spec (alias of /openapi.json)", "tags": [ "ops" ] } }, "/v1/predictions/cross-product-overlap": { "get": { "description": "Wallets active in both prediction and perp coins. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_cross_product_overlap", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Wallets active in both prediction and perp coins", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/daily-volume": { "get": { "description": "Per-day prediction-fill volume. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_daily_volume", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-day prediction-fill volume", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/markets": { "get": { "description": "Distinct prediction markets by volume. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_markets", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "count": 408, "fillsScanned": 48144697, "markets": [ { "market": "#1730", "trades": 19516, "volume": 9645422.46 } ], "source": "node_fills ledger", "walletsTracked": 125361, "window": "all" }, "schema": { "properties": { "available": { "type": "boolean" }, "count": { "type": "number" }, "fillsScanned": { "type": "number" }, "markets": { "items": { "properties": { "market": { "type": "string" }, "trades": { "type": "number" }, "volume": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "type": "string" }, "walletsTracked": { "type": "number" }, "window": { "type": "string" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Distinct prediction markets by volume", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/most-active": { "get": { "description": "Prediction markets ranked by trade count. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_most_active", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Prediction markets ranked by trade count", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/outcome": { "get": { "description": "One prediction market’s detail. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_outcome", "parameters": [ { "in": "query", "name": "coin", "required": true, "schema": { "example": "TRUMP:YES", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 25, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "One prediction market’s detail", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/outcomes": { "get": { "description": "Prediction outcomes (markets) by volume. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_outcomes", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Prediction outcomes (markets) by volume", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/questions": { "get": { "description": "Distinct prediction questions (volume, settled flag). First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_questions", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Distinct prediction questions (volume, settled flag)", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/settlements/recent": { "get": { "description": "Recent prediction-market settlement fills. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_recent_settlements", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recent prediction-market settlement fills", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/top-traders": { "get": { "description": "Top prediction-market traders by realized PnL. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_top_traders", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Top prediction-market traders by realized PnL", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/predictions/traders/outcomes": { "get": { "description": "One wallet’s prediction-coin PnL + positions. First-party Hyperliquid predictions data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "predictions_trader_outcomes", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "One wallet’s prediction-coin PnL + positions", "tags": [ "predictions" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/stats": { "get": { "description": "Service + ledger stats. Free ops/discovery endpoint (no payment).", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "Service + ledger stats", "tags": [ "ops" ] } }, "/v1/traders/closed-positions": { "get": { "description": "The wallet’s closing fills (newest first). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_closed_positions", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "The wallet’s closing fills (newest first)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/closed-stats": { "get": { "description": "Closed-position realized-PnL stats. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_closed_position_stats", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Closed-position realized-PnL stats", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/daily": { "get": { "description": "Per-UTC-day buckets for one wallet. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_daily", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-UTC-day buckets for one wallet", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/demo": { "get": { "description": "Illustrative demo trader payload (synthetic). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_demo", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Illustrative demo trader payload (synthetic)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/drawdown-curve": { "get": { "description": "Equity curve, running peak, drawdown. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_drawdown_curve", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Equity curve, running peak, drawdown", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/ledger": { "get": { "description": "Trader ledger aggregate (windowed). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_ledger_stats", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "default": "all", "example": "7d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Trader ledger aggregate (windowed)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/lifecycle-summary": { "get": { "description": "Summary over reconstructed lifecycles. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_lifecycle_summary", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Summary over reconstructed lifecycles", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/lifecycles": { "get": { "description": "Reconstructed open→close lifecycles (newest first). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_lifecycles", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Reconstructed open→close lifecycles (newest first)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/performance": { "get": { "description": "Cumulative realized-PnL curve + summary. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_performance", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Cumulative realized-PnL curve + summary", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/positions": { "get": { "description": "Trader open positions. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "market_positions", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Trader open positions", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/profile": { "get": { "description": "Trader profile (PnL, win-rate, cohort tiers). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_profile", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "accountValue": 15146951.9778, "address": "0x7fdafde5cfb5465924316eced2d3715494c517d1", "closedPositions": 565, "coinsTraded": 11, "fees": -44.6164, "openPositions": 27, "pnlTier": "profit", "realizedPnl": 24844.39, "sizeTier": "small", "source": "first-party", "trades": 2000, "volume": 4461741.63, "winRate": 0.9274, "winRatePct": 92.74 }, "schema": { "properties": { "accountValue": { "type": "number" }, "address": { "type": "string" }, "closedPositions": { "type": "number" }, "coinsTraded": { "type": "number" }, "fees": { "type": "number" }, "openPositions": { "type": "number" }, "pnlTier": { "type": "string" }, "realizedPnl": { "type": "number" }, "sizeTier": { "type": "string" }, "source": { "type": "string" }, "trades": { "type": "number" }, "volume": { "type": "number" }, "winRate": { "type": "number" }, "winRatePct": { "type": "number" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Trader profile (PnL, win-rate, cohort tiers)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/tokens": { "get": { "description": "Per-coin buckets for one wallet. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_tokens", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-coin buckets for one wallet", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/trades": { "get": { "description": "Trader fills. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_trades", "parameters": [ { "in": "query", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Trader fills", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/closed-positions": { "get": { "description": "The wallet’s closing fills (newest first). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_closed_positions", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "The wallet’s closing fills (newest first)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/daily": { "get": { "description": "Per-UTC-day buckets for one wallet. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_daily", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-UTC-day buckets for one wallet", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/drawdown-curve": { "get": { "description": "Equity curve, running peak, drawdown. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_drawdown_curve", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Equity curve, running peak, drawdown", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/lifecycle-summary": { "get": { "description": "Summary over reconstructed lifecycles. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_lifecycle_summary", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Summary over reconstructed lifecycles", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/lifecycles": { "get": { "description": "Reconstructed open→close lifecycles (newest first). First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_lifecycles", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Reconstructed open→close lifecycles (newest first)", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/performance": { "get": { "description": "Cumulative realized-PnL curve + summary. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_performance", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Cumulative realized-PnL curve + summary", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/traders/{address}/tokens": { "get": { "description": "Per-coin buckets for one wallet. First-party Hyperliquid traders data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "trader_tokens", "parameters": [ { "in": "path", "name": "address", "required": true, "schema": { "example": "0x…", "type": "string" } }, { "in": "query", "name": "window", "required": false, "schema": { "example": "30d", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Per-coin buckets for one wallet", "tags": [ "traders" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/trades/recent": { "get": { "description": "Recent fills firehose (node_trades). First-party Hyperliquid markets data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Paid per-call via x402 — USDC on Base, no account or signup.", "operationId": "recent_trades", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "type": "integer" } }, { "in": "query", "name": "coin", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "available": true, "count": 2, "source": "node_trades", "trades": [ { "coin": "ADA", "hash": "0xbeaf10400f4b69dbc028043e6e461302034d0025aa4e88ad6277bb92ce4f43c6", "px": 0.15119, "side": "A", "sz": 5145, "tid": null, "time": "2026-06-24T06:32:44.846794194", "users": null } ] }, "schema": { "properties": { "available": { "type": "boolean" }, "count": { "type": "number" }, "source": { "type": "string" }, "trades": { "items": { "properties": { "coin": { "type": "string" }, "hash": { "type": "string" }, "px": { "type": "number" }, "side": { "type": "string" }, "sz": { "type": "number" }, "tid": {}, "time": { "type": "string" }, "users": {} }, "type": "object" }, "type": "array" } }, "type": "object" } } }, "description": "OK" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/X402Challenge" } } }, "description": "Payment Required (x402)" } }, "security": [ { "x402": [] } ], "summary": "Recent fills firehose (node_trades)", "tags": [ "markets" ], "x-payment-info": { "price": { "amount": "0.001", "currency": "USD", "mode": "fixed" }, "protocols": [ { "x402": {} } ] } } }, "/v1/verify": { "get": { "description": "Confirm the x402 pay-per-call billing model. First-party Hyperliquid ops data, computed from our own validator node_fills ledger + the Hyperliquid info API (no third-party source). Free ops/discovery endpoint.", "operationId": "verify", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK" } }, "security": [], "summary": "Confirm the x402 pay-per-call billing model", "tags": [ "ops" ] } } }, "servers": [ { "url": "https://hyperliquid-data.v1337.org" } ], "tags": [ { "description": "Real-time perp/spot market data (info API).", "name": "markets" }, { "description": "Asset discovery, cross-market (perp+spot).", "name": "assets" }, { "description": "Per-trader profiles, history, lifecycles, drawdown.", "name": "traders" }, { "description": "Cross-wallet rankings, extremes, lifecycle reconstruction, and market structure — all derived from the node_fills ledger.", "name": "analytics" }, { "description": "Wallets grouped into size/PnL brackets — per-bracket membership, aggregates, open positions, and trade flow.", "name": "cohorts" }, { "description": "Point-in-time exposure snapshots: long/short skew, open-interest history, per-tier bias, liquidation-price clustering, mark/oracle drift.", "name": "live" }, { "description": "HIP-4 prediction markets.", "name": "predictions" }, { "description": "Model Context Protocol dispatch + catalog.", "name": "mcp" }, { "description": "Health and service metadata.", "name": "ops" } ], "x-discovery": { "note": "Full first-party API surface; paid ops carry x-payment-info + 402 responses (x402scan OpenAPI-first).", "source": "upstream-openapi" } }