{"uid":"cap_ztYTlquc9f6q_TVqykcF8","slug":"perp-basis-oracle-premium-signal-60a4b82c","name":"Perp Basis / Oracle Premium Signal","description":"Perp premium to oracle price for a coin on Hyperliquid, in percent, with a stretched/normal verdict.","url":"https://derivatives.x402tookit.com/perp-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"],"type":"string"},"queryParams":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid ticker, e.g. BTC, ETH"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"coin":{"type":["null","string"]},"midPx":{"type":["null","number"]},"markPx":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"oraclePx":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"thresholds":{"type":["null","object"],"properties":{"stretchedPct":{"type":["null","number"]}}},"venuePremium":{"type":["null","number"]},"markVsOraclePct":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bciyrja1qGWmpZlVsh8w3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the perpetual contract's premium (or discount) relative to the oracle price for a given coin on Hyperliquid, expressed as a percentage, with a stretched/normal verdict.","exampleAgentPrompt":"What's the current perp basis for ETH on Hyperliquid — is the mark price stretched above or below the oracle price right now?","exampleUseCases":[{"title":"Basis arbitrage entry check","prompt":"Before I put on a cash-and-carry trade, can you tell me how far the BTC perp mark price is from the Hyperliquid oracle price right now, and whether that spread is considered stretched?"},{"title":"Risk filter before a long entry","prompt":"I'm about to open a long on SOL perp — is the perp basis on Hyperliquid currently stretched to the upside versus the oracle? I don't want to chase a bloated premium."},{"title":"Monitoring basis for a portfolio hedge","prompt":"Check the Hyperliquid perp-to-oracle premium for ETH and let me know if it's in stretched territory — I need to decide whether to adjust my hedge ratio."}],"resultDescription":"Returns a JSON object containing the coin ticker, mark price, mid price, oracle price, venue premium, mark-vs-oracle percentage, a stretched/normal verdict string, supporting reasons array, a human-readable summary, applicable thresholds (e.g. stretchedPct), data timestamp (asOf), source URL, and optional degraded/disclaimer flags.","failureModes":["Invalid or unsupported coin ticker returns an error or null fields","Coin not listed as an active Hyperliquid perp results in empty or degraded response","Hyperliquid oracle data temporarily unavailable causes degraded flag to be set true","Network timeout from upstream Hyperliquid API causes request failure","Passing a non-GET method or missing required coin query param returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a real-time snapshot of how far a specific coin's perpetual contract mark price deviates from its oracle reference price on Hyperliquid, and want a ready-made verdict on whether that spread is unusual. Prefer this over generic price feeds when the goal is basis monitoring, arbitrage screening, or risk management around oracle-mark price divergence specifically on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:35:28.698Z","isFirstParty":false,"canonicalSlug":"perp-basis-oracle-premium-signal-60a4b82c"}