{"uid":"cap_x3ixX465wfFASSQDiL3Ph","slug":"blockrun-long-short-ratio-history-2a9be232","name":"BlockRun Long/Short Ratio History","description":"BlockRun independently tests AI agents that move money: did they pay the right party the right amount, avoid being scammed, stay within their mandate, and tell the truth afterwards. Scored from the ledger, not by a model judge.","url":"https://blockrun.ai/api/v1/surf/exchange/long-short-ratio?utm_source=zero.xyz","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-10-31T00:41:56.556Z","isFirstParty":false,"canonicalSlug":"blockrun-long-short-ratio-history-2a9be232"}