{"uid":"cap_N8uuTz3GgjNzxEWgEJOeB","slug":"perpetual-basis-mark-vs-oracle-premium-lookup-44a950b9","name":"Perpetual Basis (Mark-vs-Oracle Premium) Lookup","description":"Perpetual basis for an asset: the mark-versus-oracle premium on venues that publish a native mark price (Hyperliquid), in basis points, with a naive annualized carry proxy. Shows how far the perpetual trades from the underlying oracle — a froth and leverage-cost signal.","url":"https://api.agentstools.dev/derivs/basis","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","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Base asset ticker (BTC, ETH, SOL). A quote suffix such as BTC-USD or BTC-PERP is accepted and normalized server-side."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1WShdA-cxAzu7lBv74uAR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the perpetual basis in basis points for a crypto asset — the mark-minus-oracle premium on Hyperliquid — plus a naive annualized carry proxy as a leverage-cost and froth signal.","exampleAgentPrompt":"What's the current perpetual basis for BTC on Hyperliquid — how far is the mark price from the oracle in basis points, and what does that imply for annualized carry?","exampleUseCases":[{"title":"Detect ETH perp leverage froth","prompt":"Is the ETH perpetual on Hyperliquid showing any signs of being overheated right now? Check the mark-vs-oracle spread in basis points and tell me if the annualized carry looks frothy."},{"title":"Compare SOL carry cost to BTC","prompt":"Pull the current perpetual basis for both SOL and BTC on Hyperliquid — I want to see which one has a higher mark-oracle premium and what that means for the cost of holding a leveraged long."},{"title":"Spot funding arbitrage opportunity","prompt":"I'm looking for funding arbitrage setups — can you check the mark-versus-oracle basis in basis points for ETH perps on Hyperliquid and tell me if the annualized carry proxy is wide enough to make a cash-and-carry trade worth considering?"}],"resultDescription":"Returns the mark-minus-oracle spread in basis points for the requested asset's perpetual contract, along with the raw mark price, oracle price, and a naive annualized carry proxy — useful for gauging leverage froth and cost of carry.","failureModes":["Missing or invalid 'symbol' query parameter — returns 400 with validation error","Symbol not supported by Hyperliquid (e.g. obscure altcoin) — returns 404 or empty result","Hyperliquid mark price feed temporarily unavailable — upstream timeout or 503","Payment not made or x402 header missing — returns 402 Payment Required","Malformed ticker that cannot be normalized server-side — returns 400"],"whenToPreferThis":"Choose this endpoint when you specifically need the mark-vs-oracle premium (basis) on Hyperliquid perpetuals, particularly when assessing leverage froth, cost of carry, or funding arbitrage signals. Prefer this over general funding rate endpoints when you want basis points expressed relative to the oracle price with an annualized proxy, rather than a raw funding rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:14:15.028Z","isFirstParty":false}