Lumen Research Desk

Research desk for agents: a $0.25 sell-side style research brief on any of ~1,850 US-listed companies from SEC filings (4 years of financials, margins, free cash flow, balance sheet, quality score, bull/bear/watch points, optional valuation) a $0.05 daily fundamentals stock screen, and a $1 portfolio review of up to 25 holdings (weighted quality, red flags ranked by weight, concentration, reporting calendar, CSV); and a $0.01 risk board of every USD stablecoin (peg deviation, net mints and redemptions, mechanism, chain concentration, risk score, flags) and a $0.04 due-diligence report on any one coin with 90-day peg history. Pay with x402 (USDC on Base) or MPP (USDC.e on Tempo): no keys, no accounts. Many calls? A Research Pass ($1 for 24 hours, $5 for 7 days) covers every route, payable with x402 or a plain USDC transfer on Base. Also a remote MCP server at /mcp.

Equity Research Brief (US stocks, from SEC filings)

$0.25/call

Sell-side style one-company research brief for agents doing stock research: up to 4 fiscal years of revenue, gross/operating/net margin, free cash flow, R&D, stock comp, buybacks and dividends; growth (YoY, CAGR, margin change, share-count change); latest quarter vs year-ago; balance sheet (cash, debt, net cash, current ratio, ROE); per-share figures; a 0-100 fundamental quality score with every component; rule-based bull points, bear points and what to watch, each quoting the number behind it; links to the SEC filings. Optional price= adds market cap, P/E, P/S, P/FCF, EV/Sales, FCF and shareholder yield. Data: SEC EDGAR XBRL (10-K/10-Q). ticker = symbol, company name or CIK (default AAPL). Not covered = 404, not charged. No ratings or recommendations.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/brief

Daily Stock Screen (fundamentals, SEC filings)

$0.05/call

Fundamentals screen over about 1,850 US-listed companies (revenue >= $750M or assets >= $10B) from SEC XBRL filings. Each row: ticker, revenue, YoY and multi-year CAGR, latest-quarter growth, operating and FCF margin, ROE, net cash, share-count change, 0-100 quality score. sort = quality (default), growth, op_margin, fcf_margin, roe, net_cash, shrink (biggest buybacks), quarter_growth, revenue; filters min_revenue_usd (default 1e9), min_growth_pct, min_op_margin_pct, min_fcf_margin_pct, min_quality, positive_fcf, net_cash, exchange; top 1-100 (default 25). No params needed. Not investment advice.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/screen

Portfolio Review (up to 25 US stocks, from SEC filings)

$1.00/call

One-call fundamentals review of a watchlist or portfolio of up to 25 US-listed stocks (about 1,850 covered) from SEC XBRL filings: per holding the quality score, growth, margins, free cash flow, net cash, share-count change and rule-based red flags with severity; portfolio-weighted quality, growth and margins; share of weight in loss-makers, negative free cash flow, net debt, dilution; concentration (top 3, HHI, effective holdings); a review-first list ranked by weight x flag severity; strongest holdings; an estimated reporting calendar; CSV. tickers = comma list (default: a 10-stock example), weights = optional numbers in the same order (normalised). Charged only if covered holdings carry >= 50% of the weight (else 404, not charged). Research only, no ratings or recommendations.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/portfolio

Stablecoin Risk Board

$0.01/call

Risk screen of every USD stablecoin above $10M supply in one call: price and peg deviation (bp), 1d/7d/30d supply change and net mint/redemption flow (a run shows up as redemptions), peg mechanism, chain count and concentration, a transparent 0-100 heuristic risk score with tier, and flags (depegged, off_peg, heavy_redemptions_7d, redemptions_30d, rapid_growth_7d, small_supply, single_chain, algorithmic), plus market-wide alerts. No parameters needed. Use it before parking treasury funds, choosing a stablecoin to settle in, or as a daily depeg/run monitor. Data: DefiLlama. Not investment advice.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board

Stablecoin Due-Diligence Report

$0.04/call

Research report on one USD stablecoin, written for an agent deciding whether to hold, accept or settle in it: current price and peg deviation; 90-day daily and 7-day hourly peg history (worst print and date, days/hours 50bp and 100bp off peg, volatility in bp); supply now, rank and market share, 1d/7d/30d net mints or redemptions; chain split with concentration (HHI); peers with the same mechanism; a 0-100 heuristic risk score with every component explained; flags; and a plain-English analyst summary. coin = ticker, name, CoinGecko id or DefiLlama id (default USDe). Unknown coin = 404, not charged. Data: DefiLlama. Not investment advice.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/report

Lumen Research Pass (24 hours)

$1.00/call

Prepaid access for research sessions: one payment of $1 unlocks every paid Lumen route for 24 hours, up to 40 successful calls (equity research briefs list at $0.25 each, so the day pass costs $0.025 per call when used fully). Returns a bearer token: send Authorization: Bearer <pass> on /v1/equity/brief, /v1/equity/screen, /v1/stablecoins/report and /v1/stablecoins/board, or set it once as the HTTP header of the MCP server /mcp. No parameters. Failed calls (404, 400, upstream down) never count. Also sold for a plain USDC transfer on Base (free GET /v1/pass/quote). Research only, not investment advice.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/day

Lumen Research Pass (7 days)

$5.00/call

Prepaid access for research sessions: one payment of $5 unlocks every paid Lumen route for 7 days, up to 300 successful calls (equity research briefs list at $0.25 each, so the week pass costs $0.017 per call when used fully). Returns a bearer token: send Authorization: Bearer <pass> on /v1/equity/brief, /v1/equity/screen, /v1/stablecoins/report and /v1/stablecoins/board, or set it once as the HTTP header of the MCP server /mcp. No parameters. Failed calls (404, 400, upstream down) never count. Also sold for a plain USDC transfer on Base (free GET /v1/pass/quote). Research only, not investment advice.

GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/week

How to call

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const pay = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PRIVATE_KEY));
const board = await (await pay("https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board?sort=risk")).json();   // $0.01
const dd = await (await pay("https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/report?coin=USDe")).json();     // $0.04
console.log(dd.summary, dd.risk.score, dd.history.daily90d.worst);
const brief = await (await pay("https://lumen-peg.agent-arena-base.workers.dev/v1/equity/brief?ticker=MSFT&price=420")).json(); // $0.25
console.log(brief.summary, brief.thesis.bull, brief.thesis.bear, brief.valuation.pe);
const screen = await (await pay("https://lumen-peg.agent-arena-base.workers.dev/v1/equity/screen?sort=growth&positive_fcf=true")).json(); // $0.05
const book = await (await pay("https://lumen-peg.agent-arena-base.workers.dev/v1/equity/portfolio?tickers=AAPL,MSFT,KO,TSLA&weights=40,30,20,10")).json(); // $1
console.log(book.summary, book.reviewFirst, book.aggregates.concentration);

MPP: the same 402 also carries WWW-Authenticate: Payment with method="tempo", intent="charge" (USDC.e on Tempo, pull mode), for example npx mppx "https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board".

Research Pass

One payment, many calls: GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/day ($1, 24 hours, up to 40 calls) or /v1/pass/week ($5, 7 days, up to 300 calls) with x402 or MPP, or with a plain USDC transfer on Base (no x402 client): /v1/pass/quote → send → /v1/pass/claim?quote=&tx=. Then send Authorization: Bearer <pass> on any paid route.

MCP

Remote MCP server: POST https://lumen-peg.agent-arena-base.workers.dev/mcp (Streamable HTTP). Tools: equity_research_brief, stock_screen, portfolio_review, stablecoin_report, stablecoin_risk_board, pass_quote, pass_claim. Pay with x402 over MCP or set a Research Pass as the client header Authorization: Bearer lp1….

Free previews: /v1/peek · /v1/equity/peek?ticker=MSFT. See both payment challenges without paying: curl -i "https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board"

Method

Heuristic risk score 0-100 (higher = more risk signals), sum of capped components: mechanism: fiat-backed 8, crypto-backed 18, algorithmic 35, unknown 20; current peg deviation |price-1|: <10bp 0, <50bp 10, <100bp 20, <300bp 30, else 40 (no price: 15); 7-day supply change: >-2% 0, >-5% 5, >-10% 10, >-20% 15, else 20; 30-day supply change <= -25%: +10; size (supply): <$10M 15, <$100M 8, <$1B 3; report only, 90-day daily history: worst |deviation| <50bp 0, <100bp 5, <300bp 10, <1000bp 15, else 20; 7+ days >=100bp off peg: +10. Tiers: <25 low, <50 moderate, <75 elevated, else high. Supply = circulating tokens as reported by DefiLlama (nominal USD). This is a transparent screen of public data, not a credit rating and not investment advice.

Data: SEC EDGAR XBRL frames (us-gaap facts as filed in 10-K and 10-Q), snapshot built at deploy time (dataAsOf). Fiscal years are the company's own; up to 4 are shown. Free cash flow = operating cash flow - capex (PaymentsToAcquirePropertyPlantAndEquipment, else PaymentsToAcquireProductiveAssets); when the filer tags neither, capex and free cash flow are null (never assumed zero) and the FCF-based parts of the score are dropped. Quality score 0-100 = growth (revenue CAGR: >=15% 20, >=8% 15, >=3% 10, >=0% 5) + profitability (operating margin: >=25% 20, >=15% 15, >=8% 10, >0 5) + cash conversion (FCF margin: >=20% 20, >=10% 15, >=5% 10, >0 5) + balance sheet (net cash 20; net debt/FCF <=1 16, <=2 12, <=4 8, else 3; net debt with no FCF 0) + per-share discipline (diluted shares per year: <=-2% 10, <=0 8, <=2% 5, <=5% 2) + margin trend (operating margin vs prior year: >=+100bp 10, >=-100bp 6, else 2). Components without data are dropped and the score is rescaled to 100; tiers: >=75 high, >=55 good, >=35 mixed, else weak. Bull, bear and watch points are rules over the same numbers.

Payment policy

Input is validated before any payment is touched; failed work (data source down, unknown coin) is never settled or broadcast. x402 (Base): a result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base); if settlement cannot be confirmed you get HTTP 402 and no result. MPP (Tempo): the server broadcasts your signed USDC.e transfer itself and releases the result when the receipt shows it; if the Tempo RPC gives no definite answer the result is released anyway, marked unconfirmed, so you are never charged without getting it.

Machine-readable

/api · /openapi.json · /llms.txt · /.well-known/x402 · /health