# market2000.xyz Macro Analog Finder

> market2000.xyz Macro Analog Finder is a paid API for AI agents from market2000.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Finds historical macroeconomic periods most similar to the current market environment using time-series pattern matching across VIX, SPY, yield spread, and gold returns

## Facts

- Endpoint: GET https://market2000.xyz/macro_analog
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market2000-xyz-macro-analog-finder-def475e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__2nVhunh9ftONUtyC_YFo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market2000-xyz-macro-analog-finder-def475e5
```

Example prompt: 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%?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market2000-xyz-macro-analog-finder-def475e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market2000.xyz](https://www.zero.xyz/host/market2000.xyz/llms.txt)