{"uid":"cap_wT7udY3xNPRHBe3JqwKs3","slug":"macropulse-forex-sentiment-positioning-analysis-588fb917","name":"MacroPulse Forex Sentiment & Positioning Analysis","description":"Real-time directional sentiment for any forex pair or gold — retail crowd positioning, COT institutional alignment, and a clear contrarian bias call. Built for FX trading and advisor agents.","url":"https://macropulse.theaslangroupllc.com/api/sentiment","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"pair":{"type":"string","description":"EURUSD | GBPUSD | USDJPY | AUDUSD | USDCAD | XAUUSD | USOIL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"pair":"EURUSD","signal":"contrarian LONG — crowd is heavily short","strength":"strong","cot_alignment":true,"retail_long_pct":38,"retail_short_pct":62}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JAK7Zh6xnesKdlSD3UWq9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time directional sentiment for any forex pair or gold, combining retail crowd positioning, COT institutional alignment, and a contrarian bias signal.","exampleAgentPrompt":"What's the current sentiment picture for EUR/USD — give me the retail crowd positioning, whether institutions are aligned or diverging based on COT data, and the contrarian bias call.","exampleUseCases":null,"resultDescription":"Returns retail crowd positioning percentages (long/short), CFTC COT-derived institutional net positioning, directional alignment or divergence between retail and institutional participants, and a clear contrarian bias recommendation for the requested forex pair or gold.","failureModes":["Unsupported symbol returns 400 or empty result — only major forex pairs and gold are supported","Stale COT data on weeks with delayed CFTC releases may reduce institutional signal freshness","Payment failure or missing x402 header returns 402 Payment Required","Rate limiting if too many calls are made in rapid succession"],"whenToPreferThis":"Choose this endpoint when you need a combined retail-vs-institutional sentiment picture with an explicit contrarian bias call for a specific forex pair or gold — especially when you want to identify overcrowded retail positions that institutions may be fading. Prefer over raw COT-only endpoints when you want a synthesized signal rather than raw positioning numbers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:43.433Z","isFirstParty":false}