{"uid":"cap_DCmP3JvPlcbBWh3OhHEx5","slug":"4sec-futures-long-short-ratio-api-bfc7d91a","name":"4SEC Futures Long/Short Ratio API","description":"Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.","url":"https://api.foursec.xyz/futures/long-short/%7Bsymbol%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"object","example":{"signal":{"type":"string"},"symbol":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"top_traders":{"type":"object"}}},"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":"down","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_KdB3gEJSaM2EbI_UR0jAc","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 real-time long/short ratio signals and top trader positioning data for a given crypto futures symbol, aggregated across multiple DEXes.","exampleAgentPrompt":"What's the current long/short ratio signal and top trader positioning for BTCUSDT futures right now?","exampleUseCases":[{"title":"Crypto trading signal dashboard","prompt":"Pull the latest long/short ratio signal for ETHUSDT futures — I want to see how top traders are positioned before I place a trade."},{"title":"DeFi sentiment monitoring bot","prompt":"Check the 4SEC futures sentiment signal for SOLUSDT and tell me whether the market is leaning long or short based on top trader data."},{"title":"Automated trade entry filter","prompt":"Before I open a long position on BTCUSDT, fetch the current long/short signal from 4SEC so I can confirm trader sentiment is bullish."}],"resultDescription":"Returns a JSON object containing a signal string (e.g. 'long' or 'short'), the queried symbol, a timestamp, and a top_traders object with positioning breakdown data aggregated across multiple DEXes.","failureModes":["Invalid or unsupported symbol returns an error or empty result","Payment failure via x402 protocol if USDC balance is insufficient","Symbol path parameter missing or malformed resulting in 404","Rate limiting or API unavailability during high-traffic periods","Stale data if DEX aggregation sources experience delays"],"whenToPreferThis":"Choose this endpoint when you need real-time, multi-DEX aggregated long/short sentiment and top-trader positioning for crypto futures symbols. It is particularly useful for trading agents that need a directional signal before entering or exiting positions, or for monitoring smart money positioning. Prefer this over single-exchange or order-book-only data sources when you want aggregated DEX-level insights paid per-request via crypto microtransactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T14:28:45.186Z","isFirstParty":false}