{"uid":"cap_gcKev0ughhXhmICiABBtQ","slug":"octodamus-stock-perp-facts-77ef3c4d","name":"Octodamus Stock Perp Facts","description":"Tokenized-equity / stock perpetual-futures reference data: funding per venue + tier-1 average, aggregated open interest, and long/short positioning with skew. NVDA/TSLA/AAPL/SPY/etc. Not a prediction.","url":"https://api.octodamus.com/v2/stocks/perp-facts","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["method"],"properties":{"method":{"type":"string","const":"GET"},"headers":{"type":"object","required":["PAYMENT-SIGNATURE"],"properties":{"PAYMENT-SIGNATURE":{"type":"string","description":"x402 EIP-3009 USDC payment signature (Base mainnet)"}}}}},"output":{"type":"object","properties":{"action":{"enum":["BUY","SELL","HOLD"],"type":"string"},"signal":{"enum":["BULLISH","BEARISH","NEUTRAL"],"type":"string"},"btc_trend":{"enum":["UP","DOWN","SIDEWAYS"],"type":"string"},"reasoning":{"type":"string"},"confidence":{"type":"number","maximum":1,"minimum":0},"fear_greed":{"type":"number","maximum":100,"minimum":0},"polymarket_edge":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PRpixyeZ5odTTS5Vq7tGO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns tokenized-equity perpetual-futures reference data including funding rates by venue and tier-1 average, aggregated open interest, and long/short positioning with skew for major symbols (NVDA, TSLA, AAPL, SPY, etc.)","exampleAgentPrompt":"Pull the latest perpetual futures reference data for NVDA — I want to see the funding rates broken down by venue and the tier-1 average, plus the aggregated open interest and whether longs or shorts are dominant right now.","exampleUseCases":null,"resultDescription":"Returns structured data for tokenized-equity perpetual futures including per-venue funding rates, a tier-1 aggregate average, total aggregated open interest, and long/short positioning ratios with skew indicators for major symbols like NVDA, TSLA, AAPL, and SPY.","failureModes":["Missing or invalid PAYMENT-SIGNATURE header returns 402 Payment Required","Expired or already-used payment signature returns authentication error","Network timeout if data aggregation from multiple venues is slow","Symbol not supported returns empty or error response","Malformed x402 EIP-3009 signature returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need cross-venue perpetual futures reference data (funding rates, open interest, long/short skew) specifically for tokenized equities like NVDA, TSLA, AAPL, or SPY — as opposed to native crypto perps. It is ideal for agents building derivatives dashboards, monitoring carry costs, or assessing market positioning in tokenized stock perp markets. Prefer this over generic crypto derivatives endpoints when the underlying asset is a tokenized equity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T03:43:30.141Z","isFirstParty":false}