{
  "dataset": "The Potomac Ledger — disclosed government stock trades",
  "version": "2026-05-26",
  "generatedAt": "2026-05-26T15:56:12.862Z",
  "coverage": {
    "total": 26331,
    "congress": {
      "rows": 22205,
      "years": {
        "2021": {
          "total": 5607,
          "pct": 100
        },
        "2022": {
          "total": 4588,
          "pct": 100
        },
        "2023": {
          "total": 4938,
          "pct": 100
        },
        "2024": {
          "total": 2725,
          "pct": 100
        },
        "2025": {
          "total": 4183,
          "pct": 100
        },
        "2026": {
          "total": 164,
          "pct": 100
        }
      }
    },
    "executive": {
      "rows": 4126,
      "years": {
        "2001": {
          "total": 1,
          "pct": 100
        },
        "2020": {
          "total": 560,
          "pct": 100
        },
        "2021": {
          "total": 959,
          "pct": 100
        },
        "2022": {
          "total": 348,
          "pct": 100
        },
        "2023": {
          "total": 241,
          "pct": 100
        },
        "2024": {
          "total": 133,
          "pct": 100
        },
        "2025": {
          "total": 1498,
          "pct": 100
        },
        "2026": {
          "total": 386,
          "pct": 100
        }
      }
    }
  },
  "fields": [
    {
      "name": "id",
      "type": "string",
      "description": "Stable, immutable record id (tl_<hash>). Re-pullable / citeable.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "branch",
      "type": "string",
      "description": "\"congress\" or \"executive\".",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "person",
      "type": "string",
      "description": "Member of Congress or executive-branch official who filed.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "personId",
      "type": "string",
      "description": "Stable person id: bio:<Bioguide> for resolved Congress members, else name:<slug>.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "role",
      "type": "string",
      "description": "Chamber (House/Senate) for Congress; title for executive officials.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "party",
      "type": "string",
      "description": "D / R / I (Congress; resolved from the legislators index).",
      "completeness": {
        "congressPct": 56,
        "executivePct": 0
      }
    },
    {
      "name": "state",
      "type": "string",
      "description": "Two-letter state (Congress).",
      "completeness": {
        "congressPct": 88.4,
        "executivePct": 0
      }
    },
    {
      "name": "agency",
      "type": "string",
      "description": "Department/agency (executive branch).",
      "completeness": {
        "congressPct": 0,
        "executivePct": 100
      }
    },
    {
      "name": "ticker",
      "type": "string",
      "description": "Stock ticker; null for non-listed assets (bonds, funds, private holdings).",
      "completeness": {
        "congressPct": 88.7,
        "executivePct": 53
      }
    },
    {
      "name": "issuerId",
      "type": "string",
      "description": "Normalized issuer id: tic:<TICKER> when listed, else ast:<slug> of the asset name.",
      "completeness": {
        "congressPct": 99.9,
        "executivePct": 100
      }
    },
    {
      "name": "asset",
      "type": "string",
      "description": "Free-text asset/company name as disclosed.",
      "completeness": {
        "congressPct": 99.9,
        "executivePct": 100
      }
    },
    {
      "name": "type",
      "type": "string",
      "description": "Canonical action: buy | sell | partial_sale | exchange | other.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "typeRaw",
      "type": "string",
      "description": "Original filing transaction code, preserved for audit (e.g. p, s, s (partial), e).",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "amountRange",
      "type": "string",
      "description": "Disclosed dollar RANGE (e.g. \"$1,001 - $15,000\") — not an exact figure.",
      "completeness": {
        "congressPct": 99.8,
        "executivePct": 100
      }
    },
    {
      "name": "amountMin",
      "type": "number",
      "description": "Lower bound of the disclosed range.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "amountMax",
      "type": "number",
      "description": "Upper bound of the disclosed range (null for open-ended \"$X +\").",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "tradeDate",
      "type": "date",
      "description": "Date of the transaction (ISO). The correct anchor for timing analysis.",
      "completeness": {
        "congressPct": 100,
        "executivePct": 100
      }
    },
    {
      "name": "disclosureDate",
      "type": "date",
      "description": "Date the filing was disclosed. Lags the trade by 30-45 days; sparse on historical rows.",
      "completeness": {
        "congressPct": 82.2,
        "executivePct": 100
      }
    },
    {
      "name": "sector",
      "type": "string",
      "description": "GICS-style sector of the ticker (enrichment; recent data only).",
      "completeness": {
        "congressPct": 0.8,
        "executivePct": 34
      }
    },
    {
      "name": "potentialConflict",
      "type": "boolean",
      "description": "Heuristic flag: ticker sector overlaps the person's committee/agency jurisdiction. Not an accusation. Percentage shown is the share flagged true.",
      "completeness": {
        "congressPct": 0.2,
        "executivePct": 2
      }
    },
    {
      "name": "filingUrl",
      "type": "string",
      "description": "Link to the primary-source filing.",
      "completeness": {
        "congressPct": 82.2,
        "executivePct": 100
      }
    },
    {
      "name": "returns",
      "type": "object",
      "description": "Forward split/dividend-adjusted stock return + market-adjusted (vs SPY) abnormal return at ~1mo/3mo, anchored on the disclosure date where available (point-in-time) else the trade date. A PROXY for trade timing, NOT the official's realized profit (execution price, exact size, and holding period are unknown). Null when no price match.",
      "completeness": {
        "congressPct": 77.7,
        "executivePct": 50.4
      }
    }
  ],
  "enrichmentByYear": {
    "sector_congress": {
      "2021": {
        "total": 5607,
        "pct": 0
      },
      "2022": {
        "total": 4588,
        "pct": 0
      },
      "2023": {
        "total": 4938,
        "pct": 0
      },
      "2024": {
        "total": 2725,
        "pct": 0
      },
      "2025": {
        "total": 4183,
        "pct": 0.4
      },
      "2026": {
        "total": 164,
        "pct": 97.6
      }
    },
    "disclosureDate_congress": {
      "2021": {
        "total": 5607,
        "pct": 87.7
      },
      "2022": {
        "total": 4588,
        "pct": 84.9
      },
      "2023": {
        "total": 4938,
        "pct": 78.4
      },
      "2024": {
        "total": 2725,
        "pct": 74.3
      },
      "2025": {
        "total": 4183,
        "pct": 80.7
      },
      "2026": {
        "total": 164,
        "pct": 100
      }
    },
    "potentialConflict_congress": {
      "2021": {
        "total": 5607,
        "pct": 0
      },
      "2022": {
        "total": 4588,
        "pct": 0
      },
      "2023": {
        "total": 4938,
        "pct": 0
      },
      "2024": {
        "total": 2725,
        "pct": 0
      },
      "2025": {
        "total": 4183,
        "pct": 0.1
      },
      "2026": {
        "total": 164,
        "pct": 26.2
      }
    },
    "disclosureDate_exec": {
      "2001": {
        "total": 1,
        "pct": 100
      },
      "2020": {
        "total": 560,
        "pct": 100
      },
      "2021": {
        "total": 959,
        "pct": 100
      },
      "2022": {
        "total": 348,
        "pct": 100
      },
      "2023": {
        "total": 241,
        "pct": 100
      },
      "2024": {
        "total": 133,
        "pct": 100
      },
      "2025": {
        "total": 1498,
        "pct": 100
      },
      "2026": {
        "total": 386,
        "pct": 100
      }
    },
    "ticker_exec": {
      "2001": {
        "total": 1,
        "pct": 0
      },
      "2020": {
        "total": 560,
        "pct": 72.7
      },
      "2021": {
        "total": 959,
        "pct": 58.3
      },
      "2022": {
        "total": 348,
        "pct": 57.5
      },
      "2023": {
        "total": 241,
        "pct": 67.2
      },
      "2024": {
        "total": 133,
        "pct": 76.7
      },
      "2025": {
        "total": 1498,
        "pct": 36
      },
      "2026": {
        "total": 386,
        "pct": 56.5
      }
    },
    "sector_exec": {
      "2001": {
        "total": 1,
        "pct": 0
      },
      "2020": {
        "total": 560,
        "pct": 29.5
      },
      "2021": {
        "total": 959,
        "pct": 36.9
      },
      "2022": {
        "total": 348,
        "pct": 51.7
      },
      "2023": {
        "total": 241,
        "pct": 61
      },
      "2024": {
        "total": 133,
        "pct": 54.1
      },
      "2025": {
        "total": 1498,
        "pct": 20.9
      },
      "2026": {
        "total": 386,
        "pct": 44.8
      }
    }
  },
  "limitations": [
    "Disclosed date is not the trade date — STOCK Act filings lag 30-45 days. Anchor timing analysis on tradeDate.",
    "Dollar figures are disclosed ranges, not exact amounts (interval-censored).",
    "Conflict flags are heuristic potential overlaps, not assertions of wrongdoing.",
    "Spouse/dependent and blind-trust trades are co-mingled; the filer name is not proof of the filer's decision.",
    "Congressional sector/potentialConflict enrichment is populated mainly on recent data — see per-year completeness.",
    "House trades carry disclosure dates + primary-source filing links; Senate trades currently do not (no bulk Senate source), so they show as the gap in congressional disclosureDate/filingUrl coverage.",
    "Returns are forward stock performance after disclosure (split/dividend-adjusted, market-adjusted vs SPY) — a reproducible proxy for trade timing, not the filer's realized profit. We do not know their execution price, exact size (amounts are ranges), or holding period.",
    "Not investment advice."
  ]
}