{"uid":"cap_x3ixX465wfFASSQDiL3Ph","slug":"blockrun-long-short-ratio-history-2a9be232","name":"BlockRun Long/Short Ratio History","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/exchange/long-short-ratio","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"pair":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0085","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.0085/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FScIgIf6FxwSCCZ_KCmeb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical long/short ratio data for a given trading pair from exchange perpetual/futures markets","exampleAgentPrompt":"Can you pull the long/short ratio history for BTCUSDT from BlockRun so I can see how trader positioning has shifted recently?","exampleUseCases":null,"resultDescription":"A time series of long/short ratio values for the specified trading pair, showing historical positioning sentiment from exchange data — indicating whether more traders are holding long vs short positions over time.","failureModes":["Missing required 'pair' query parameter returns an error","Invalid or unsupported trading pair symbol returns no data or error","Rate limiting or payment failure results in 402 or 429 response","Network timeout if exchange data feed is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need historical long/short ratio data for crypto perpetual or futures trading pairs to gauge crowd sentiment and positioning over time. Prefer this over generic market data APIs when specifically studying derivatives market sentiment or contrarian trading signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:51:27.455Z","isFirstParty":false}