{"uid":"cap_QZELpY8QR7JjRjFbsw9xz","slug":"derivatives-positioning-squeeze-score-676a0986","name":"Derivatives Positioning & Squeeze Score","description":"Fusion positioning brief for a perpetual asset in ONE call: aggregate funding and APR, aggregate open interest, mark-vs-oracle basis, cross-venue funding spread, a funding-flip trend from Hyperliquid history, and a deterministic 0-100 squeeze/positioning score with a verdict and crowding direction. Saves several protocol calls plus the normalization and scoring.","url":"https://api.agentstools.dev/derivs/positioning","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.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NMfIQ--SbEJo6iILR5TUU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a fused perpetual futures positioning brief for a given asset: aggregated funding rates, open interest, mark-vs-oracle basis, cross-venue funding spread, funding-flip trend, and a deterministic 0-100 squeeze/crowding score with verdict.","exampleAgentPrompt":"Can you pull the full positioning brief for BTC perps — funding rates, open interest, squeeze score, and whether longs or shorts are crowded?","exampleUseCases":null,"resultDescription":"A structured JSON object containing: aggregated funding rate and APR across venues, aggregated open interest, mark-vs-oracle basis, cross-venue funding spread, a funding-flip trend derived from Hyperliquid history, and a deterministic 0-100 squeeze/positioning score with a plain-language verdict and crowding direction (long/short).","failureModes":["Unsupported or unrecognized ticker symbol returns an error","Upstream data source unavailability may cause partial or failed response","Rate limiting or payment failure via x402 protocol","Malformed symbol input (e.g. unsupported quote suffix not normalized) returns validation error"],"whenToPreferThis":"Use this endpoint when you need a single-call comprehensive positioning snapshot for a crypto perpetual, avoiding the need to hit multiple protocol APIs, normalize heterogeneous data, and compute a composite crowding/squeeze score yourself. Ideal for agents performing risk assessment, trade signal generation, or market monitoring without wanting to manage multi-source aggregation logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:46:18.470Z","isFirstParty":false}