{"uid":"cap_i4Hp1-iuTK10h4P8wMQRy","slug":"agentfeed-perp-vs-spot-basis-24b684d7","name":"AgentFeed Perp-vs-Spot Basis","description":"Perp-vs-spot basis for any USDT pair: the premium or discount in %, a contango or backwardation read, and the funding context that goes with it. Use when you need to answer: Is this perp trading above or below spot?","url":"https://x402.ochinimus.app/api/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":[],"properties":{"symbol":{"type":"string","description":"USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"state":{"type":"string"},"symbol":{"type":"string"},"basis_pct":{"type":"number"},"mark_price":{"type":"number"},"spot_price":{"type":"number"},"funding_rate_8h":{"type":"number"},"funding_rate_raw":{"type":"number"},"funding_interval_hours":{"type":"number"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"state":"flat","symbol":"SOLUSDT","basis_pct":-0.0082,"mark_price":121.42,"spot_price":121.43,"funding_rate_8h":0.0001},"paid":true,"tool":"get_basis"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cYQ8McaQxHdfLmiKtubkQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the perpetual-vs-spot price basis percentage, contango/backwardation state, mark price, spot price, and 8-hour funding rate for any USDT perpetual pair on Bybit.","exampleAgentPrompt":"What's the current basis between the SOLUSDT perpetual and spot — is it in contango or backwardation, and what's the funding rate right now?","exampleUseCases":[{"title":"Basis arbitrage opportunity scan","prompt":"Check the BTCUSDT perp vs spot basis for me — is the perp at a significant premium or discount, and is there a funding rate that makes a basis trade worthwhile?"},{"title":"Market sentiment read via funding context","prompt":"What's the funding rate and basis state for ETHUSDT right now — is the perp market leaning bullish or bearish relative to spot?"},{"title":"Pre-trade contango check","prompt":"Before I open a long on AVAXUSDT, can you tell me if the perp is trading above or below spot and what the 8-hour funding rate looks like?"}],"resultDescription":"A JSON object containing the USDT pair symbol, basis percentage (positive = contango/premium, negative = backwardation/discount), a human-readable state label ('contango', 'backwardation', or 'flat'), the current mark price, spot price, and the 8-hour funding rate as a decimal.","failureModes":["Invalid or unsupported symbol returns an error or empty data","Symbol must be a valid Bybit USDT perp symbol (e.g. SOLUSDT, not SOL/USD)","Stale or delayed data if upstream exchange feed is lagging","Payment failure via x402 protocol blocks the response","Missing required 'symbol' query parameter causes a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a single-symbol, real-time snapshot of the perp-vs-spot relationship including basis percentage, market state classification, and funding rate context — especially for basis trading analysis, pre-trade sentiment checks, or funding arbitrage assessment. Prefer this over general price feeds when the perp premium/discount and funding context are the specific signals needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:52:59.401Z","isFirstParty":false,"canonicalSlug":"agentfeed-perp-vs-spot-basis-24b684d7"}