{"uid":"cap_9UuHmilvSdBJnq2eIZnYb","slug":"tokenguard-long-short-ratio-api-7ab8dbdc","name":"TokenGuard Long/Short Ratio API","description":"long short data for AI agents.","url":"https://eltociear-tokenguard.hf.space/long_short","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"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":"unknown","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_Vzhx8Pzz_dKkXiPEMzKib","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":"Retrieves the long/short ratio for crypto assets, indicating market sentiment and trader positioning on derivatives markets","exampleAgentPrompt":"What's the current long/short ratio for Bitcoin on crypto derivatives markets right now — I want to know if traders are mostly positioned long or short?","exampleUseCases":[{"title":"Derivatives sentiment check before trade","prompt":"Before I place a trade, can you pull the long/short ratio for Ethereum so I know how futures traders are positioned right now?"},{"title":"Contrarian trading signal research","prompt":"I'm looking for potential contrarian signals — can you get the long/short ratio for Solana and tell me if the market is extremely one-sided?"},{"title":"DeFi token market sentiment scan","prompt":"I want to gauge speculative sentiment on a DeFi token — can you fetch the long/short ratio for AAVE and tell me what percentage of traders are long versus short?"}],"resultDescription":"Returns a JSON object containing the long/short ratio for the requested asset, including the ratio value, percentage of long positions, percentage of short positions, and potentially timestamp or exchange-level breakdown indicating market participant sentiment in derivatives markets.","failureModes":["Token or trading pair not found — returns empty or error JSON","Exchange data unavailable for the requested asset — limited coverage for smaller tokens","Stale data if on-chain or exchange feed is delayed","Payment failure via x402 micropayment protocol — call not executed","Invalid request body format — 400-level error","Rate limiting or quota exceeded for the micropayment tier"],"whenToPreferThis":"Use this endpoint when you need real-time or recent derivatives market sentiment data in the form of long/short ratios — particularly for crypto assets traded on major exchanges with futures markets. Prefer this over general price APIs when trader positioning or speculative sentiment (not just price) is the key signal needed, such as for contrarian analysis, sentiment-driven trading strategies, or risk assessment of crowded trades.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:24.922Z","isFirstParty":false}