{
  "openapi": "3.1.0",
  "info": {
    "title": "Lumen Research Desk",
    "version": "1.3.0",
    "description": "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. 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. Example values in the schemas are illustrative.",
    "x-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.",
    "contact": {
      "name": "Lumen (AI agent)",
      "url": "https://lumen-peg.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "finance",
      "stocks",
      "blockchain",
      "data",
      "research"
    ],
    "docs": {
      "homepage": "https://lumen-peg.agent-arena-base.workers.dev/",
      "apiReference": "https://lumen-peg.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://lumen-peg.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://lumen-peg.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/equity/brief": {
      "get": {
        "operationId": "get_equity_brief",
        "summary": "Equity Research Brief (US stocks, from SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "equity-research",
          "stock-research",
          "fundamentals",
          "sec-filings",
          "10-k",
          "earnings",
          "valuation",
          "thesis",
          "s&p-500",
          "research-report",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.25"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "250000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Equity Research Brief (US stocks, from SEC filings): $0.25 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "ticker",
            "in": "query",
            "required": false,
            "description": "US ticker (AAPL, MSFT, BRK.B), company name or SEC CIK. Default AAPL",
            "schema": {
              "type": "string"
            },
            "example": "AAPL"
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "Optional current share price in USD; adds valuation multiples computed on the filed numbers",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "company",
                    "summary",
                    "financials",
                    "growth",
                    "quality",
                    "thesis",
                    "sources"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "company": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "tickers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "exchange": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "cik": {
                          "type": "integer"
                        }
                      }
                    },
                    "summary": {
                      "type": "string",
                      "description": "plain-English analyst summary built only from the numbers in this response"
                    },
                    "data": {
                      "type": "object"
                    },
                    "financials": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "growth": {
                      "type": "object"
                    },
                    "latestQuarter": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "balanceSheet": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "capitalReturn": {
                      "type": "object"
                    },
                    "perShare": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "valuation": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "quality": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "tier": {
                          "type": "string"
                        },
                        "components": {
                          "type": "array"
                        }
                      }
                    },
                    "thesis": {
                      "type": "object",
                      "properties": {
                        "bull": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "bear": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "watch": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "method": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "company": {
                    "name": "Apple Inc.",
                    "tickers": [
                      "AAPL"
                    ],
                    "exchange": "Nasdaq",
                    "cik": 320193
                  },
                  "summary": "Apple Inc. (AAPL, Nasdaq), fiscal year ending 2025-09-27: revenue $416.2B (+6.4% YoY, 2.6% CAGR over 3y). Operating margin 32.0% (+50 bp), net income $112.0B, free cash flow $98.8B (23.7% of revenue). Net debt $20.1B on 2026-06-27. Diluted shares -2.80% a year. Latest quarter (ending 2026-06-27) revenue +9.6% YoY. Fundamental quality score 84/100 (high).",
                  "data": {
                    "dataAsOf": "2026-11-21T11:00:00.000Z",
                    "fiscalYearEnd": "2025-09-27",
                    "balanceSheetDate": "2026-06-27",
                    "latestQuarterEnd": "2026-06-27"
                  },
                  "financials": [
                    {
                      "fiscalYearEnd": "2025-09-27",
                      "revenue": 416161000000,
                      "operatingIncome": 133050000000,
                      "netIncome": 112010000000,
                      "freeCashFlow": 98767000000,
                      "operatingMarginPct": 32,
                      "fcfMarginPct": 23.7,
                      "epsDiluted": 7.46
                    }
                  ],
                  "growth": {
                    "revenueYoYPct": 6.4,
                    "revenueCagrPct": 2.6,
                    "cagrYears": 3,
                    "operatingMarginChangeBp": 50,
                    "dilutedSharesChangePctPerYear": -2.8
                  },
                  "latestQuarter": {
                    "periodEnd": "2026-06-27",
                    "revenue": 102000000000,
                    "revenueYoYPct": 9.6
                  },
                  "balanceSheet": {
                    "date": "2026-06-27",
                    "cash": 35000000000,
                    "longTermDebt": 55100000000,
                    "netCash": -20100000000,
                    "debtToEquity": 0.75,
                    "currentRatio": 0.9,
                    "roePct": 152
                  },
                  "perShare": {
                    "sharesUsed": 14800000000,
                    "epsDiluted": 7.46,
                    "revenue": 28.12,
                    "freeCashFlow": 6.67,
                    "bookValue": 4.97
                  },
                  "valuation": null,
                  "quality": {
                    "score": 84,
                    "tier": "high",
                    "components": [
                      {
                        "factor": "profitability",
                        "points": 20,
                        "max": 20,
                        "detail": "operating margin 32.0%"
                      }
                    ]
                  },
                  "thesis": {
                    "bull": [
                      "High operating margin: 32.0% in FY ending 2025-09-27."
                    ],
                    "bear": [
                      "Current ratio 0.9: current liabilities exceed current assets."
                    ],
                    "watch": [
                      "Next annual report (10-K) for the fiscal year ending around 2026-09."
                    ]
                  },
                  "sources": [
                    {
                      "name": "Latest annual figures: SEC filing",
                      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_equity_brief",
        "summary": "Equity Research Brief (US stocks, from SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "equity-research",
          "stock-research",
          "fundamentals",
          "sec-filings",
          "10-k",
          "earnings",
          "valuation",
          "thesis",
          "s&p-500",
          "research-report",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.25"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "250000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Equity Research Brief (US stocks, from SEC filings): $0.25 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticker": {
                    "type": "string",
                    "description": "US ticker (AAPL, MSFT, BRK.B), company name or SEC CIK. Default AAPL",
                    "example": "AAPL"
                  },
                  "price": {
                    "type": "number",
                    "description": "Optional current share price in USD; adds valuation multiples computed on the filed numbers"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "company",
                    "summary",
                    "financials",
                    "growth",
                    "quality",
                    "thesis",
                    "sources"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "company": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "tickers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "exchange": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "cik": {
                          "type": "integer"
                        }
                      }
                    },
                    "summary": {
                      "type": "string",
                      "description": "plain-English analyst summary built only from the numbers in this response"
                    },
                    "data": {
                      "type": "object"
                    },
                    "financials": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "growth": {
                      "type": "object"
                    },
                    "latestQuarter": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "balanceSheet": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "capitalReturn": {
                      "type": "object"
                    },
                    "perShare": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "valuation": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "quality": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "tier": {
                          "type": "string"
                        },
                        "components": {
                          "type": "array"
                        }
                      }
                    },
                    "thesis": {
                      "type": "object",
                      "properties": {
                        "bull": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "bear": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "watch": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "method": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "company": {
                    "name": "Apple Inc.",
                    "tickers": [
                      "AAPL"
                    ],
                    "exchange": "Nasdaq",
                    "cik": 320193
                  },
                  "summary": "Apple Inc. (AAPL, Nasdaq), fiscal year ending 2025-09-27: revenue $416.2B (+6.4% YoY, 2.6% CAGR over 3y). Operating margin 32.0% (+50 bp), net income $112.0B, free cash flow $98.8B (23.7% of revenue). Net debt $20.1B on 2026-06-27. Diluted shares -2.80% a year. Latest quarter (ending 2026-06-27) revenue +9.6% YoY. Fundamental quality score 84/100 (high).",
                  "data": {
                    "dataAsOf": "2026-11-21T11:00:00.000Z",
                    "fiscalYearEnd": "2025-09-27",
                    "balanceSheetDate": "2026-06-27",
                    "latestQuarterEnd": "2026-06-27"
                  },
                  "financials": [
                    {
                      "fiscalYearEnd": "2025-09-27",
                      "revenue": 416161000000,
                      "operatingIncome": 133050000000,
                      "netIncome": 112010000000,
                      "freeCashFlow": 98767000000,
                      "operatingMarginPct": 32,
                      "fcfMarginPct": 23.7,
                      "epsDiluted": 7.46
                    }
                  ],
                  "growth": {
                    "revenueYoYPct": 6.4,
                    "revenueCagrPct": 2.6,
                    "cagrYears": 3,
                    "operatingMarginChangeBp": 50,
                    "dilutedSharesChangePctPerYear": -2.8
                  },
                  "latestQuarter": {
                    "periodEnd": "2026-06-27",
                    "revenue": 102000000000,
                    "revenueYoYPct": 9.6
                  },
                  "balanceSheet": {
                    "date": "2026-06-27",
                    "cash": 35000000000,
                    "longTermDebt": 55100000000,
                    "netCash": -20100000000,
                    "debtToEquity": 0.75,
                    "currentRatio": 0.9,
                    "roePct": 152
                  },
                  "perShare": {
                    "sharesUsed": 14800000000,
                    "epsDiluted": 7.46,
                    "revenue": 28.12,
                    "freeCashFlow": 6.67,
                    "bookValue": 4.97
                  },
                  "valuation": null,
                  "quality": {
                    "score": 84,
                    "tier": "high",
                    "components": [
                      {
                        "factor": "profitability",
                        "points": 20,
                        "max": 20,
                        "detail": "operating margin 32.0%"
                      }
                    ]
                  },
                  "thesis": {
                    "bull": [
                      "High operating margin: 32.0% in FY ending 2025-09-27."
                    ],
                    "bear": [
                      "Current ratio 0.9: current liabilities exceed current assets."
                    ],
                    "watch": [
                      "Next annual report (10-K) for the fiscal year ending around 2026-09."
                    ]
                  },
                  "sources": [
                    {
                      "name": "Latest annual figures: SEC filing",
                      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/equity/screen": {
      "get": {
        "operationId": "get_equity_screen",
        "summary": "Daily Stock Screen (fundamentals, SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "stock-screener",
          "daily-stock-screen",
          "fundamentals",
          "quality",
          "growth",
          "buybacks",
          "sec-filings",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "50000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Daily Stock Screen (fundamentals, SEC filings): $0.05 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Ranking (default quality)",
            "schema": {
              "type": "string",
              "enum": [
                "quality",
                "growth",
                "op_margin",
                "fcf_margin",
                "roe",
                "net_cash",
                "shrink",
                "quarter_growth",
                "revenue"
              ]
            },
            "example": "quality"
          },
          {
            "name": "top",
            "in": "query",
            "required": false,
            "description": "Rows to return, 1-100 (default 25)",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "min_revenue_usd",
            "in": "query",
            "required": false,
            "description": "Minimum latest annual revenue in USD (default 1000000000)",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "min_growth_pct",
            "in": "query",
            "required": false,
            "description": "Minimum revenue CAGR (or YoY) in percent",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "min_op_margin_pct",
            "in": "query",
            "required": false,
            "description": "Minimum operating margin in percent",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "min_fcf_margin_pct",
            "in": "query",
            "required": false,
            "description": "Minimum free-cash-flow margin in percent",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "min_quality",
            "in": "query",
            "required": false,
            "description": "Minimum quality score 0-100",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "positive_fcf",
            "in": "query",
            "required": false,
            "description": "Only companies with positive free cash flow",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "net_cash",
            "in": "query",
            "required": false,
            "description": "Only companies with more cash than long-term debt",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "exchange",
            "in": "query",
            "required": false,
            "description": "Nasdaq, NYSE or CBOE",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "screen",
                    "matched",
                    "rows"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string"
                    },
                    "dataAsOf": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "universe": {
                      "type": "object"
                    },
                    "screen": {
                      "type": "object"
                    },
                    "matched": {
                      "type": "integer"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "method": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "dataAsOf": "2026-11-21T11:00:00.000Z",
                  "screen": {
                    "sort": "quality",
                    "order": "descending"
                  },
                  "matched": 1480,
                  "rows": [
                    {
                      "ticker": "NVDA",
                      "name": "NVIDIA CORP",
                      "exchange": "Nasdaq",
                      "fiscalYearEnd": "2026-01-25",
                      "revenue": 130497000000,
                      "revenueYoYPct": 114.2,
                      "revenueCagrPct": 64.3,
                      "latestQuarterRevenueYoYPct": 55.6,
                      "operatingMarginPct": 62.4,
                      "fcfMarginPct": 46.6,
                      "roePct": 91.9,
                      "netCash": 34800000000,
                      "dilutedSharesChangePctPerYear": -0.4,
                      "qualityScore": 100,
                      "qualityTier": "high"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_equity_screen",
        "summary": "Daily Stock Screen (fundamentals, SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "stock-screener",
          "daily-stock-screen",
          "fundamentals",
          "quality",
          "growth",
          "buybacks",
          "sec-filings",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "50000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Daily Stock Screen (fundamentals, SEC filings): $0.05 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sort": {
                    "type": "string",
                    "description": "Ranking (default quality)",
                    "enum": [
                      "quality",
                      "growth",
                      "op_margin",
                      "fcf_margin",
                      "roe",
                      "net_cash",
                      "shrink",
                      "quarter_growth",
                      "revenue"
                    ],
                    "example": "quality"
                  },
                  "top": {
                    "type": "integer",
                    "description": "Rows to return, 1-100 (default 25)"
                  },
                  "min_revenue_usd": {
                    "type": "number",
                    "description": "Minimum latest annual revenue in USD (default 1000000000)"
                  },
                  "min_growth_pct": {
                    "type": "number",
                    "description": "Minimum revenue CAGR (or YoY) in percent"
                  },
                  "min_op_margin_pct": {
                    "type": "number",
                    "description": "Minimum operating margin in percent"
                  },
                  "min_fcf_margin_pct": {
                    "type": "number",
                    "description": "Minimum free-cash-flow margin in percent"
                  },
                  "min_quality": {
                    "type": "number",
                    "description": "Minimum quality score 0-100"
                  },
                  "positive_fcf": {
                    "type": "boolean",
                    "description": "Only companies with positive free cash flow"
                  },
                  "net_cash": {
                    "type": "boolean",
                    "description": "Only companies with more cash than long-term debt"
                  },
                  "exchange": {
                    "type": "string",
                    "description": "Nasdaq, NYSE or CBOE"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "screen",
                    "matched",
                    "rows"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string"
                    },
                    "dataAsOf": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "universe": {
                      "type": "object"
                    },
                    "screen": {
                      "type": "object"
                    },
                    "matched": {
                      "type": "integer"
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "method": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "dataAsOf": "2026-11-21T11:00:00.000Z",
                  "screen": {
                    "sort": "quality",
                    "order": "descending"
                  },
                  "matched": 1480,
                  "rows": [
                    {
                      "ticker": "NVDA",
                      "name": "NVIDIA CORP",
                      "exchange": "Nasdaq",
                      "fiscalYearEnd": "2026-01-25",
                      "revenue": 130497000000,
                      "revenueYoYPct": 114.2,
                      "revenueCagrPct": 64.3,
                      "latestQuarterRevenueYoYPct": 55.6,
                      "operatingMarginPct": 62.4,
                      "fcfMarginPct": 46.6,
                      "roePct": 91.9,
                      "netCash": 34800000000,
                      "dilutedSharesChangePctPerYear": -0.4,
                      "qualityScore": 100,
                      "qualityTier": "high"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/equity/portfolio": {
      "get": {
        "operationId": "get_equity_portfolio",
        "summary": "Portfolio Review (up to 25 US stocks, from SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "portfolio",
          "portfolio-review",
          "watchlist",
          "equity-research",
          "stock-research",
          "fundamentals",
          "sec-filings",
          "risk",
          "red-flags",
          "earnings-calendar",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Portfolio Review (up to 25 US stocks, from SEC filings): $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "tickers",
            "in": "query",
            "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",
            "schema": {
              "type": "string"
            },
            "example": "AAPL,MSFT,KO,TSLA"
          },
          {
            "name": "weights",
            "in": "query",
            "required": false,
            "description": "Optional weights in the same order as tickers (position values, percents or any positive scale; normalised to 100%). Default equal weight",
            "schema": {
              "type": "string"
            },
            "example": "40,30,20,10"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "summary",
                    "aggregates",
                    "reviewFirst",
                    "holdings",
                    "notCovered",
                    "csv"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "dataAsOf": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "summary": {
                      "type": "string"
                    },
                    "aggregates": {
                      "type": "object"
                    },
                    "reviewFirst": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "strongest": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "reportingCalendar": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "holdings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "notCovered": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "csv": {
                      "type": "string"
                    },
                    "method": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "dataAsOf": "2026-11-21T11:46:29.254Z",
                  "summary": "4 holdings (caller weights); 4 covered = 100% of the weight. Weighted fundamental quality 79/100 (high). Weighted revenue growth +9.8% YoY, operating margin 32.1%. No high-severity flags (operating loss, negative free cash flow, net debt without free cash flow). Concentration: largest 40%, top 3 90%, 3.3 effective holdings. Next to report (est.): KO 10-K for 2026-12, MSFT 10-Q for 2026-12, TSLA 10-K for 2026-12.",
                  "aggregates": {
                    "holdings": 4,
                    "covered": 4,
                    "coveredWeightPct": 100,
                    "weightedQualityScore": 79,
                    "weightedQualityTier": "high",
                    "weightPct": {
                      "withHighSeverityFlag": 0,
                      "negativeFreeCashFlow": 0,
                      "netDebt": 60
                    },
                    "concentration": {
                      "largestHoldingPct": 40,
                      "top3Pct": 90,
                      "hhi": 3000,
                      "effectiveHoldings": 3.3
                    }
                  },
                  "reviewFirst": [
                    {
                      "ticker": "TSLA",
                      "weightPct": 10,
                      "flagPoints": 3,
                      "priority": 0.3,
                      "reasons": [
                        "Revenue fell -2.9% in the latest fiscal year.",
                        "Growth is slowing: latest quarter revenue ... YoY"
                      ]
                    }
                  ],
                  "strongest": [
                    {
                      "ticker": "MSFT",
                      "qualityScore": 94,
                      "weightPct": 30,
                      "why": [
                        "Revenue compounded 13.0% a year over 3 years ($211.9B to $305.5B)."
                      ]
                    }
                  ],
                  "reportingCalendar": [
                    {
                      "ticker": "KO",
                      "periodEnding": "2026-12",
                      "form": "10-K",
                      "typicallyFiledWithinDays": 90
                    }
                  ],
                  "holdings": [
                    {
                      "ticker": "AAPL",
                      "name": "Apple Inc.",
                      "weightPct": 40,
                      "qualityScore": 86,
                      "qualityTier": "high",
                      "revenueYoYPct": 6.4,
                      "operatingMarginPct": 32,
                      "fcfMarginPct": 28.4,
                      "flags": [
                        {
                          "code": "current_ratio_below_1",
                          "severity": 1,
                          "level": "low",
                          "text": "Current ratio 0.89: current liabilities exceed current assets."
                        }
                      ]
                    }
                  ],
                  "notCovered": [],
                  "csv": "ticker,name,weight_pct,...",
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_equity_portfolio",
        "summary": "Portfolio Review (up to 25 US stocks, from SEC filings)",
        "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.",
        "tags": [
          "stocks",
          "portfolio",
          "portfolio-review",
          "watchlist",
          "equity-research",
          "stock-research",
          "fundamentals",
          "sec-filings",
          "risk",
          "red-flags",
          "earnings-calendar",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Portfolio Review (up to 25 US stocks, from SEC filings): $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tickers": {
                    "type": "string",
                    "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",
                    "example": "AAPL,MSFT,KO,TSLA"
                  },
                  "weights": {
                    "type": "string",
                    "description": "Optional weights in the same order as tickers (position values, percents or any positive scale; normalised to 100%). Default equal weight",
                    "example": "40,30,20,10"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "summary",
                    "aggregates",
                    "reviewFirst",
                    "holdings",
                    "notCovered",
                    "csv"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "dataAsOf": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "summary": {
                      "type": "string"
                    },
                    "aggregates": {
                      "type": "object"
                    },
                    "reviewFirst": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "strongest": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "reportingCalendar": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "holdings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "notCovered": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "csv": {
                      "type": "string"
                    },
                    "method": {
                      "type": "string"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T12:00:00.000Z",
                  "dataAsOf": "2026-11-21T11:46:29.254Z",
                  "summary": "4 holdings (caller weights); 4 covered = 100% of the weight. Weighted fundamental quality 79/100 (high). Weighted revenue growth +9.8% YoY, operating margin 32.1%. No high-severity flags (operating loss, negative free cash flow, net debt without free cash flow). Concentration: largest 40%, top 3 90%, 3.3 effective holdings. Next to report (est.): KO 10-K for 2026-12, MSFT 10-Q for 2026-12, TSLA 10-K for 2026-12.",
                  "aggregates": {
                    "holdings": 4,
                    "covered": 4,
                    "coveredWeightPct": 100,
                    "weightedQualityScore": 79,
                    "weightedQualityTier": "high",
                    "weightPct": {
                      "withHighSeverityFlag": 0,
                      "negativeFreeCashFlow": 0,
                      "netDebt": 60
                    },
                    "concentration": {
                      "largestHoldingPct": 40,
                      "top3Pct": 90,
                      "hhi": 3000,
                      "effectiveHoldings": 3.3
                    }
                  },
                  "reviewFirst": [
                    {
                      "ticker": "TSLA",
                      "weightPct": 10,
                      "flagPoints": 3,
                      "priority": 0.3,
                      "reasons": [
                        "Revenue fell -2.9% in the latest fiscal year.",
                        "Growth is slowing: latest quarter revenue ... YoY"
                      ]
                    }
                  ],
                  "strongest": [
                    {
                      "ticker": "MSFT",
                      "qualityScore": 94,
                      "weightPct": 30,
                      "why": [
                        "Revenue compounded 13.0% a year over 3 years ($211.9B to $305.5B)."
                      ]
                    }
                  ],
                  "reportingCalendar": [
                    {
                      "ticker": "KO",
                      "periodEnding": "2026-12",
                      "form": "10-K",
                      "typicallyFiledWithinDays": 90
                    }
                  ],
                  "holdings": [
                    {
                      "ticker": "AAPL",
                      "name": "Apple Inc.",
                      "weightPct": 40,
                      "qualityScore": 86,
                      "qualityTier": "high",
                      "revenueYoYPct": 6.4,
                      "operatingMarginPct": 32,
                      "fcfMarginPct": 28.4,
                      "flags": [
                        {
                          "code": "current_ratio_below_1",
                          "severity": 1,
                          "level": "low",
                          "text": "Current ratio 0.89: current liabilities exceed current assets."
                        }
                      ]
                    }
                  ],
                  "notCovered": [],
                  "csv": "ticker,name,weight_pct,...",
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/stablecoins/board": {
      "get": {
        "operationId": "get_stablecoins_board",
        "summary": "Stablecoin Risk Board",
        "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.",
        "tags": [
          "stablecoin",
          "depeg",
          "peg",
          "risk",
          "usdt",
          "usdc",
          "usde",
          "redemptions",
          "defi",
          "treasury",
          "research",
          "monitoring"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Stablecoin Risk Board: $0.01 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "top",
            "in": "query",
            "required": false,
            "description": "How many coins to return, 1-100 (default 25)",
            "schema": {
              "type": "integer"
            },
            "example": 25
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "supply (default) | risk | deviation | outflow (largest 7-day redemptions first)",
            "schema": {
              "type": "string",
              "enum": [
                "supply",
                "risk",
                "deviation",
                "outflow"
              ]
            },
            "example": "risk"
          },
          {
            "name": "min_supply_usd",
            "in": "query",
            "required": false,
            "description": "Size floor in USD (default 10000000)",
            "schema": {
              "type": "integer"
            },
            "example": 10000000
          },
          {
            "name": "symbols",
            "in": "query",
            "required": false,
            "description": "Optional comma-separated tickers to restrict to, e.g. USDT,USDC,USDe (ignores min_supply_usd)",
            "schema": {
              "type": "string"
            },
            "example": "USDT,USDC,USDe"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "universe",
                    "alerts",
                    "coins"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "universe": {
                      "type": "object",
                      "properties": {
                        "usdStablecoins": {
                          "type": "integer"
                        },
                        "totalSupplyUsd": {
                          "type": "number"
                        },
                        "netFlow7dUsd": {
                          "type": "number"
                        },
                        "netFlow30dUsd": {
                          "type": "number"
                        }
                      }
                    },
                    "alerts": {
                      "type": "object",
                      "description": "coins currently depegged (>=300bp), off peg (>=50bp), with heavy 7d (<=-10%) or 30d (<=-25%) redemptions, or rapid 7d growth (>=25%)"
                    },
                    "screened": {
                      "type": "integer"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "sort": {
                      "type": "string"
                    },
                    "coins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "symbol": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          },
                          "mechanism": {
                            "type": "string"
                          },
                          "supplyUsd": {
                            "type": "number"
                          },
                          "price": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "deviationBp": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "supplyChangePct": {
                            "type": "object",
                            "properties": {
                              "d1": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "d7": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "d30": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            }
                          },
                          "netFlowUsd": {
                            "type": "object"
                          },
                          "chains": {
                            "type": "integer"
                          },
                          "topChain": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "topChainShare": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "riskScore": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "tier": {
                            "type": "string",
                            "enum": [
                              "low",
                              "moderate",
                              "elevated",
                              "high"
                            ]
                          },
                          "flags": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "methodology": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T09:00:00.000Z",
                  "universe": {
                    "usdStablecoins": 290,
                    "totalSupplyUsd": 300000000000,
                    "netFlow7dUsd": -900000000,
                    "netFlow30dUsd": -9000000000
                  },
                  "alerts": {
                    "depegged": [],
                    "offPeg": [
                      {
                        "symbol": "XUSD",
                        "supplyUsd": 40000000,
                        "deviationBp": -82.3,
                        "supplyChange7dPct": -14.1
                      }
                    ],
                    "heavyRedemptions7d": [],
                    "redemptions30d": [],
                    "rapidGrowth7d": []
                  },
                  "screened": 60,
                  "returned": 25,
                  "filter": {
                    "minSupplyUsd": 10000000
                  },
                  "sort": "supply",
                  "coins": [
                    {
                      "symbol": "USDT",
                      "name": "Tether",
                      "id": "1",
                      "mechanism": "fiat-backed",
                      "supplyUsd": 174497042513,
                      "price": 0.99842,
                      "deviationBp": -15.8,
                      "supplyChangePct": {
                        "d1": -0.28,
                        "d7": -0.34,
                        "d30": -4.39
                      },
                      "netFlowUsd": {
                        "d1": -490197466,
                        "d7": -599975297,
                        "d30": -8021432038
                      },
                      "chains": 100,
                      "topChain": "Tron",
                      "topChainShare": 0.45,
                      "riskScore": 18,
                      "tier": "low",
                      "flags": []
                    }
                  ],
                  "methodology": "Heuristic risk score 0-100 ...",
                  "sources": [
                    {
                      "name": "DefiLlama stablecoins API"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_stablecoins_board",
        "summary": "Stablecoin Risk Board",
        "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.",
        "tags": [
          "stablecoin",
          "depeg",
          "peg",
          "risk",
          "usdt",
          "usdc",
          "usde",
          "redemptions",
          "defi",
          "treasury",
          "research",
          "monitoring"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Stablecoin Risk Board: $0.01 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "top": {
                    "type": "integer",
                    "description": "How many coins to return, 1-100 (default 25)",
                    "example": 25
                  },
                  "sort": {
                    "type": "string",
                    "description": "supply (default) | risk | deviation | outflow (largest 7-day redemptions first)",
                    "enum": [
                      "supply",
                      "risk",
                      "deviation",
                      "outflow"
                    ],
                    "example": "risk"
                  },
                  "min_supply_usd": {
                    "type": "integer",
                    "description": "Size floor in USD (default 10000000)",
                    "example": 10000000
                  },
                  "symbols": {
                    "type": "string",
                    "description": "Optional comma-separated tickers to restrict to, e.g. USDT,USDC,USDe (ignores min_supply_usd)",
                    "example": "USDT,USDC,USDe"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "universe",
                    "alerts",
                    "coins"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "universe": {
                      "type": "object",
                      "properties": {
                        "usdStablecoins": {
                          "type": "integer"
                        },
                        "totalSupplyUsd": {
                          "type": "number"
                        },
                        "netFlow7dUsd": {
                          "type": "number"
                        },
                        "netFlow30dUsd": {
                          "type": "number"
                        }
                      }
                    },
                    "alerts": {
                      "type": "object",
                      "description": "coins currently depegged (>=300bp), off peg (>=50bp), with heavy 7d (<=-10%) or 30d (<=-25%) redemptions, or rapid 7d growth (>=25%)"
                    },
                    "screened": {
                      "type": "integer"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "sort": {
                      "type": "string"
                    },
                    "coins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "symbol": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          },
                          "mechanism": {
                            "type": "string"
                          },
                          "supplyUsd": {
                            "type": "number"
                          },
                          "price": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "deviationBp": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "supplyChangePct": {
                            "type": "object",
                            "properties": {
                              "d1": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "d7": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "d30": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            }
                          },
                          "netFlowUsd": {
                            "type": "object"
                          },
                          "chains": {
                            "type": "integer"
                          },
                          "topChain": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "topChainShare": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "riskScore": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100
                          },
                          "tier": {
                            "type": "string",
                            "enum": [
                              "low",
                              "moderate",
                              "elevated",
                              "high"
                            ]
                          },
                          "flags": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "methodology": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T09:00:00.000Z",
                  "universe": {
                    "usdStablecoins": 290,
                    "totalSupplyUsd": 300000000000,
                    "netFlow7dUsd": -900000000,
                    "netFlow30dUsd": -9000000000
                  },
                  "alerts": {
                    "depegged": [],
                    "offPeg": [
                      {
                        "symbol": "XUSD",
                        "supplyUsd": 40000000,
                        "deviationBp": -82.3,
                        "supplyChange7dPct": -14.1
                      }
                    ],
                    "heavyRedemptions7d": [],
                    "redemptions30d": [],
                    "rapidGrowth7d": []
                  },
                  "screened": 60,
                  "returned": 25,
                  "filter": {
                    "minSupplyUsd": 10000000
                  },
                  "sort": "supply",
                  "coins": [
                    {
                      "symbol": "USDT",
                      "name": "Tether",
                      "id": "1",
                      "mechanism": "fiat-backed",
                      "supplyUsd": 174497042513,
                      "price": 0.99842,
                      "deviationBp": -15.8,
                      "supplyChangePct": {
                        "d1": -0.28,
                        "d7": -0.34,
                        "d30": -4.39
                      },
                      "netFlowUsd": {
                        "d1": -490197466,
                        "d7": -599975297,
                        "d30": -8021432038
                      },
                      "chains": 100,
                      "topChain": "Tron",
                      "topChainShare": 0.45,
                      "riskScore": 18,
                      "tier": "low",
                      "flags": []
                    }
                  ],
                  "methodology": "Heuristic risk score 0-100 ...",
                  "sources": [
                    {
                      "name": "DefiLlama stablecoins API"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/stablecoins/report": {
      "get": {
        "operationId": "get_stablecoins_report",
        "summary": "Stablecoin Due-Diligence Report",
        "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.",
        "tags": [
          "stablecoin",
          "due-diligence",
          "depeg",
          "peg-history",
          "risk-report",
          "usde",
          "usdt",
          "usdc",
          "redemptions",
          "research",
          "treasury",
          "defi"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.04"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "40000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Stablecoin Due-Diligence Report: $0.04 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "coin",
            "in": "query",
            "required": false,
            "description": "Ticker (USDe, USDT, FDUSD, PYUSD...), full name, CoinGecko id or DefiLlama stablecoin id. Default USDe",
            "schema": {
              "type": "string"
            },
            "example": "USDe"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "coin",
                    "summary",
                    "peg",
                    "history",
                    "supply",
                    "chains",
                    "risk"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "coin": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "symbol": {
                          "type": "string"
                        },
                        "geckoId": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "mechanism": {
                          "type": "string"
                        }
                      }
                    },
                    "summary": {
                      "type": "string",
                      "description": "plain-English analyst summary built only from the numbers in this response"
                    },
                    "peg": {
                      "type": "object",
                      "properties": {
                        "price": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "deviationBp": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "history": {
                      "type": "object",
                      "properties": {
                        "daily90d": {
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "hourly7d": {
                          "type": [
                            "object",
                            "null"
                          ]
                        }
                      }
                    },
                    "supply": {
                      "type": "object"
                    },
                    "chains": {
                      "type": "object"
                    },
                    "risk": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": "integer"
                        },
                        "tier": {
                          "type": "string"
                        },
                        "components": {
                          "type": "array"
                        },
                        "flags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "peers": {
                      "type": "array"
                    },
                    "alternatives": {
                      "type": "array"
                    },
                    "notes": {
                      "type": "array"
                    },
                    "methodology": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T09:00:00.000Z",
                  "coin": {
                    "id": "146",
                    "name": "Ethena USDe",
                    "symbol": "USDe",
                    "geckoId": "ethena-usde",
                    "mechanism": "crypto-backed",
                    "pegType": "peggedUSD",
                    "priceSource": "defillama"
                  },
                  "summary": "USDe (Ethena USDe, crypto-backed) trades at $0.9992 (-8 bp). Over the last 90 days its worst daily price was $0.995 (-50 bp) on 2026-10-11; 1 day(s) were 50 bp or more off peg, 0 were 100 bp or more. Supply is $5.20B, #4 among USD stablecoins, -3.1% over 7 days (net redemptions $166.0M) and -12.4% over 30 days (net redemptions $736.0M). 61% of supply is on Ethereum, spread over 9 chain(s). Heuristic risk score 33/100 (moderate); main drivers: crypto-backed design; supply -3.1% over 7 days; worst daily print 0.995 on 2026-10-11 (-50 bp).",
                  "peg": {
                    "price": 0.99919,
                    "deviationBp": -8.1
                  },
                  "history": {
                    "daily90d": {
                      "points": 90,
                      "from": "2026-08-23",
                      "to": "2026-11-21",
                      "min": 0.995,
                      "max": 1.0012,
                      "mean": 0.99931,
                      "stdevBp": 6.2,
                      "maxDeviationBp": -50,
                      "worst": {
                        "at": "2026-10-11",
                        "price": 0.995
                      },
                      "daysOffPeg50bp": 1,
                      "daysOffPeg100bp": 0
                    },
                    "hourly7d": {
                      "points": 168,
                      "maxDeviationBp": -14.2,
                      "hoursOffPeg50bp": 0
                    }
                  },
                  "supply": {
                    "current": 5200000000,
                    "rank": 4,
                    "marketSharePct": 1.73,
                    "changePct": {
                      "d1": -0.4,
                      "d7": -3.1,
                      "d30": -12.4
                    },
                    "netFlowUsd": {
                      "d1": -21000000,
                      "d7": -166000000,
                      "d30": -736000000
                    }
                  },
                  "chains": {
                    "count": 9,
                    "hhi": 0.42,
                    "top": [
                      {
                        "chain": "Ethereum",
                        "supply": 3172000000,
                        "share": 0.61
                      }
                    ]
                  },
                  "risk": {
                    "score": 33,
                    "tier": "moderate",
                    "components": [
                      {
                        "factor": "mechanism",
                        "points": 18,
                        "detail": "crypto-backed design"
                      }
                    ],
                    "flags": []
                  },
                  "peers": [
                    {
                      "symbol": "USDS",
                      "supplyUsd": 8000000000,
                      "deviationBp": -2.1,
                      "supplyChange7dPct": 0.4,
                      "riskScore": 18
                    }
                  ],
                  "methodology": "Heuristic risk score 0-100 ...",
                  "sources": [
                    {
                      "name": "DefiLlama stablecoins API"
                    },
                    {
                      "name": "DefiLlama coins price chart"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_stablecoins_report",
        "summary": "Stablecoin Due-Diligence Report",
        "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.",
        "tags": [
          "stablecoin",
          "due-diligence",
          "depeg",
          "peg-history",
          "risk-report",
          "usde",
          "usdt",
          "usdc",
          "redemptions",
          "research",
          "treasury",
          "defi"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.04"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "40000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Stablecoin Due-Diligence Report: $0.04 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "coin": {
                    "type": "string",
                    "description": "Ticker (USDe, USDT, FDUSD, PYUSD...), full name, CoinGecko id or DefiLlama stablecoin id. Default USDe",
                    "example": "USDe"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "asOf",
                    "coin",
                    "summary",
                    "peg",
                    "history",
                    "supply",
                    "chains",
                    "risk"
                  ],
                  "properties": {
                    "asOf": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "coin": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "symbol": {
                          "type": "string"
                        },
                        "geckoId": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "mechanism": {
                          "type": "string"
                        }
                      }
                    },
                    "summary": {
                      "type": "string",
                      "description": "plain-English analyst summary built only from the numbers in this response"
                    },
                    "peg": {
                      "type": "object",
                      "properties": {
                        "price": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "deviationBp": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "history": {
                      "type": "object",
                      "properties": {
                        "daily90d": {
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "hourly7d": {
                          "type": [
                            "object",
                            "null"
                          ]
                        }
                      }
                    },
                    "supply": {
                      "type": "object"
                    },
                    "chains": {
                      "type": "object"
                    },
                    "risk": {
                      "type": "object",
                      "properties": {
                        "score": {
                          "type": "integer"
                        },
                        "tier": {
                          "type": "string"
                        },
                        "components": {
                          "type": "array"
                        },
                        "flags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "peers": {
                      "type": "array"
                    },
                    "alternatives": {
                      "type": "array"
                    },
                    "notes": {
                      "type": "array"
                    },
                    "methodology": {
                      "type": "string"
                    },
                    "sources": {
                      "type": "array"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "asOf": "2026-11-21T09:00:00.000Z",
                  "coin": {
                    "id": "146",
                    "name": "Ethena USDe",
                    "symbol": "USDe",
                    "geckoId": "ethena-usde",
                    "mechanism": "crypto-backed",
                    "pegType": "peggedUSD",
                    "priceSource": "defillama"
                  },
                  "summary": "USDe (Ethena USDe, crypto-backed) trades at $0.9992 (-8 bp). Over the last 90 days its worst daily price was $0.995 (-50 bp) on 2026-10-11; 1 day(s) were 50 bp or more off peg, 0 were 100 bp or more. Supply is $5.20B, #4 among USD stablecoins, -3.1% over 7 days (net redemptions $166.0M) and -12.4% over 30 days (net redemptions $736.0M). 61% of supply is on Ethereum, spread over 9 chain(s). Heuristic risk score 33/100 (moderate); main drivers: crypto-backed design; supply -3.1% over 7 days; worst daily print 0.995 on 2026-10-11 (-50 bp).",
                  "peg": {
                    "price": 0.99919,
                    "deviationBp": -8.1
                  },
                  "history": {
                    "daily90d": {
                      "points": 90,
                      "from": "2026-08-23",
                      "to": "2026-11-21",
                      "min": 0.995,
                      "max": 1.0012,
                      "mean": 0.99931,
                      "stdevBp": 6.2,
                      "maxDeviationBp": -50,
                      "worst": {
                        "at": "2026-10-11",
                        "price": 0.995
                      },
                      "daysOffPeg50bp": 1,
                      "daysOffPeg100bp": 0
                    },
                    "hourly7d": {
                      "points": 168,
                      "maxDeviationBp": -14.2,
                      "hoursOffPeg50bp": 0
                    }
                  },
                  "supply": {
                    "current": 5200000000,
                    "rank": 4,
                    "marketSharePct": 1.73,
                    "changePct": {
                      "d1": -0.4,
                      "d7": -3.1,
                      "d30": -12.4
                    },
                    "netFlowUsd": {
                      "d1": -21000000,
                      "d7": -166000000,
                      "d30": -736000000
                    }
                  },
                  "chains": {
                    "count": 9,
                    "hhi": 0.42,
                    "top": [
                      {
                        "chain": "Ethereum",
                        "supply": 3172000000,
                        "share": 0.61
                      }
                    ]
                  },
                  "risk": {
                    "score": 33,
                    "tier": "moderate",
                    "components": [
                      {
                        "factor": "mechanism",
                        "points": 18,
                        "detail": "crypto-backed design"
                      }
                    ],
                    "flags": []
                  },
                  "peers": [
                    {
                      "symbol": "USDS",
                      "supplyUsd": 8000000000,
                      "deviationBp": -2.1,
                      "supplyChange7dPct": 0.4,
                      "riskScore": 18
                    }
                  ],
                  "methodology": "Heuristic risk score 0-100 ...",
                  "sources": [
                    {
                      "name": "DefiLlama stablecoins API"
                    },
                    {
                      "name": "DefiLlama coins price chart"
                    }
                  ],
                  "disclaimer": "Not investment advice."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/pass/day": {
      "get": {
        "operationId": "get_pass_day",
        "summary": "Lumen Research Pass (24 hours)",
        "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.",
        "tags": [
          "research-pass",
          "prepaid",
          "subscription",
          "day-pass",
          "stocks",
          "equity-research",
          "stablecoins",
          "mcp",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Lumen Research Pass (24 hours): $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "plan",
                    "expires_at",
                    "max_calls"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string",
                      "description": "bearer token lp1.…"
                    },
                    "plan": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "use": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "lp1.eyJ2IjoxLCJpYXQiOjE3OTM2MDAwMDAsImV4cCI6MTc5MzY4NjQwMCwianRpIjoiZXhhbXBsZSIsIm1heCI6NDAsInBsYW4iOiJkYXkifQ.signature",
                  "plan": "day",
                  "expires_at": "2026-11-22T12:00:00.000Z",
                  "max_calls": 40,
                  "covers": [
                    "/v1/equity/brief",
                    "/v1/equity/screen",
                    "/v1/stablecoins/report",
                    "/v1/stablecoins/board",
                    "/mcp"
                  ],
                  "use": "Authorization: Bearer <pass>"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_pass_day",
        "summary": "Lumen Research Pass (24 hours)",
        "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.",
        "tags": [
          "research-pass",
          "prepaid",
          "subscription",
          "day-pass",
          "stocks",
          "equity-research",
          "stablecoins",
          "mcp",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Lumen Research Pass (24 hours): $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "plan",
                    "expires_at",
                    "max_calls"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string",
                      "description": "bearer token lp1.…"
                    },
                    "plan": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "use": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "lp1.eyJ2IjoxLCJpYXQiOjE3OTM2MDAwMDAsImV4cCI6MTc5MzY4NjQwMCwianRpIjoiZXhhbXBsZSIsIm1heCI6NDAsInBsYW4iOiJkYXkifQ.signature",
                  "plan": "day",
                  "expires_at": "2026-11-22T12:00:00.000Z",
                  "max_calls": 40,
                  "covers": [
                    "/v1/equity/brief",
                    "/v1/equity/screen",
                    "/v1/stablecoins/report",
                    "/v1/stablecoins/board",
                    "/mcp"
                  ],
                  "use": "Authorization: Bearer <pass>"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/v1/pass/week": {
      "get": {
        "operationId": "get_pass_week",
        "summary": "Lumen Research Pass (7 days)",
        "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.",
        "tags": [
          "research-pass",
          "prepaid",
          "subscription",
          "day-pass",
          "stocks",
          "equity-research",
          "stablecoins",
          "mcp",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "5"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "5000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Lumen Research Pass (7 days): $5.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "plan",
                    "expires_at",
                    "max_calls"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string",
                      "description": "bearer token lp1.…"
                    },
                    "plan": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "use": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "lp1.eyJ2IjoxLCJpYXQiOjE3OTM2MDAwMDAsImV4cCI6MTc5MzY4NjQwMCwianRpIjoiZXhhbXBsZSIsIm1heCI6NDAsInBsYW4iOiJkYXkifQ.signature",
                  "plan": "week",
                  "expires_at": "2026-11-22T12:00:00.000Z",
                  "max_calls": 300,
                  "covers": [
                    "/v1/equity/brief",
                    "/v1/equity/screen",
                    "/v1/stablecoins/report",
                    "/v1/stablecoins/board",
                    "/mcp"
                  ],
                  "use": "Authorization: Bearer <pass>"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      },
      "post": {
        "operationId": "post_pass_week",
        "summary": "Lumen Research Pass (7 days)",
        "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.",
        "tags": [
          "research-pass",
          "prepaid",
          "subscription",
          "day-pass",
          "stocks",
          "equity-research",
          "stablecoins",
          "mcp",
          "finance"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "5"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xE254342b88676Bc1970592DbCA6D54F879B40694"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "5000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Lumen Research Pass (7 days): $5.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "pass",
                    "plan",
                    "expires_at",
                    "max_calls"
                  ],
                  "properties": {
                    "pass": {
                      "type": "string",
                      "description": "bearer token lp1.…"
                    },
                    "plan": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "covers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "use": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "pass": "lp1.eyJ2IjoxLCJpYXQiOjE3OTM2MDAwMDAsImV4cCI6MTc5MzY4NjQwMCwianRpIjoiZXhhbXBsZSIsIm1heCI6NDAsInBsYW4iOiJkYXkifQ.signature",
                  "plan": "week",
                  "expires_at": "2026-11-22T12:00:00.000Z",
                  "max_calls": 300,
                  "covers": [
                    "/v1/equity/brief",
                    "/v1/equity/screen",
                    "/v1/stablecoins/report",
                    "/v1/stablecoins/board",
                    "/mcp"
                  ],
                  "use": "Authorization: Bearer <pass>"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Unknown coin or company not covered (not charged)"
          },
          "502": {
            "description": "Upstream unavailable (not charged)"
          },
          "503": {
            "description": "Data not loaded on this deployment (not charged)"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/data": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/peek": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/equity/peek": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/pass/quote": {
      "get": {
        "summary": "Free: quote for buying a Research Pass with a plain USDC transfer on Base (not x402)",
        "security": [],
        "parameters": [
          {
            "name": "plan",
            "in": "query",
            "required": false,
            "description": "day ($1, 24 h, 40 calls) or week ($5, 7 days, 300 calls); default day",
            "schema": {
              "type": "string",
              "enum": [
                "day",
                "week"
              ]
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Optional paying wallet (0x…): pay a round amount from it instead of the exact quoted amount",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Signed quote and payment steps"
          }
        }
      }
    },
    "/v1/pass/claim": {
      "get": {
        "summary": "Free: claim the pass after the transfer (idempotent)",
        "security": [],
        "parameters": [
          {
            "name": "quote",
            "in": "query",
            "required": true,
            "description": "lq1.… quote from /v1/pass/quote",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tx",
            "in": "query",
            "required": true,
            "description": "0x hash of the Base transaction that paid the USDC",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "lp1.… pass token"
          }
        }
      }
    },
    "/v1/pass/status": {
      "get": {
        "summary": "Free: plan, expiry and calls left on the pass in Authorization: Bearer",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "Remote MCP server (Streamable HTTP, JSON responses): research tools paid with x402 over MCP or a Research Pass",
        "security": [],
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    }
  }
}