{"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?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","errors":{"400":{"example":{"error":"invalid request"},"description":"Invalid or missing parameter(s). Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."},"402":{"description":"Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."},"500":{"example":{"error":"upstream_failed"},"description":"Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."}},"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":{"p10Cents":"5.0000","medianCents":"5.0000","p90Cents":"5.0000","minCents":"5.0000","maxCents":"5.0000","p95Cents":"5.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"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-10-29T06:42:52.906Z","isFirstParty":false,"canonicalSlug":"macropulse-forex-sentiment-positioning-analysis-588fb917"}