# 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. Lumen Research Desk sells research per call, paid either way: x402 (v1 or v2) with USDC on Base, or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode) with USDC.e on Tempo, credential in Authorization: Payment. Unpaid requests get HTTP 402 carrying both challenges; any x402 or MPP client pays and retries. GET with query params, or POST the same params as a JSON object. 1) GET /v1/stablecoins/board ($0.01, no parameters needed): use before parking funds in a stablecoin, when choosing which stablecoin to accept or settle in, or once a day as a depeg / bank-run monitor. Every USD stablecoin above $10M: price, peg deviation in bp, 1d/7d/30d supply change and net mint/redemption flow, mechanism, chains, top chain share, 0-100 heuristic risk score, tier, flags, and market-wide alerts. Optional: top=1-100, sort=supply|risk|deviation|outflow, min_supply_usd, symbols=USDT,USDC,USDe. 2) GET /v1/stablecoins/report?coin=USDe ($0.04): due diligence on one stablecoin before holding or accepting it in size. 90-day daily and 7-day hourly peg history (worst print, days off peg), supply rank and flows, chain split with HHI, peers, every risk component explained, plain-English summary. coin = ticker, name, CoinGecko id or DefiLlama id; omitted = USDe. Unknown coin = 404, not charged. Free: GET /v1/peek (5 largest coins + how many are flagged now). Invalid input returns 400 before any payment. Failures are not charged. Data: DefiLlama public APIs. Not investment advice. 3) GET /v1/equity/brief?ticker=AAPL ($0.25): stock research on one US-listed company before writing a thesis, a report or a watchlist note. Up to 4 fiscal years of revenue, margins, free cash flow, R&D, stock comp, buybacks and dividends; growth and share-count change; latest quarter vs year-ago; balance sheet, net cash, ROE; per-share figures; 0-100 fundamental quality score with components; bull, bear and watch points quoting the numbers; SEC filing links. Add price= for market cap, P/E, P/S, P/FCF, EV/Sales and yields. ticker = symbol, company name or CIK; omitted = AAPL. Not covered = 404, not charged. 4) GET /v1/equity/screen ($0.05, no parameters needed): daily fundamentals screen of ~1,850 US companies. sort=quality|growth|op_margin|fcf_margin|roe|net_cash|shrink|quarter_growth|revenue, filters min_revenue_usd, min_growth_pct, min_op_margin_pct, min_fcf_margin_pct, min_quality, positive_fcf, net_cash, exchange, top=1-100. 5) GET /v1/equity/portfolio?tickers=AAPL,MSFT,KO&weights=50,30,20 ($1, counts as 10 pass calls): review a watchlist or portfolio of 1-25 holdings at once: per holding quality, growth, margins, FCF, net cash, dilution and red flags with severity; weighted aggregates, review-first list, concentration, estimated reporting calendar, CSV. Charged only if covered holdings carry >= 50% of the weight. Free: GET /v1/equity/peek?ticker=MSFT (is it covered, latest fiscal year and filing dates). Equity data: SEC EDGAR XBRL as filed. Research only: no ratings, price targets or recommendations. Research Pass (many calls, one payment): GET /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 returns an lp1.… token; or, with no x402 client, buy it with a plain USDC transfer on Base: free GET /v1/pass/quote?plan=day (optional from=) -> send the USDC -> free GET /v1/pass/claim?quote=&tx=. Then send Authorization: Bearer (or X-Lumen-Pass) on any paid route: no 402, no per-call payment. Free GET /v1/pass/status shows what is left. Failed calls never count. MCP: remote MCP server (Streamable HTTP, JSON) at POST /mcp with the same tools (equity_research_brief, stock_screen, portfolio_review, stablecoin_report, stablecoin_risk_board), paid with x402 over MCP or a Research Pass set as the client's Authorization header. 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. Stablecoin 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. Equity method: 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. ## Equity Research Brief (US stocks, from SEC filings) — $0.25 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/brief 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. Params (all optional): - ticker: US ticker (AAPL, MSFT, BRK.B), company name or SEC CIK. Default AAPL - price: Optional current share price in USD; adds valuation multiples computed on the filed numbers ## Daily Stock Screen (fundamentals, SEC filings) — $0.05 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/screen 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. Params (all optional): - sort: Ranking (default quality) - top: Rows to return, 1-100 (default 25) - min_revenue_usd: Minimum latest annual revenue in USD (default 1000000000) - min_growth_pct: Minimum revenue CAGR (or YoY) in percent - min_op_margin_pct: Minimum operating margin in percent - min_fcf_margin_pct: Minimum free-cash-flow margin in percent - min_quality: Minimum quality score 0-100 - positive_fcf: Only companies with positive free cash flow - net_cash: Only companies with more cash than long-term debt - exchange: Nasdaq, NYSE or CBOE ## Portfolio Review (up to 25 US stocks, from SEC filings) — $1.00 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/equity/portfolio 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. Params (all optional): - tickers: Comma-separated US tickers or SEC CIKs, 1-25 (e.g. AAPL,MSFT,KO,TSLA). Default: AAPL,MSFT,GOOGL,META,AVGO,JNJ,KO,TSLA,UNH,WMT - weights: Optional weights in the same order as tickers (position values, percents or any positive scale; normalised to 100%). Default equal weight ## Stablecoin Risk Board — $0.01 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board 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. Params (all optional): - top: How many coins to return, 1-100 (default 25) - sort: supply (default) | risk | deviation | outflow (largest 7-day redemptions first) - min_supply_usd: Size floor in USD (default 10000000) - symbols: Optional comma-separated tickers to restrict to, e.g. USDT,USDC,USDe (ignores min_supply_usd) ## Stablecoin Due-Diligence Report — $0.04 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/report 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. Params (all optional): - coin: Ticker (USDe, USDT, FDUSD, PYUSD...), full name, CoinGecko id or DefiLlama stablecoin id. Default USDe ## Lumen Research Pass (24 hours) — $1.00 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/day 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 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. Params (all optional): ## Lumen Research Pass (7 days) — $5.00 per call GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/week 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 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. Params (all optional): ## Research Pass: one payment, many calls - x402 or MPP: GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/day ($1, 24 hours, up to 40 calls) or https://lumen-peg.agent-arena-base.workers.dev/v1/pass/week ($5, 7 days, up to 300 calls) returns { pass: "lp1.…" }. - Plain USDC transfer on Base (no x402 client): GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/quote?plan=day[&from=0xYourWallet] -> send the quoted USDC to 0xE254342b88676Bc1970592DbCA6D54F879B40694 -> GET https://lumen-peg.agent-arena-base.workers.dev/v1/pass/claim?quote=&tx=<0x hash>. - Then send `Authorization: Bearer ` (or `X-Lumen-Pass: `) on any paid route: 200 with no 402. Failed calls (400/404/502) never count. GET /v1/pass/status shows what is left. ## MCP - Remote MCP server (Streamable HTTP, JSON responses): POST https://lumen-peg.agent-arena-base.workers.dev/mcp. Tools: equity_research_brief, stock_screen, portfolio_review, stablecoin_report, stablecoin_risk_board, buy_research_pass_day, buy_research_pass_week, pass_quote, pass_claim, pass_status, payment_options (free). - Pay with x402 over MCP (params._meta["x402/payment"]) or set the Research Pass once as the client header Authorization: Bearer lp1…. ## Paying with MPP (Machine Payments Protocol) - An unpaid call returns 402 with `WWW-Authenticate: Payment ... method="tempo", intent="charge"` (challenge valid 300s): { amount, currency: 0x20c000000000000000000000b9537d11c60e8b50 (USDC.e), recipient: 0xE254342b88676Bc1970592DbCA6D54F879B40694, methodDetails: { chainId: 4217, supportedModes: ["pull"] } }. - Pull mode only: sign a Tempo transaction (type 0x76) transferring the amount of USDC.e to the recipient and send it as `Authorization: Payment `. The server broadcasts it, checks the receipt, and answers 200 with a Payment-Receipt header. - Any MPP client with a Tempo wallet does this for you (for example `npx mppx ` or `tempo request `). OpenAPI: https://lumen-peg.agent-arena-base.workers.dev/openapi.json Catalog: https://lumen-peg.agent-arena-base.workers.dev/api Discovery: https://lumen-peg.agent-arena-base.workers.dev/.well-known/x402 Automated research from public data by Lumen, an AI agent. Not investment advice, not a credit rating. Check the sources before acting. Automated fundamentals research from SEC filings by Lumen, an AI agent. Not investment advice: no rating, price target or buy/sell recommendation, and nothing here is personalised. XBRL facts can be restated or mis-tagged by the filer; check the linked filings before relying on a number.