# Lumen Investment Research

> Lumen Investment Research is a paid API for AI agents from research.lumenhouse.xyz, paid per call via x402, $1/call, status unknown (last checked 2026-09-15).

Tests a crypto, protocol, company, or market investment thesis against current evidence and returns a structured verdict with confidence, catalysts, risks, and next diligence steps.

## Facts

- Endpoint: POST https://research.lumenhouse.xyz/v1/research
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumen-investment-research-f1138421
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nszvrxHJhhWnVtJfBMohb

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 lumen-investment-research-f1138421 -d '<json body>'
```

Example prompt: Research my medium-risk investment thesis on Ethereum restaking protocols over a months horizon — specifically, does the current evidence support the idea that restaking will meaningfully expand ETH staking yields and attract institutional capital?

## When to prefer this

Choose this endpoint when a trading or portfolio agent needs a structured, evidence-backed evaluation of a specific investment thesis before making a decision — especially for crypto assets, DeFi protocols, or emerging market subjects where current on-chain and market data is critical. Prefer this over generic web search when you need a verdict, confidence score, and actionable diligence steps in a single structured response rather than raw information retrieval.

## Known failure modes

- Missing required fields (subject or question) returns a validation error
- Ambiguous or overly broad subject may produce low-confidence results
- Very short horizons (days) on illiquid or data-sparse assets may return limited evidence
- Network or upstream data source failures may result in degraded or incomplete analysis
- Payment failure via x402 protocol blocks the call before processing

## How this service works

Test a crypto, protocol, company, or market investment thesis with current cited evidence. Returns thesis status, verdict, confidence, catalysts, risks, red flags, invalidation conditions, monitoring triggers, unknowns, and next diligence steps as structured JSON. Useful to trading and portfolio agents as a research input; never executes trades.

## Output

A structured JSON object containing: thesis status (supported/unsupported/uncertain), verdict summary, confidence score, identified catalysts supporting the thesis, risks and red flags undermining it, conditions that would invalidate the thesis, monitoring triggers to watch, key unknowns, and prioritized next diligence steps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "context": {
   "type": "string",
   "description": "Optional factual context"
  },
  "horizon": {
   "enum": [
    "days",
    "weeks",
    "months",
    "years"
   ],
   "type": "string"
  },
  "subject": {
   "type": "string",
   "description": "Asset, company, protocol, or investment subject"
  },
  "campaign": {
   "type": "string",
   "description": "Optional non-secret campaign label"
  },
  "question": {
   "type": "string",
   "description": "Decision-oriented research question"
  },
  "client_tag": {
   "type": "string",
   "description": "Optional non-secret buyer attribution label"
  },
  "risk_tolerance": {
   "enum": [
    "low",
    "medium",
    "high"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-investment-research-f1138421/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from research.lumenhouse.xyz](https://www.zero.xyz/host/research.lumenhouse.xyz/llms.txt)