{"uid":"cap_cuXcn-q4YptgCJQB8ex4z","slug":"x402stock-basis-spread-api-89ce3916","name":"x402stock Basis Spread API","description":"Scans every US stock that also trades as a 24/7 synthetic perp and returns the gap: official (delayed) price, prev close, perp mark and oracle, funding APR, open interest, and computed `basis_percent` + `basis_vs_prev_close_percent` — the implied overnight move while the US market is shut. Widest dislocation first, plus a plain-English `reading`. `?limit=`, `?min_basis=`. From x402stock","url":"https://x402stock.xyz/api/v1/basis?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["min_basis","limit"],"properties":{"limit":{"type":"integer","default":40,"maximum":200,"exclusiveMinimum":0},"min_basis":{"type":"number","default":0,"maximum":100,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","venue_map","us_market_open","reading","method","count","rows","sections","note","total_available"],"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":{"anyOf":[{"type":"number"},{"type":"null"}]},"equity_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"perp_funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"basis_vs_prev_close_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"as_of":{"type":"string"},"count":{"type":"number"},"method":{"type":"string"},"source":{"type":"string","const":"x402stock"},"reading":{"type":"string"},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"enum":["ok","unavailable"],"type":"string"}},"venue_map":{"type":"object","required":["equity","perp"],"properties":{"perp":{"type":"string"},"equity":{"type":"string"}},"additionalProperties":false},"us_market_open":{"type":"boolean"},"total_available":{"type":"number"}},"additionalProperties":false}}}}},"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},{"ticker":"TSLA","direction":"discount","perp_mark":401.02,"comparable":true,"perp_oracle":401.11,"perp_symbol":"xyz:TSLA","equity_as_of":"2026-07-30T20:00:00.000Z","equity_price":402.11,"basis_percent":-0.27,"basis_absolute":-1.09,"excluded_reason":null,"equity_prev_close":399.4,"perp_open_interest":18220.1,"perp_day_volume_usd":4410233.9,"equity_change_percent":0.68,"perp_funding_apr_percent":-3.19,"basis_vs_prev_close_percent":0.41}],"as_of":"2026-07-30T23:40:00.000Z","count":2,"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,"total_available":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hw5fMyblhQ4iVZeOvL0wX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current basis spread (price difference) between US equity spot prices and their corresponding on-chain perpetual futures contracts on Hyperliquid","exampleAgentPrompt":"Show me all US stocks where the on-chain perpetual futures are trading at a basis of at least 0.5% above or below the equity price — limit to the top 40 results.","exampleUseCases":[{"title":"Overnight equity sentiment via perps","prompt":"The US market is closed right now — can you pull the basis spread data to see what on-chain perp traders think about where stocks will open tomorrow? Show me up to 50 results."},{"title":"Spot arbitrage opportunity scanner","prompt":"I want to find US equities with at least a 1% basis spread between spot and Hyperliquid perps right now — show me the top 20 so I can evaluate potential arb trades."},{"title":"Perp funding rate monitor for tech stocks","prompt":"Pull the current basis data for all US equities and tell me which ones have the highest perpetual funding APR on-chain — I want to see what the funding environment looks like."}],"resultDescription":"A JSON array of rows, each representing a US equity ticker matched to its on-chain perpetual counterpart, including: spot equity price and previous close, perp mark and oracle prices, basis in percentage and absolute dollar terms, basis vs previous close, direction (premium/discount/flat), perp funding APR, open interest, day volume in USD, whether the pair is comparable, and any exclusion reason. Also includes metadata: timestamp, US market open status, venue map (equity source and perp venue), a reading summary of the widest dislocations, and total available pairs.","failureModes":["No pairs meet the min_basis threshold — returns empty rows array","Symbol collision: pairs differing by more than 25% are marked comparable=false with an excluded_reason","Perp or equity data feed temporarily unavailable — sections field will indicate which feed is down","limit exceeds 200 — request rejected with validation error","Stale data during market transitions or feed outages"],"whenToPreferThis":"Use this endpoint when you need to compare US equity spot prices against their Hyperliquid on-chain perpetual futures equivalents — specifically to measure basis spread, funding rates, or gauge overnight/off-hours market sentiment. Prefer this over generic stock price endpoints when the user is interested in derivatives, basis trading, arbitrage between spot and perp, or using perpetual futures as a real-time proxy for equity sentiment when US markets are closed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:41:04.377Z","isFirstParty":false,"canonicalSlug":"x402stock-basis-spread-api-89ce3916"}