What it returns
Daily NAV data for every US-listed SPDR ETF, read from State Street's public fund data. Latest mode gives each fund's NAV, net assets, closing price, premium or discount to NAV, expense ratio and NAV returns. History mode gives each chosen fund's daily NAV, shares outstanding and net assets back to its published start, plus the day's change in shares and the implied creation or redemption flow in dollars.
Latest mode:
| Field | Meaning |
|---|---|
| ticker, fundName, isin, cusip | Fund identifiers |
| nav, navDate | Latest NAV per share and its date |
| netAssetsUsdMillions | Fund net assets, USD millions |
| closePrice, bidAskMid, premiumDiscountPct | Market close, bid/ask midpoint and premium (+) or discount (-) to NAV, % |
| expenseRatio, primaryExchange | Gross expense ratio, % and listing exchange |
| navReturnMtd1m, navReturnYtd, navReturn1y, navReturn3y, navReturn5y, navReturn10y, navReturnSinceInception, returnsAsOf | Month-end NAV total returns, % (multi-year annualized) |
| inceptionDate, source | Inception date and fund page |
History mode:
| Field | Meaning |
|---|---|
| ticker, fundName, date | Fund and trading day |
| nav | NAV per share |
| sharesOutstanding, netAssets | Shares outstanding and net assets, USD |
| sharesChange, estimatedFlowUsd | Change in shares from the prior day, and that change × NAV (creations positive, redemptions negative; computed) |
Common uses
- Daily ETF flow tracking for SPY, GLD and the sector SPDRs
- Premium/discount monitoring across all SPDR funds
- Long NAV and shares-outstanding histories for backtests
Request
POST https://api.pushbuild.com/spdr-etf-nav/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: latest, history | latest: one row per SPDR ETF with its latest NAV, close, premium/discount and returns. history: one row per fund per day with NAV, shares outstanding, net assets and implied creations/redemptions. Default: "latest". |
tickers | list of strings | SPDR ETF tickers such as SPY, GLD, XLF. Latest mode: empty returns every US SPDR ETF (about 190). History mode: 1 to 25 tickers. |
startDate | string | History mode: first date to return (YYYY-MM-DD). Empty starts at the fund's earliest published day. |
endDate | string | History mode: last date to return (YYYY-MM-DD). Empty runs to the latest day. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/spdr-etf-nav/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"tickers": ["SPY", "GLD", "XLK"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Banco de Portugal API: Portugal Rates, Yields, HICP & GDP API
Banco de Portugal BPstat data from the official API: coincident indicators, HICP, GDP, house prices, confidence, Portuguese government bond yields, money-market, loan and deposit rates, banking ratios, or any BPstat dataset or series id..
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
Bank of Israel API: BOI Rate, SHIR & Shekel Exchange Rates API
Bank of Israel statistics from its official SDMX API: the BOI interest rate, SHIR overnight rate and standing facility rates, daily representative shekel exchange rates (USD, EUR, GBP, JPY, CHF, CAD, AUD), or any series of any BOI dataflow..
Bank of Japan API: Call Rate, USD/JPY, Money Stock & Tankan API
Bank of Japan statistics from its official Time-Series Data Search API: overnight call rate, basic loan rate, USD/JPY, monetary base, M2, producer prices and Tankan business conditions presets, any series by database and code, and series search..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com