# MacroLens Interest Rates API

> MacroLens Interest Rates API is a paid API for AI agents from marcolens.vercel.app, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-14).

Retrieves AI-analyzed interest rate data from FRED sources with LLM-generated macro-economic insights starting from a specified date

## Facts

- Endpoint: POST https://marcolens.vercel.app/api/interest-rates
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macrolens-interest-rates-api-03e31f2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8GE9SG8YH57cmG2Abcg7f

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 macrolens-interest-rates-api-03e31f2b -d '<json body>'
```

Example prompt: Pull together an AI-powered interest rate analysis starting from January 2022 — I want to understand how rates have moved and what the macro trends look like.

## When to prefer this

Choose this endpoint when you need AI-interpreted interest rate data combining FRED's authoritative time series with LLM-generated macro narrative, especially when you want more than raw numbers — i.e., contextual analysis of rate trends, policy implications, and economic commentary. Prefer over raw FRED API calls when you want the insight layer included without building your own prompt pipeline. Best for macro research, investment briefings, and economic monitoring use cases that need both data and interpretation.

## Known failure modes

- Missing required 'start' parameter returns validation error
- Invalid date format in 'start' field causes parsing failure
- FRED data unavailable for the requested date range returns empty data
- x402 payment not included or insufficient USDC balance causes 402 Payment Required response
- MiMo LLM generation timeout may cause partial or failed response
- Very early start dates (pre-1950s) may return sparse or no FRED data

## How this service works

AI-powered macro-economic analysis. FRED + World Bank data + MiMo LLM. 20 endpoints. x402 on Base.

## Output

Returns a JSON object with a success boolean and a data object containing interest rate time series data sourced from FRED, enriched with AI-generated macro-economic analysis and narrative commentary produced by the MiMo LLM covering trends, policy context, and economic implications from the specified start date to present.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "start"
 ],
 "properties": {
  "start": {
   "type": "string",
   "description": "start"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macrolens-interest-rates-api-03e31f2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from marcolens.vercel.app](https://www.zero.xyz/host/marcolens.vercel.app/llms.txt)