{
  "service": "Lumen Research Desk",
  "version": "1.3.0",
  "payment": "x402 v1/v2 (USDC on Base) or MPP tempo charge (USDC.e on Tempo)",
  "paymentsEnabled": true,
  "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.",
  "guidance": "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.\n1) 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.\n2) 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.\nFree: 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.\n3) 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=<share 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.\n4) 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.\n5) 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.\nFree: 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.\nResearch 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=<your wallet>) -> send the USDC -> free GET /v1/pass/claim?quote=&tx=. Then send Authorization: Bearer <pass> (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.\nMCP: 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.",
  "methodology": "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.",
  "equityMethod": "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.",
  "equityData": {
    "ready": true,
    "dataAsOf": "2026-11-21T11:46:29.254Z",
    "companies": 1849,
    "source": "SEC EDGAR XBRL frames API (data.sec.gov/api/xbrl/frames, as filed in 10-K and 10-Q) + SEC company_tickers_exchange.json"
  },
  "endpoints": [
    {
      "name": "Equity Research Brief (US stocks, from SEC filings)",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/equity/brief",
      "method": "GET",
      "priceUsd": 0.25,
      "priceAtomic": "250000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "250000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {
        "ticker": {
          "type": "string",
          "required": false,
          "description": "US ticker (AAPL, MSFT, BRK.B), company name or SEC CIK. Default AAPL"
        },
        "price": {
          "type": "number",
          "required": false,
          "description": "Optional current share price in USD; adds valuation multiples computed on the filed numbers"
        }
      }
    },
    {
      "name": "Daily Stock Screen (fundamentals, SEC filings)",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/equity/screen",
      "method": "GET",
      "priceUsd": 0.05,
      "priceAtomic": "50000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "50000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {
        "sort": {
          "type": "string",
          "required": false,
          "description": "Ranking (default quality)",
          "enum": [
            "quality",
            "growth",
            "op_margin",
            "fcf_margin",
            "roe",
            "net_cash",
            "shrink",
            "quarter_growth",
            "revenue"
          ]
        },
        "top": {
          "type": "integer",
          "required": false,
          "description": "Rows to return, 1-100 (default 25)"
        },
        "min_revenue_usd": {
          "type": "number",
          "required": false,
          "description": "Minimum latest annual revenue in USD (default 1000000000)"
        },
        "min_growth_pct": {
          "type": "number",
          "required": false,
          "description": "Minimum revenue CAGR (or YoY) in percent"
        },
        "min_op_margin_pct": {
          "type": "number",
          "required": false,
          "description": "Minimum operating margin in percent"
        },
        "min_fcf_margin_pct": {
          "type": "number",
          "required": false,
          "description": "Minimum free-cash-flow margin in percent"
        },
        "min_quality": {
          "type": "number",
          "required": false,
          "description": "Minimum quality score 0-100"
        },
        "positive_fcf": {
          "type": "boolean",
          "required": false,
          "description": "Only companies with positive free cash flow"
        },
        "net_cash": {
          "type": "boolean",
          "required": false,
          "description": "Only companies with more cash than long-term debt"
        },
        "exchange": {
          "type": "string",
          "required": false,
          "description": "Nasdaq, NYSE or CBOE"
        }
      }
    },
    {
      "name": "Portfolio Review (up to 25 US stocks, from SEC filings)",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/equity/portfolio",
      "method": "GET",
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {
        "tickers": {
          "type": "string",
          "required": false,
          "description": "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": {
          "type": "string",
          "required": false,
          "description": "Optional weights in the same order as tickers (position values, percents or any positive scale; normalised to 100%). Default equal weight"
        }
      }
    },
    {
      "name": "Stablecoin Risk Board",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/board",
      "method": "GET",
      "priceUsd": 0.01,
      "priceAtomic": "10000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "10000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {
        "top": {
          "type": "integer",
          "required": false,
          "description": "How many coins to return, 1-100 (default 25)"
        },
        "sort": {
          "type": "string",
          "required": false,
          "description": "supply (default) | risk | deviation | outflow (largest 7-day redemptions first)",
          "enum": [
            "supply",
            "risk",
            "deviation",
            "outflow"
          ]
        },
        "min_supply_usd": {
          "type": "integer",
          "required": false,
          "description": "Size floor in USD (default 10000000)"
        },
        "symbols": {
          "type": "string",
          "required": false,
          "description": "Optional comma-separated tickers to restrict to, e.g. USDT,USDC,USDe (ignores min_supply_usd)"
        }
      }
    },
    {
      "name": "Stablecoin Due-Diligence Report",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/stablecoins/report",
      "method": "GET",
      "priceUsd": 0.04,
      "priceAtomic": "40000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "40000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {
        "coin": {
          "type": "string",
          "required": false,
          "description": "Ticker (USDe, USDT, FDUSD, PYUSD...), full name, CoinGecko id or DefiLlama stablecoin id. Default USDe"
        }
      }
    },
    {
      "name": "Lumen Research Pass (24 hours)",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/pass/day",
      "method": "GET",
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {}
    },
    {
      "name": "Lumen Research Pass (7 days)",
      "author": "Lumen",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/v1/pass/week",
      "method": "GET",
      "priceUsd": 5,
      "priceAtomic": "5000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694",
      "description": "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "5000000",
        "recipient": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
      },
      "params": {}
    }
  ]
}