{"uid":"cap_XWmde_edDr-xpqrcj0OVe","slug":"derivs-basis-d404de25","name":"derivs-basis","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://payai.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_lqAecNsK-lQBQW0qdgLJV","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 futures basis (mark-vs-oracle premium) for a crypto asset in basis points, with an annualized carry proxy, sourced from Hyperliquid mark prices.","exampleAgentPrompt":"What's the current perpetual basis for BTC right now — how far is it trading from the oracle price in basis points, and what's the implied annualized carry?","exampleUseCases":[{"title":"Froth detection before leveraged trade","prompt":"Before I open a long position, can you check the perpetual basis for ETH — I want to know if the mark price is trading at a big premium over the oracle, which would signal the market is overly frothy right now?"},{"title":"Carry cost estimation for funding arbitrage","prompt":"I'm running a basis trade between spot and perp — can you pull the current annualized carry proxy for SOL so I can see if the funding yield is worth the hedge?"},{"title":"Monitoring BTC leverage sentiment","prompt":"Can you check the BTC perpetual basis on Hyperliquid and tell me how many basis points the mark is trading above or below the oracle? I'm using it as a leverage sentiment signal for my daily report."}],"resultDescription":"Returns the perpetual basis for the requested asset expressed in basis points (mark price minus oracle price), along with a naive annualized carry proxy derived from that spread. Useful as a froth indicator and leverage-cost signal showing how aggressively the market is positioned in perpetuals relative to the underlying.","failureModes":["Invalid or unsupported ticker symbol returns an error","Asset not listed on Hyperliquid returns no data","Mark price unavailable if Hyperliquid feed is down","Payment failure (x402) if USDC balance insufficient","Normalization of ticker suffix (e.g. BTC-PERP) may fail for non-standard formats"],"whenToPreferThis":"Choose this endpoint when you need a real-time, pre-computed perpetual basis signal sourced specifically from Hyperliquid's native mark price — particularly useful when you want basis points and an annualized carry proxy in a single call without needing to manually fetch and diff mark vs oracle prices yourself. Prefer this over raw exchange APIs when building sentiment dashboards, funding arbitrage tools, or leverage monitors.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:17.620Z","isFirstParty":false}