Tools/Signals & cross-source joins

signal.crowding

5 crread-only

Cross-fund 'smart money' consensus from every tracked fund's latest 13F: the securities the MOST funds are collectively holding (mode='held'), buying this quarter (mode='bought' — NEW/ADDED cluster-buys), or selling (mode='sold' — REDUCED). The inverse of stock.owners: surfaces WHAT to look at, ranked by how many funds agree. Served from the consensus snapshot the refresh-signals cron rebuilds twice daily (computed_at and snapshot_age_hours in the response); never computed live, and refused uncharged if the snapshot is older than 26h. Cost: 5 credits per call.

Parameters#

ParameterTypeDescription
modeoptstringheld=consensus longs, bought=cluster-buys, sold=cluster-exits (default held)one of: held, bought, sold
limitoptnumberMax securities (1-100, default 25)

Example call#

bash
curl -X POST https://arkolith.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "signal.crowding",
    "arguments": {
      "mode": "bought",
      "limit": 25
    }
  }
}'

Example response#

json
{
  "status": "ok",
  "mode": "bought",
  "items": [
    { "ticker": "NVDA", "cusip": "67066G", "issuer": "NVIDIA CORP", "funds": 14, "total_value_usd": 9800000000 },
    { "ticker": "MSFT", "cusip": "594918", "issuer": "MICROSOFT CORP", "funds": 11, "total_value_usd": 5400000000 }
  ],
  "provenance": { "source": "SEC EDGAR 13F", "license": "public domain" },
  "source": "consensus-snapshot",
  "computed_at": "2026-09-04T12:24:57Z",
  "snapshot_age_hours": 3.2
}