{"uid":"cap_qMJNpf9QiNEQ3U6AJTe29","slug":"agentfeed-long-short-ratio-usdt-perp-crowding-gauge-0a8dafc7","name":"AgentFeed Long/Short Ratio — USDT Perp Crowding Gauge","description":"Long/short ratio for ANY USDT perp: the retail long and short account percentages from Bybit with 1h and 24h trend. Use when you need to answer: How crowded is retail on this perp? The crowding gauge.","url":"https://x402.ochinimus.app/api/long-short?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"},"queryParams":{"type":"object","required":[],"properties":{"symbol":{"type":"string","description":"USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"ts":{"type":"number"},"period":{"type":"string"},"source":{"type":"string"},"symbol":{"type":"string"},"long_pct":{"type":"number"},"short_pct":{"type":"number"},"long_pct_1h_ago":{"type":"number"},"long_pct_24h_ago":{"type":"number"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"ts":1790352000000,"period":"1h","source":"bybit_v5_public","symbol":"SOLUSDT","long_pct":68.86,"short_pct":31.14,"long_pct_1h_ago":68.74,"long_pct_24h_ago":70.08},"paid":true,"tool":"get_long_short"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_411-bSqhABrvn9ZuXjII8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current retail long/short account percentage ratio for any USDT perpetual from Bybit, with 1h and 24h historical trend data to gauge crowd positioning.","exampleAgentPrompt":"What's the current long/short ratio for SOLUSDT on Bybit perps — how crowded is the long side, and has it changed much in the last hour and 24 hours?","exampleUseCases":[{"title":"Crowding check before entering a trade","prompt":"Before I enter a long on ETH perps, can you check how crowded the long side is right now on ETHUSDT — give me the current long percentage and whether it's gone up or down from 1h and 24h ago?"},{"title":"Automated sentiment alert for BTC","prompt":"Monitor BTCUSDT long/short ratio and let me know if retail longs cross above 70% — I want to know if the crowd is getting dangerously one-sided on Bitcoin perps."},{"title":"Compare crowd positioning across altcoins","prompt":"Pull the current long/short ratios for AVAXUSDT and LINKUSDT so I can see which one has a more crowded long side right now — include how those percentages have shifted over the last 24 hours."}],"resultDescription":"Returns a JSON object with the symbol, timestamp, period, data source (bybit_v5_public), current long_pct and short_pct (retail account percentages), plus long_pct_1h_ago and long_pct_24h_ago for trend context. Also includes a 'paid' boolean and tool name.","failureModes":["Missing or invalid 'symbol' query parameter returns an error — symbol must be a valid USDT perp e.g. SOLUSDT","Symbol not tracked by Bybit v5 public API returns no data or empty response","Payment failure (x402 protocol) if USDC balance is insufficient — returns 402","Bybit API downtime or rate limiting may cause stale or missing data","Symbol format errors (e.g. SOL-USDT instead of SOLUSDT) may return null results"],"whenToPreferThis":"Use this endpoint when you need real-time retail crowd positioning for a USDT perpetual — specifically Bybit's long/short account ratio with trend comparison. Prefer this over funding rate endpoints when you want to know how lopsided retail accounts are (crowding gauge), not just the cost of carry. Best for sentiment analysis, contrarian signals, or pre-trade positioning checks on any USDT perp Bybit supports.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:40:21.180Z","isFirstParty":false,"canonicalSlug":"agentfeed-long-short-ratio-usdt-perp-crowding-gauge-0a8dafc7"}