{"uid":"cap_jks3XvuNXkX2vrzdASAZ7","slug":"perp-funding-basis-0b0e8fe7","name":"Perp Funding & Basis","description":"Choosing between spot and a perp? This is the data that choice needs. Aggregate OI-weighted perpetual funding, open interest and basis for a coin across venues (CoinGecko, no key): who pays whom (longs crowded vs shorts crowded), the carry you earn or bleed holding the perp, and contango vs backwardation. Verdict neutral / elevated / extreme. Pass symbol=BTC. Funding annualised as an estimate (8h intervals assumed). A market-structure signal, not a price call. Not financial advice.","url":"https://402.com.tr/api/x402/perp-funding?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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Coin symbol (BTC, ETH, SOL…)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JGuXbNW79dw17J7oqgmZT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns OI-weighted perpetual funding rate, open interest, and basis (contango/backwardation) for a given crypto coin aggregated across venues, with a crowding verdict.","exampleAgentPrompt":"What's the current perpetual funding rate and basis for BTC — is the market long-crowded or short-crowded, and is the verdict elevated or extreme?","exampleUseCases":[{"title":"Spot vs perp carry decision for BTC","prompt":"I'm deciding whether to hold spot BTC or the perp — can you pull the current funding rate, basis, and crowding verdict for BTC so I can see whether I'd be bleeding or earning carry on the perpetual?"},{"title":"Detecting crowded longs in ETH perp","prompt":"Are longs getting too crowded in the ETH perpetual market right now? Pull the OI-weighted funding data for ETH and tell me whether the verdict is neutral, elevated, or extreme."},{"title":"Contango check before SOL basis trade","prompt":"Before I set up a basis trade on SOL, can you check whether the SOL perp is in contango or backwardation and what the annualized funding rate looks like across venues?"}],"resultDescription":"Returns OI-weighted aggregate perpetual funding rate (annualized, assuming 8-hour intervals), open interest, and basis (contango vs backwardation) for the requested coin across exchanges sourced via CoinGecko. Includes a crowding verdict categorized as neutral, elevated, or extreme, indicating whether longs or shorts dominate the market.","failureModes":["Missing or invalid symbol parameter returns an error","Unknown or unsupported coin symbols may return no data","CoinGecko data unavailability causes downstream failure","Stale or insufficient OI data may reduce accuracy of aggregated metrics","Payment failure (x402 micropayment not fulfilled) blocks the response"],"whenToPreferThis":"Use this endpoint when you need a quick, cross-venue aggregated view of perpetual market structure for a single coin — specifically funding rate, open interest weighting, and basis — without building your own aggregation layer across exchanges. Prefer this over raw exchange APIs when you want an opinionated crowding verdict (neutral/elevated/extreme) in one call. Best suited for agents making spot-vs-perp carry decisions or screening for crowded positioning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T00:43:58.324Z","isFirstParty":false,"canonicalSlug":"perp-funding-basis-0b0e8fe7"}