{"uid":"cap_sQYiIrmkYAUDs7eLqoW9b","slug":"perp-vs-spot-basis-calculator-hyperliquid-d67a3fed","name":"Perp-vs-Spot Basis Calculator (Hyperliquid)","description":"Perp-vs-spot basis for a coin: mark price vs spot oracle, basis %, annualized carry, and contango/backwardation signal. Send { coin }. Basis-trade and cash-and-carry signal.","url":"https://x402-services-production.up.railway.app/api/perps/basis","method":"POST","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Perp symbol, e.g. ETH"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dwa3HMyI79klLXcopvcem","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the perpetual-vs-spot basis for a given coin, including mark price, spot oracle price, basis percentage, annualized carry, and a contango/backwardation signal for basis-trade analysis.","exampleAgentPrompt":"What's the current basis between ETH perps and spot on Hyperliquid — is it in contango or backwardation, and what's the annualized carry for a cash-and-carry trade?","exampleUseCases":null,"resultDescription":"Returns the mark price of the perpetual, the spot oracle price, the raw basis (mark minus spot), basis as a percentage, annualized carry rate, and a contango or backwardation signal — giving everything needed to evaluate a cash-and-carry or basis-arbitrage trade.","failureModes":["Unknown or unsupported coin symbol returns an error","Hyperliquid market data unavailable causes a fetch failure","Missing 'coin' field in request body returns a validation error","Market not listed on Hyperliquid returns empty or null data"],"whenToPreferThis":"Use this endpoint when you need to evaluate the basis between a perpetual futures contract and its underlying spot price for a specific coin on Hyperliquid, especially to identify cash-and-carry trade opportunities, measure contango/backwardation, or quantify annualized carry. Prefer this over generic funding rate endpoints when the key question is spot-vs-perp price divergence rather than just the funding rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:16.921Z","isFirstParty":false}