Pro · Launching Q2 2026

API Documentation

RESTful JSON API for conviction scores, buy/sell signals, manager holdings, and live quotes. 1,000 calls/month included with Pro. Rate-limited, API-key authenticated.

Authentication

Include your API key in the Authorization header:

curl -H "Authorization: Bearer hl_pro_YOUR_KEY" \
  https://api.holdlens.com/v1/scores

API keys are generated in your Pro dashboard after subscribing.

Endpoints

GET/api/v1/scores

All conviction scores, ranked by strength

Example response

{
  "data": [
    {
      "ticker": "NVDA",
      "score": 68,
      "direction": "BUY",
      "label": "BUY",
      "buyerCount": 8,
      "sellerCount": 1,
      "ownerCount": 12
    }
  ],
  "meta": { "count": 94, "quarter": "2025-Q4" }
}

GET/api/v1/scores/:ticker

Single ticker conviction score with full breakdown

Example response

{
  "ticker": "NVDA",
  "score": 68,
  "direction": "BUY",
  "breakdown": {
    "smartMoney": 22,
    "insiderBoost": 8,
    "trackRecord": 14,
    "trendStreak": 10,
    "concentration": 7,
    "contrarian": 0,
    "dissentPenalty": 3,
    "crowdingPenalty": 4
  },
  "topBuyers": [
    { "name": "Stanley Druckenmiller", "cagr": 18.2, "positionPct": 8.4 }
  ]
}

GET/api/v1/signals/buys

Top buy signals, sorted by score descending

Example response

{
  "data": [
    { "ticker": "NVDA", "score": 68, "buyerCount": 8 },
    { "ticker": "GOOGL", "score": 52, "buyerCount": 6 }
  ]
}

GET/api/v1/signals/sells

Top sell signals, sorted by score ascending

Example response

{
  "data": [
    { "ticker": "DIS", "score": -34, "sellerCount": 4 },
    { "ticker": "BABA", "score": -22, "sellerCount": 3 }
  ]
}

GET/api/v1/managers

All tracked portfolio managers with holdings summary

Example response

{
  "data": [
    {
      "slug": "warren-buffett",
      "name": "Warren Buffett",
      "fund": "Berkshire Hathaway",
      "topHolding": "AAPL",
      "holdingCount": 12
    }
  ]
}

GET/api/v1/managers/:slug

Manager detail: holdings, moves, performance

Example response

{
  "slug": "warren-buffett",
  "name": "Warren Buffett",
  "fund": "Berkshire Hathaway",
  "cagr10y": 13.2,
  "holdings": [
    { "ticker": "AAPL", "pct": 43.2 },
    { "ticker": "BAC", "pct": 10.1 }
  ]
}

Rate limits

Pro tier

1,000

calls/month

Burst limit

calls/second

Response format

JSON

UTF-8, gzip

Get early API access

View Pro pricing →