{"uid":"cap_0jcMLATMtlM-oYPOsNFxJ","slug":"x402stock-basis-endpoint-perp-vs-equity-basis-for-a-ticker-ac86dc90","name":"x402stock Basis Endpoint — Perp vs Equity Basis for a Ticker","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/basis/%7Bticker%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":null,"rows":[{"ticker":"NVDA","direction":"premium","perp_mark":182.95,"comparable":true,"perp_oracle":182.88,"perp_symbol":"xyz:NVDA","equity_as_of":"2026-07-30T20:00:00.000Z","equity_price":181.42,"basis_percent":0.84,"basis_absolute":1.53,"excluded_reason":null,"equity_prev_close":180.11,"perp_open_interest":41230.5,"perp_day_volume_usd":9128441.22,"equity_change_percent":0.73,"perp_funding_apr_percent":11.42,"basis_vs_prev_close_percent":1.58}],"as_of":"2026-07-30T23:40:00.000Z","count":1,"method":"Legs are joined by ticker symbol. Macro perps (commodities, FX, indices) are excluded because their symbols collide with unrelated US tickers, and any remaining pair differing by more than 25% is treated as a symbol collision rather than a dislocation — see `comparable` and `excluded_reason` per row.","source":"x402stock","reading":"US market closed — the 24/7 perp is the live opinion of where these reopen. Widest vs last print: NVDA at 0.84%.","sections":{"perps":"ok","equities":"ok"},"venue_map":{"perp":"hyperliquid:xyz","equity":"us_listed"},"us_market_open":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w4XUyZ_qLCQCNtDQ9Dl-K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the basis (price dislocation) between a perpetual futures contract and the corresponding US-listed equity or ETF for a given ticker symbol","exampleAgentPrompt":"What's the current basis between NVDA's on-chain perpetual futures on Hyperliquid and the US-listed equity price — show me the basis percent, direction, and annualized funding rate?","exampleUseCases":[{"title":"Overnight equity reopen signal","prompt":"The US market is closed right now — what does the NVDA perp on Hyperliquid think the stock will open at tomorrow, and how wide is the basis versus last close?"},{"title":"Basis arbitrage opportunity scan","prompt":"Is there currently a meaningful price dislocation between AMD's perpetual futures and its listed equity price? Give me the basis percent and whether the perp is at a premium or discount."},{"title":"Perp funding cost assessment","prompt":"What's the annualized funding rate on TSLA's equity perp right now, and how does the perp mark price compare to the last equity close?"}],"resultDescription":"A JSON object containing, per ticker: the perp mark price, perp oracle price, equity price, equity previous close, basis in absolute dollars and percent, basis vs previous close percent, direction (premium or discount), annualized funding APR, perp open interest, perp day volume in USD, a comparable flag indicating whether the pair is valid, an excluded reason if not, and metadata including the as-of timestamp, US market open status, venue map, and a human-readable reading of the widest dislocation.","failureModes":["Ticker not found or not supported — row may be absent or excluded_reason populated","Symbol collision between macro perp and unrelated US ticker — comparable flag set to false","Price difference exceeds 25% threshold — treated as symbol collision, not a dislocation","Perp or equity data source temporarily unavailable — sections.perps or sections.equities set to error state","Invalid ticker path parameter — may return empty rows or error response"],"whenToPreferThis":"Use this endpoint when you need to quantify the real-time price dislocation between a Hyperliquid on-chain equity perpetual and the corresponding US-listed stock or ETF. It is uniquely suited for basis trading analysis, overnight gap prediction when US markets are closed, and funding rate cost assessment. Prefer it over generic quote endpoints when the specific question involves perp-vs-spot spread, not just price lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:39:47.101Z","isFirstParty":false,"canonicalSlug":"x402stock-basis-endpoint-perp-vs-equity-basis-for-a-ticker-ac86dc90"}