Skip to content

fix(distributions): keep the full SSGA distribution history per fund #81

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
daggerok merged 6 commits into from
Oct 13, 2026
Merged

fix(distributions): keep the full SSGA distribution history per fund #81

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
d065ddd
feat(output): apply the canonical updater console output spec
daggerok Oct 13, 2026
90b9db0
fix(distributions): keep the full SSGA distribution history per fund
daggerok Oct 13, 2026
09c2fbc
chore(data): update SPDR ETF data
daggerok Oct 13, 2026
4f28ae8
refactor(output): use the one shared console output block
daggerok Oct 13, 2026
13ccc76
style(output): treat TICKERS as a selection, print 1 fund in the sing…
daggerok Oct 13, 2026
cfba1f5
docs(ui): describe Ex-Date for the full distribution history
daggerok Oct 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
3 changes: 2 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,8 @@ Defaults live in `scripts/update-data.config.json`, one string value per control
| --- | --- |
| Catalog (all US SPDR ETFs) | `https://www.ssga.com/us/en/intermediary/etfs/fund-finder` (SSGA fund finder JSON) |
| Holdings per fund | `https://www.ssga.com/us/en/intermediary/etfs/library-content/products/fund-data/etfs/us/holdings-daily-us-{TICKER}.xlsx` (per-fund holdings XLSX) |
| Daily history, distributions | `https://www.ssga.com/us/en/intermediary/etfs/library-content/products/fund-data/etfs/us/navhistory-daily-us-{TICKER}.xlsx` (NAV history XLSX) |
| Daily history | `https://www.ssga.com/us/en/intermediary/etfs/library-content/products/fund-data/etfs/us/navhistory-daily-us-{TICKER}.xlsx` (NAV history XLSX) |
| Distributions (full history per fund, newest first; frequency from the latest-distribution feed) | `ssga.com/bin/v1/ssmp/fund/dividend-distribution?country=us&language=en&role=intermediary&product=etfs&ticker={TICKER}` (JSON, the data behind SSGA's ETF Historical Distributions page) |
| Daily Premium/Discount history | `ssga.com/library-content/products/fund-data/etfs/us/pdhist-us-en-{TICKER}.xlsx` |
| ISIN, CUSIP, official 30-Day SEC Yield (subsidized/unsubsidized), official Fund Dividend Yield (whole lineup, one fetch per run) | `ssga.com/library-content/products/fund-data/etfs/us/spdr-product-data-us-en.xlsx` |
| Fallback | Previously published `api/spdr/index.json` |
Expand Down
8 changes: 7 additions & 1 deletion api/spdr/funds/ALLW/history/001.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "ALLW",
"page": 1,
"pageSize": 1000,
"totalRows": 403,
"totalRows": 404,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "12-Oct-2026",
"NAV": "28.869011",
"Shares Outstanding": "63000000",
"Total Net Assets": "1818747665.41"
},
{
"Date": "09-Oct-2026",
"NAV": "28.83411",
Expand Down
8 changes: 4 additions & 4 deletions api/spdr/funds/ALLW/meta.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
"holdingsDownload": "https://www.ssga.com/library-content/products/fund-data/etfs/us/holdings-daily-us-en-allw.xlsx",
"navDownload": "https://www.ssga.com/library-content/products/fund-data/etfs/us/navhist-us-en-allw.xlsx",
"premiumDiscountDownload": "https://www.ssga.com/library-content/products/fund-data/etfs/us/pdhist-us-en-allw.xlsx",
"distributionsDownload": "https://www.ssga.com/bin/v1/ssmp/fund/dividend-distribution?country=us&language=en&role=intermediary&product=etfs&ticker=ALLW",
"productDataDownload": "https://www.ssga.com/library-content/products/fund-data/etfs/us/spdr-product-data-us-en.xlsx",
"factsheet": "https://www.ssga.com/library-content/products/factsheets/etfs/us/factsheet-us-en-allw.pdf"
},
Expand Down Expand Up @@ -96,7 +97,7 @@
"dividendYield": 2.98,
"dividendYieldSource": "official",
"dividendYieldBasis": "official-other",
"indicatedDividendYield": 2.9803,
"indicatedDividendYield": 2.98,
"secYield": 1.82,
"secYieldUnsubsidized": 1.77,
"tr1yText": "7.63%",
Expand All @@ -116,8 +117,8 @@
"performanceAsOf": "2026-09-30"
},
"distributions": {
"frequency": "Annually",
"headers": [
"Frequency",
"Ex-Date",
"Record Date",
"Payable Date",
Expand All @@ -127,7 +128,6 @@
],
"rows": [
[
"Annually",
"12/29/2025",
"12/29/2025",
"12/31/2025",
Expand All @@ -148,7 +148,7 @@
"status": "ok"
},
"history": {
"totalRows": 403,
"totalRows": 404,
"pageSize": 1000,
"pageCount": 1,
"pages": [
Expand Down
14 changes: 7 additions & 7 deletions api/spdr/funds/BIL/history/001.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "BIL",
"page": 1,
"pageSize": 1000,
"totalRows": 4876,
"totalRows": 4877,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "12-Oct-2026",
"NAV": "91.502111",
"Shares Outstanding": "557324503",
"Total Net Assets": "50996368667.32"
},
{
"Date": "09-Oct-2026",
"NAV": "91.502614",
Expand Down Expand Up @@ -6003,12 +6009,6 @@
"NAV": "91.500198",
"Shares Outstanding": "285944503",
"Total Net Assets": "26163978701.19"
},
{
"Date": "14-Oct-2022",
"NAV": "91.494541",
"Shares Outstanding": "283494503",
"Total Net Assets": "25938199471.31"
}
]
}
14 changes: 7 additions & 7 deletions api/spdr/funds/BIL/history/002.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "BIL",
"page": 2,
"pageSize": 1000,
"totalRows": 4876,
"totalRows": 4877,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "14-Oct-2022",
"NAV": "91.494541",
"Shares Outstanding": "283494503",
"Total Net Assets": "25938199471.31"
},
{
"Date": "13-Oct-2022",
"NAV": "91.47424",
Expand Down Expand Up @@ -6003,12 +6009,6 @@
"NAV": "91.550119",
"Shares Outstanding": "47644503",
"Total Net Assets": "4361859921.51"
},
{
"Date": "24-Oct-2018",
"NAV": "91.544784",
"Shares Outstanding": "46844503",
"Total Net Assets": "4288369930.66"
}
]
}
14 changes: 7 additions & 7 deletions api/spdr/funds/BIL/history/003.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "BIL",
"page": 3,
"pageSize": 1000,
"totalRows": 4876,
"totalRows": 4877,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "24-Oct-2018",
"NAV": "91.544784",
"Shares Outstanding": "46844503",
"Total Net Assets": "4288369930.66"
},
{
"Date": "23-Oct-2018",
"NAV": "91.539694",
Expand Down Expand Up @@ -6003,12 +6009,6 @@
"NAV": "45.742192",
"Shares Outstanding": "40100461",
"Total Net Assets": "1834282972.52"
},
{
"Date": "04-Nov-2014",
"NAV": "45.741936",
"Shares Outstanding": "40800461",
"Total Net Assets": "1866292059.83"
}
]
}
14 changes: 7 additions & 7 deletions api/spdr/funds/BIL/history/004.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "BIL",
"page": 4,
"pageSize": 1000,
"totalRows": 4876,
"totalRows": 4877,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "04-Nov-2014",
"NAV": "45.741936",
"Shares Outstanding": "40800461",
"Total Net Assets": "1866292059.83"
},
{
"Date": "03-Nov-2014",
"NAV": "45.742734",
Expand Down Expand Up @@ -6003,12 +6009,6 @@
"NAV": "45.851217",
"Shares Outstanding": "20500461",
"Total Net Assets": "939971085.04"
},
{
"Date": "17-Nov-2010",
"NAV": "45.851281",
"Shares Outstanding": "20500461",
"Total Net Assets": "939972399.08"
}
]
}
8 changes: 7 additions & 1 deletion api/spdr/funds/BIL/history/005.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
"ticker": "BIL",
"page": 5,
"pageSize": 1000,
"totalRows": 4876,
"totalRows": 4877,
"headers": [
"Date",
"NAV",
"Shares Outstanding",
"Total Net Assets"
],
"rows": [
{
"Date": "17-Nov-2010",
"NAV": "45.851281",
"Shares Outstanding": "20500461",
"Total Net Assets": "939972399.08"
},
{
"Date": "16-Nov-2010",
"NAV": "45.851703",
Expand Down
Loading
Loading