{"uid":"cap__2nVhunh9ftONUtyC_YFo","slug":"market2000-xyz-macro-analog-finder-def475e5","name":"market2000.xyz Macro Analog Finder","description":"Returns a current macro regime snapshot and the closest historical market analogs based on recent SPY, VIX, yield spread, and gold trend data. Useful for regime comparison and market context.","url":"https://market2000.xyz/macro_analog","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"n_analogs":{"type":"integer","description":"Number of historical analogs to return (default 3)"},"lookback_days":{"type":"integer","description":"Rolling return window for macro features (default 20)"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"as_of":{"type":"string"},"top_analogs":{"type":"array"},"generated_at":{"type":"string"},"current_macro":{"type":"object"},"features_used":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-06-08","top_analogs":[{"era":"Trade war correction","date":"2018-10-11","rank":1,"similarity":0.62,"macro_state":{"vix_level":25.3,"spy_roll_pct":-5.1,"yield_spread_pct":2.1},"era_description":"US-China tariffs; Q4 -20%"}],"current_macro":{"vix_level":22.1,"spy_roll_pct":-4.2,"gold_roll_pct":3.1,"fear_greed_score":38,"yield_spread_pct":1.85,"fear_greed_rating":"Fear"},"features_used":["SPY 20-day return","VIX level","10Y-3M yield spread","GLD 20-day return"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_RUgMVK39ohPPM-2wEw22B","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":"Finds historical macroeconomic periods most similar to the current market environment using time-series pattern matching across VIX, SPY, yield spread, and gold returns","exampleAgentPrompt":"What are the top historical market analogs to right now — I want to see which past eras most closely match today's macro environment given the VIX around 22, SPY down about 4% over 20 days, yield spread near 1.85%, and gold up 3%?","exampleUseCases":[{"title":"Contextualize current volatility spike","prompt":"VIX just spiked above 35 and SPY is down 8% over the last month — can you find the historical macro periods that looked most like this and tell me what ended up happening after each of those episodes?"},{"title":"Identify precedents for yield curve move","prompt":"The yield spread has compressed to near zero and gold is rallying hard while equities are choppy — what past macro environments were structurally similar to this, and which one ranks as the closest analog right now?"},{"title":"Validate investment thesis historically","prompt":"I'm thinking about rotating into defensive assets given today's macro setup, but before I do I want to know which historical eras most closely resembled current conditions — same kind of fear levels, SPY drawdown, and yield dynamics — so I can see how those periods played out."}],"resultDescription":"A ranked list of the top historical macro analog eras most similar to the current market environment, each with a similarity score, date, era label (e.g. 'Trade war correction'), descriptive context, and the macro state values (VIX, SPY return, yield spread) at that historical moment. Also includes the current macro snapshot and the features used for matching.","failureModes":["Missing or stale market data inputs may reduce match quality or return an error","Unusual market regimes with no close historical precedent may yield low similarity scores across all analogs","Payment failure via x402 returns a 402 response before any data is delivered","Malformed POST body returns a 400 error","Service unavailability returns a 503 with no analog results"],"whenToPreferThis":"Use this endpoint when you need historically-grounded context for the current macro environment — especially during elevated volatility, trend reversals, or unusual yield curve behavior — and want to understand which past periods were structurally similar and what followed. Prefer this over generic market data APIs when the goal is pattern-matched historical analogy rather than raw data retrieval.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:50:39.662Z","isFirstParty":false}