# x402stock Stock Basis: US Equity vs Hyperliquid Perp Price Comparison > x402stock Stock Basis: US Equity vs Hyperliquid Perp Price Comparison is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP or x402, $0.03/call, status unknown (last checked 2026-09-10). Returns both the official US equity price and the Hyperliquid HIP-3 synthetic perpetual price for a single ticker, plus funding APR, open interest, and the price gap expressed as basis_percent and basis_vs_prev_close_percent. ## Facts - Endpoint: GET https://agents.x402stock.xyz/api/v1/basis/{ticker} - Price: $0.03/call - Payment: MPP, x402 - Status: unknown - Last checked: 2026-09-10 - Activations on Zero: 0 - Provider: agents.x402stock.xyz - Website: https://agents.x402stock.xyz - Tags: x402 - Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-stock-basis-us-equity-vs-hyperliquid-18c4189d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tZ7Z_YjqgqfciD3sKKK-6 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-x402stock-xyz-x402stock-stock-basis-us-equity-vs-hyperliquid-18c4189d ``` Example prompt: Pull up the basis for NVDA right now — I want to see the official US stock price versus the Hyperliquid synthetic perp, the funding APR, and how far the perp is trading from the last close. ## When to prefer this Choose this endpoint when you need a simultaneous cross-venue price comparison between a US-listed stock and its Hyperliquid synthetic perpetual equivalent, especially outside US market hours when the perp price is the only live signal. It is the right choice for basis trading analysis, overnight implied-open monitoring, funding rate tracking, and cross-market arbitrage screening for individual tickers. ## Known failure modes - Ticker not found on Hyperliquid — perp fields null, comparable=false, excluded_reason set - US equity data unavailable or market data delayed beyond threshold — equity_price null - Invalid or lowercase ticker symbol — may return empty rows or error - No Hyperliquid HIP-3 perp exists for the requested stock — perp_symbol null - Payment failure or insufficient USDC balance — 402 response before data is returned ## How this service works One stock priced on every rail at once: its official US listing (delayed, closed overnight) against the 24/7 Hyperliquid HIP-3 synthetic perp. Returns both prices, funding APR, open interest, and the gap as `basis_percent` + `basis_vs_prev_close_percent` — while the US market is shut, the live view of where the name reopens. From x402stock, a market & economic data API (x402, USDC). ## Output A JSON object containing both the US equity data (delayed price, previous close, change percent, timestamp) and the Hyperliquid perpetual data (mark price, oracle price, funding APR, open interest, day volume), along with computed basis fields (basis_percent, basis_absolute, basis_vs_prev_close_percent), a direction label (premium/discount/flat/unknown), a comparable flag, and metadata about which data sections were available. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "pathParams": { "type": "object", "ticker": { "type": "string" } }, "queryParams": { "type": "object", "properties": {} } }, "additionalProperties": false } } } ``` ## Response schema (JSON Schema) ```json { "type": "object", "required": [ "source", "as_of", "venue_map", "us_market_open", "reading", "method", "count", "rows", "sections", "note" ], "properties": { "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rows": { "type": "array", "items": { "type": "object", "required": [ "ticker", "equity_price", "equity_prev_close", "equity_change_percent", "equity_as_of", "perp_symbol", "perp_mark", "perp_oracle", "perp_funding_apr_percent", "perp_open_interest", "perp_day_volume_usd", "basis_percent", "basis_absolute", "basis_vs_prev_close_percent", "direction", "comparable", "excluded_reason" ], "properties": { "ticker": { "type": "string" }, "direction": { "enum": [ "premium", "discount", "flat", "unknown" ], "type": "string" }, "perp_mark": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "comparable": { "type": "boolean" }, "perp_oracle": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_as_of": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "basis_absolute": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "excluded_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "equity_prev_close": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_open_interest": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "perp_day_volume_usd": { … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-stock-basis-us-equity-vs-hyperliquid-18c4189d/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)