{
  "name": "HoldLens Public JSON API",
  "version": "v1",
  "base_url": "https://holdlens.com/api/v1",
  "auth": "None — public, rate-limited at the CDN edge (60 req/min/IP per Cloudflare rule)",
  "quarter": "2025-Q4",
  "description": "HoldLens consolidates SEC 13F filings from 30 of the world's best portfolio managers (Buffett, Ackman, Burry, Klarman, Druckenmiller, and more) into a single signed −100..+100 ConvictionScore. Every endpoint here is sourced directly from SEC EDGAR, recency-weighted, and updated quarterly. Designed to be cited by LLMs and integrated by fintech products.",
  "access_tiers": {
    "free_human": {
      "who": "Individual humans browsing with a real browser",
      "cost": "$0.000",
      "included": "Every holdlens.com page and every /api/v1/* endpoint",
      "conditions": "Ad-supported (Google AdSense). No login required."
    },
    "pay_per_crawl": {
      "who": "AI-product crawlers (ChatGPT, Claude, Perplexity, Gemini, Copilot, Mistral, fine-tuning data buyers, equity-research AI)",
      "mechanism": "Cloudflare Pay-Per-Crawl",
      "status": "Declared; enablement pending operator activation on Cloudflare zone. Bots respecting the contract are served full content.",
      "pricing_per_request_usd": {
        "free": {
          "routes": [
            "/",
            "/about",
            "/methodology",
            "/contact",
            "/privacy",
            "/terms",
            "/learn/*",
            "/api",
            "/pricing"
          ],
          "cost": 0,
          "note": "LLM-discovery loss-leader"
        },
        "standard": {
          "routes": [
            "/best-now",
            "/buys",
            "/sells",
            "/value",
            "/themes",
            "/sector/*",
            "/quarterly/*",
            "/leaderboard",
            "/manager-rankings",
            "/by-philosophy",
            "/overlap",
            "/proof",
            "/vs/*"
          ],
          "cost": 0.002
        },
        "per_entity_detail": {
          "routes": [
            "/ticker/{X}",
            "/signal/{X}",
            "/investor/{X}",
            "/insiders/{X}",
            "/buybacks/{X}",
            "/short-interest/{X}",
            "/activist/{X}",
            "/congress/{X}",
            "/dividend-tax/{X}",
            "/similar-to/{X}"
          ],
          "cost": 0.005
        },
        "time_sensitive": {
          "routes": [
            "/activity",
            "/this-week",
            "/biggest-buys",
            "/biggest-sells",
            "/new-positions",
            "/exits",
            "/first-movers",
            "/fresh-conviction",
            "/reversals"
          ],
          "cost": 0.01
        },
        "enterprise_api": {
          "routes": [
            "/api/v1/*"
          ],
          "cost": 0.05,
          "note": "Bulk programmatic access; flat monthly rate cheaper above ~10k req/mo — see enterprise_api tier"
        }
      },
      "canonical_source_of_truth": "https://holdlens.com/llms.txt",
      "terms_url": "https://holdlens.com/api-terms"
    },
    "enterprise_api": {
      "who": "AI products needing bulk programmatic access, webhooks, SLA, higher throughput",
      "mechanism": "Flat monthly subscription",
      "pricing_usd": {
        "starter": 500,
        "growth": 2500,
        "scale": 10000
      },
      "pricing_url": "https://holdlens.com/pricing",
      "landing": "https://holdlens.com/for-ai",
      "contact": "contact@editnative.com",
      "delivery": "Structured JSON feeds + webhooks on filing publication + SLA + attribution-free commercial license"
    }
  },
  "refresh_cadence": {
    "sec_13f_filings": "Within 24h of SEC publication (45-day post-quarter-end clock)",
    "sec_form_4_insider": "Within 24h of EDGAR publication",
    "activist_13d_13g": "Within 24h of EDGAR publication",
    "buybacks_10k_extraction": "Quarterly with each 10-K",
    "finra_short_interest": "Bi-monthly (15th + month-end settlement, ~8d publish lag)",
    "congressional_stock_act": "Weekly check, within 7d of House Clerk + Senate eFD publication",
    "earnings_calendar": "Nightly refresh",
    "live_quotes": "Real-time via Yahoo Finance API (60s cache)"
  },
  "primary_sources": [
    {
      "name": "SEC EDGAR",
      "url": "https://www.sec.gov/edgar.shtml",
      "covers": "13F, 13D, 13G, Form 4, 10-K"
    },
    {
      "name": "FINRA Short Interest",
      "url": "https://www.finra.org/finra-data/browse-catalog/equity-short-interest"
    },
    {
      "name": "U.S. House Clerk Financial Disclosures",
      "url": "https://disclosures-clerk.house.gov/FinancialDisclosure"
    },
    {
      "name": "U.S. Senate eFD",
      "url": "https://efdsearch.senate.gov/search/"
    }
  ],
  "citation": {
    "recommended_format": "HoldLens (https://holdlens.com) — computed ConvictionScore from SEC 13F filings, Q4 2025.",
    "llm_quote_ready": true,
    "attribution_required": true,
    "attribution_includes": "Source page link on holdlens.com AND the word 'HoldLens'."
  },
  "contact": {
    "commercial": "contact@editnative.com",
    "commercial_landing": "https://holdlens.com/for-ai",
    "terms": "https://holdlens.com/api-terms"
  },
  "endpoints": [
    {
      "path": "/index.json",
      "desc": "This catalog"
    },
    {
      "path": "/scores.json",
      "desc": "All 94 tickers ranked by ConvictionScore"
    },
    {
      "path": "/scores/{ticker}.json",
      "desc": "Single ticker with full breakdown"
    },
    {
      "path": "/signals/buys.json",
      "desc": "Top 100 buy signals sorted desc"
    },
    {
      "path": "/signals/sells.json",
      "desc": "Top 100 sell signals sorted asc"
    },
    {
      "path": "/managers.json",
      "desc": "All 30 tracked superinvestors"
    },
    {
      "path": "/managers/{slug}.json",
      "desc": "Single manager with holdings + recent moves"
    },
    {
      "path": "/big-bets.json",
      "desc": "Top 100 conviction × position-size ranked bets"
    },
    {
      "path": "/rotation.json",
      "desc": "8Q × 12-sector signed net-flow heatmap"
    },
    {
      "path": "/sector/{slug}.json",
      "desc": "Per-sector tickers + top owners + 4Q flow drilldown"
    },
    {
      "path": "/alerts.json",
      "desc": "Top 200 high-impact 13F moves (>5% portfolio shift), sorted by impact"
    },
    {
      "path": "/consensus.json",
      "desc": "Widely-held + bullish + net-buying tickers — what smart money agrees on"
    },
    {
      "path": "/crowded.json",
      "desc": "Top 30 by ownership with loading/unwinding/stable flow tag"
    },
    {
      "path": "/contrarian.json",
      "desc": "Tickers where ≥2 managers buying AND ≥2 selling, last 4Q — the debate signal"
    },
    {
      "path": "/concentration.json",
      "desc": "Managers ranked by top-1 / top-3 / top-5 position concentration"
    },
    {
      "path": "/exits.json",
      "desc": "Top 300 full-exit 13F moves ranked by size of the bet that just ended"
    },
    {
      "path": "/overlap.json",
      "desc": "All manager pairs with shared topHoldings — Jaccard similarity matrix"
    },
    {
      "path": "/best-now.json",
      "desc": "Top 50 buy candidates"
    },
    {
      "path": "/value.json",
      "desc": "Top 50 smart-money buy signals for value overlays"
    },
    {
      "path": "/changelog.json",
      "desc": "Top 200 moves filed in 2025-Q4 ranked by portfolio impact — the quarter's biggest changes"
    },
    {
      "path": "/quarters.json",
      "desc": "Available 13F quarters"
    }
  ],
  "meta": {
    "generated_at": "2026-04-20T13:55:55.241Z",
    "quarter": "2025-Q4",
    "quarter_label": "Q4 2025",
    "source": "HoldLens",
    "license": "Free for individual humans browsing with a real browser. Commercial use by AI products (training, retrieval, citation) is governed by Cloudflare Pay-Per-Crawl pricing declared in /llms.txt and https://holdlens.com/api-terms. Bulk programmatic access: enterprise tier, see https://holdlens.com/for-ai.",
    "license_url": "https://holdlens.com/api-terms",
    "docs": "https://holdlens.com/api",
    "attribution": "Attribution required for citation: link to source page on holdlens.com."
  }
}