{"uid":"cap_2J7dPtu9_0D2_8kQVC6Uj","slug":"derivs-positioning-e938e163","name":"derivs-positioning","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://payai.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_4IcjoQ35W4p6EwTxRAGbP","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 fusion perpetual-futures positioning brief for a crypto asset, including aggregated funding rates, open interest, mark-vs-oracle basis, cross-venue spread, funding-flip trend, and a 0-100 squeeze/crowding score with verdict.","exampleAgentPrompt":"Give me the full positioning brief for BTC perps — I want the aggregate funding rate, open interest, mark-vs-oracle basis, cross-venue spread, and the squeeze score with a verdict on whether the market is crowded long or short.","exampleUseCases":[{"title":"Pre-trade squeeze risk check for BTC","prompt":"Before I open a short on BTC, can you pull the positioning brief and tell me the current squeeze score and whether the perp market looks crowded long or short?"},{"title":"ETH funding arbitrage opportunity scan","prompt":"Is there a meaningful funding spread between venues on ETH perps right now? Give me the cross-venue funding spread and aggregate APR so I can evaluate an arb."},{"title":"SOL crowding alert for a trading bot","prompt":"Check the positioning score for SOL perpetuals and let me know if the crowding score is above 70 — I want to know if there's a squeeze risk before my bot places the next trade."}],"resultDescription":"Returns a structured brief containing: aggregate funding rate and annualized APR across venues, aggregate open interest, mark-vs-oracle price basis, cross-venue funding spread, a funding-flip trend derived from Hyperliquid historical data, and a deterministic 0-100 squeeze/positioning score accompanied by a human-readable verdict (e.g. 'crowded long', 'crowded short', 'neutral') and crowding direction label.","failureModes":["Unsupported or misspelled ticker symbol returns an error or empty result","Exchange data temporarily unavailable causes partial aggregation","Rate limiting or payment failure (x402) if USDC balance is insufficient","Network timeout if upstream venue APIs are slow","Stale data if underlying venue APIs have delayed feeds"],"whenToPreferThis":"Choose this endpoint when you need a single-call, pre-normalized derivatives positioning summary for a crypto asset rather than making multiple calls to individual exchange APIs and computing funding aggregates, OI totals, and squeeze scores yourself. It's especially valuable when you need a deterministic scoring signal (the 0-100 squeeze score) for automated trading decisions, risk monitoring, or market-condition filtering without building your own normalization pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:08:37.913Z","isFirstParty":false}