The service currently runs on a single small machine: about 50 search requests/s and ~20 concurrent ask sessions across all users. Please keep concurrency modest (≤ 5 per client) and back off on 429 using Retry-After. Details →

US equities

Overview

US equities — prices, news, SEC filings, insider trades, financials, macro series and the events they add up to — each of them askable as of a past moment, returning only what could be seen then.

status
live
document id
id e.g. AAPL
citation
each record's upstream id as is (px: / evt_ / news: / filing: / form4: / fin: / macro:…@vintage), with its license
The fine print
  • 上游 1.0-beta(2026-10-19):license tiingo_internal renamed tiingo_licensed: Tiingo data is now licensed for redistribution; statement timeout (12 s) returns 504 with Retry-After: 60 instead of 500; GET /v1/search and GET /v1/stocks/search results cached for 60 s per parameter set; /v1/meta: base and routes[].free_samples are host-relative paths (no internal address, no doubled /v1)

As of a moment

Every call can be asked as of a past moment, and then returns only what could have been seen then — the price that had printed, the news that had run, the filing that had been accepted, the macro figure as first released rather than as later revised. A backtest built on it does not peek.

search takes it in filters.as_of; read takes it as the query parameter as_of. An ISO date or datetime; without a zone it is New York time, and a bare date means the end of that day there. Left out, it means now. A record that did not yet exist at that moment is 404 not_visible_at_as_of, and a moment in the future is 400.

Calls

POST /v1/stocks/search
{"query": "chip export restrictions", "filters": {"as_of": "2026-10-15"}}

POST /v1/stocks/search
{"query": "cloud server", "filters": {"source": "stocks"}}

GET  /v1/stocks/read/AAPL?as_of=2026-09-01
GET  /v1/stocks/read/AAPL?extra=prices&as_of=2026-09-01
GET  /v1/stocks/read/macro:CPIAUCSL?as_of=2026-09-01

Text queries are ranked by relevance across news, events and filings together; the first page of that default search also carries a top-level stocks: the five tickers that match the theme. filters.source narrows to one kind, and source=stocks returns companies alone, found by what they do. An all-caps ticker such as NVDA, or *, lists newest first instead. read takes a ticker, macro:<series>, digest:market / digest:macro, or the id of any record a search returned (news:…, evt_…, filing:…, form4:…, fin:…). Results are cached for 60 seconds.

When each kind of record becomes visible

pricesdaily bar of D visible after D 16:00 ET; 1m IEX bar visible at ts+1min
newsvisible_at (live: first_seen_at; backfilled: crawl_at + 336 s)
filingslive 8-K / Form 4: acceptance (or first_seen_at if later); date-only filings: 22:00 ET of the date
financialsXBRL facts with filed date <= as_of (filed date counts from 22:00 ET)
macroALFRED vintage at as_of; daily FRED series: value dated X visible from X+1 17:00 ET; Treasury curve from 18:00 ET (backfill) / first seen (live); monthly releases after 16:00 ET on release day for the daily cut
eventscluster/member first_seen_at; partial clusters re-derive direction and summary from visible members
returnsonly horizons whose end session closed before as_of
featuresrow D uses only data visible at D 16:00 ET; rows computed after as_of are recomputed
digestas_of capped at the end of the session day; each section follows its source rule

Licence

Every record carries a license field, one of:

sec_publicSEC EDGAR, public
us_gov_publicUS federal agencies / Federal Reserve Board, public
cleveland_fed_publicCleveland Fed nowcast, public
tiingo_licensedTiingo news/prices, licensed for redistribution (was tiingo_internal before 2026-10-19)
fed_bankregional Reserve Bank / FRED-computed series (terms of use)
third_partycopyrighted series redistributed by FRED (ICE BofA, Cboe, Moody's, UMich, S&P, NAR, Freddie Mac)
wire_rss_summarypress-release RSS summaries

Not covered yet

  • news history starts 2026-04-19
  • Form 4 before 2026-10-16 arrives with the fadata history (2026-10-23)
  • IEX 1-minute bars from 2026-10-19, focus list only
  • fundamentals: SEC XBRL filers only (no ADRs / funds)
  • analyst signals come from news stance (no broker feed, no consensus)
103 macro series, read as macro:<id>
idfreqseries · license
A191RL1Q225SBEAQReal Gross Domestic Product us_gov_public
AAAMMoody's Seasoned Aaa Corporate Bond Yield third_party
AWHAETPMAverage Weekly Hours of All Employees, Total Private us_gov_public
BAAMMoody's Seasoned Baa Corporate Bond Yield third_party
BAMLC0A0CMDICE BofA US Corporate Index Option-Adjusted Spread third_party
BAMLH0A0HYM2DICE BofA US High Yield Index Option-Adjusted Spread third_party
BAMLH0A0HYM2EYDICE BofA US High Yield Index Effective Yield third_party
BUSLOANSMCommercial and Industrial Loans, All Commercial Banks us_gov_public
CCSAWContinued Claims (Insured Unemployment) us_gov_public
CES0500000003MAverage Hourly Earnings of All Employees, Total Private us_gov_public
CFNAIMChicago Fed National Activity Index fed_bank
CIVPARTMLabor Force Participation Rate us_gov_public
CPIAUCSLMConsumer Price Index for All Urban Consumers: All Items in U.S. City Average us_gov_public
CPILFESLMConsumer Price Index for All Urban Consumers: All Items Less Food and Energy in U.S. City Average us_gov_public
CSUSHPISAMS&P Cotality Case-Shiller U.S. National Home Price Index third_party
DCOILBRENTEUDCrude Oil Prices: Brent - Europe us_gov_public
DCOILWTICODCrude Oil Prices: West Texas Intermediate (WTI) - Cushing, Oklahoma us_gov_public
DEXCHUSDChinese Yuan Renminbi to U.S. Dollar Spot Exchange Rate us_gov_public
DEXJPUSDJapanese Yen to U.S. Dollar Spot Exchange Rate us_gov_public
DEXUSEUDU.S. Dollars to Euro Spot Exchange Rate us_gov_public
DFEDTARLDFederal Funds Target Range - Lower Limit us_gov_public
DFEDTARUDFederal Funds Target Range - Upper Limit us_gov_public
DFFDFederal Funds Effective Rate us_gov_public
DFII10DMarket Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis, Inflation-Indexed us_gov_public
DGORDERMManufacturers' New Orders: Durable Goods us_gov_public
DGS1DMarket Yield on U.S. Treasury Securities at 1-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS10DMarket Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS1MODMarket Yield on U.S. Treasury Securities at 1-Month Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS2DMarket Yield on U.S. Treasury Securities at 2-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS20DMarket Yield on U.S. Treasury Securities at 20-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS3DMarket Yield on U.S. Treasury Securities at 3-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS30DMarket Yield on U.S. Treasury Securities at 30-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS3MODMarket Yield on U.S. Treasury Securities at 3-Month Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS5DMarket Yield on U.S. Treasury Securities at 5-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS6MODMarket Yield on U.S. Treasury Securities at 6-Month Constant Maturity, Quoted on an Investment Basis us_gov_public
DGS7DMarket Yield on U.S. Treasury Securities at 7-Year Constant Maturity, Quoted on an Investment Basis us_gov_public
DHHNGSPDHenry Hub Natural Gas Spot Price us_gov_public
DPRIMEDBank Prime Loan Rate us_gov_public
DSPIC96MReal Disposable Personal Income us_gov_public
DTB3D3-Month Treasury Bill Secondary Market Rate, Discount Basis us_gov_public
DTWEXBGSDNominal Broad U.S. Dollar Index us_gov_public
ECIALLCIVQEmployment Cost Index: Total compensation: All Civilian us_gov_public
EFFRDEffective Federal Funds Rate fed_bank
EXHOSLUSM495SMExisting Home Sales third_party
GDPQGross Domestic Product us_gov_public
GDPC1QReal Gross Domestic Product us_gov_public
GDPNOWQGDPNow fed_bank
HOUSTMNew Privately-Owned Housing Units Started: Total Units us_gov_public
HSN1FMNew One Family Houses Sold: United States us_gov_public
ICSAWInitial Claims us_gov_public
INDPROMIndustrial Production: Total Index us_gov_public
IORBDInterest Rate on Reserve Balances (IORB Rate) us_gov_public
JTSJOLMJob Openings: Total Nonfarm us_gov_public
M2SLMM2 us_gov_public
MICHMUniversity of Michigan: Inflation Expectation third_party
MORTGAGE15USW15-Year Fixed Rate Mortgage Average in the United States third_party
MORTGAGE30USW30-Year Fixed Rate Mortgage Average in the United States third_party
NEWORDERMManufacturers' New Orders: Nondefense Capital Goods Excluding Aircraft us_gov_public
NFCIWChicago Fed National Financial Conditions Index fed_bank
PAYEMSMAll Employees, Total Nonfarm us_gov_public
PCEMPersonal Consumption Expenditures us_gov_public
PCEPIMPersonal Consumption Expenditures: Chain-type Price Index us_gov_public
PCEPILFEMPersonal Consumption Expenditures Excluding Food and Energy (Chain-Type Price Index) us_gov_public
PERMITMNew Privately-Owned Housing Units Authorized in Permit-Issuing Places: Total Units us_gov_public
PPIACOMProducer Price Index by Commodity: All Commodities us_gov_public
PPIFISMProducer Price Index by Commodity: Final Demand us_gov_public
PSAVERTMPersonal Saving Rate us_gov_public
RRPONTSYDDOvernight Reverse Repurchase Agreements: Treasury Securities Sold by the Federal Reserve in the Temporary Open Market Operations fed_bank
RSAFSMAdvance Retail Sales: Retail Trade and Food Services us_gov_public
RSXFSMAdvance Retail Sales: Retail Trade us_gov_public
SAHMREALTIMEMReal-time Sahm Rule Recession Indicator fed_bank
SOFRDSecured Overnight Financing Rate fed_bank
STLFSI4WSt. Louis Fed Financial Stress Index fed_bank
T10Y2YD10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity fed_bank
T10Y3MD10-Year Treasury Constant Maturity Minus 3-Month Treasury Constant Maturity fed_bank
T10YIED10-Year Breakeven Inflation Rate fed_bank
T5YIED5-Year Breakeven Inflation Rate fed_bank
T5YIFRD5-Year, 5-Year Forward Inflation Expectation Rate fed_bank
TCUMCapacity Utilization: Total Index us_gov_public
TOTALSAMTotal Vehicle Sales us_gov_public
TOTBKCRWBank Credit, All Commercial Banks us_gov_public
U6RATEMTotal Unemployed, Plus All Persons Marginally Attached to the Labor Force, Plus Total Employed Part Time for Economic Reasons, as a Percent of the Civilian Labor Force Plus All Persons Marginally Attached to the Labor Force (U-6) us_gov_public
UMCSENTMUniversity of Michigan: Consumer Sentiment third_party
UNRATEMUnemployment Rate us_gov_public
USRECMNBER based Recession Indicators for the United States from the Period following the Peak through the Trough third_party
VIXCLSDCBOE Volatility Index: VIX third_party
VXNCLSDCBOE NASDAQ 100 Volatility Index third_party
WALCLWAssets: Total Assets: Total Assets (Less Eliminations from Consolidation): Wednesday Level us_gov_public
WRESBALWLiabilities and Capital: Other Factors Draining Reserve Balances: Reserve Balances with Federal Reserve Banks: Week Average us_gov_public
WTREGENWLiabilities and Capital: Liabilities: Deposits with F.R. Banks, Other Than Reserve Balances: U.S. Treasury, General Account: Week Average us_gov_public
UST_PAR_1MDTreasury par yield 1M us_gov_public
UST_PAR_2MDTreasury par yield 2M us_gov_public
UST_PAR_3MDTreasury par yield 3M us_gov_public
UST_PAR_4MDTreasury par yield 4M us_gov_public
UST_PAR_6MDTreasury par yield 6M us_gov_public
UST_PAR_1YDTreasury par yield 1Y us_gov_public
UST_PAR_2YDTreasury par yield 2Y us_gov_public
UST_PAR_3YDTreasury par yield 3Y us_gov_public
UST_PAR_5YDTreasury par yield 5Y us_gov_public
UST_PAR_7YDTreasury par yield 7Y us_gov_public
UST_PAR_10YDTreasury par yield 10Y us_gov_public
UST_PAR_20YDTreasury par yield 20Y us_gov_public
UST_PAR_30YDTreasury par yield 30Y us_gov_public

Events are rebuilt every hour from :40 to :55, and answers can be slower then. If the upstream service is down the gateway answers 503 domain_unavailable and charges nothing.

Read

GET/v1/stocks/read/{id}
Three depths. detail is the default. Free sample: AAPL.

Levels

levelcreditsreturns
brief1Ticker overview: latest price, recent events, news, filings
detail (default)1Ticker overview: latest price, recent events, news, filings
full2Ticker digest input (every item carries a citable id; built on demand, ~45 s)

Extras

One side of the same document, in place of a level.

extracreditsreturns
prices1Prices: interval=1d | 1m (IEX minute bars)
financials1Financials (XBRL, as filed; later restatements hidden)
events1Events (merged from news / 8-K / Form 4)
news1News
filings1SEC filings
insiders1Insider open-market trades (Form 4 P/S)
features2Features (price / event derived)

Parameters

ParameterTypeDescription
id (path) REQUIRED string Document id (id).
level brief · detail · full= detail How deep to read.
extra prices · financials · events · news · filings · insiders · features Read one side instead of a level.
format json · md · html= json Response shape.
date string 交易日 (level = brief)
as_of string Point in time: ISO date or datetime (no zone = America/New_York; date only = end of that ET day). Only data visible at that moment (level = brief)
from string 起(日期或时间) (extra = prices)
to string 止 (extra = prices)
limit integer 条数(1–200) (extra = prices)
interval string= 1d 1d | 1m (extra = prices)
fields string 只取这些字段 (extra = prices)
period string= quarterly quarterly | annual (extra = financials)
type string 事件类型 (extra = events)
with_returns string 1 = 带收益标签 (extra = events)
kind string 新闻类型 (extra = news)
form string 表格类型,逗号分隔 (extra = filings)
side string buy | sell (extra = insiders)
min_value string 最小金额 (extra = insiders)

Example

{ "domain": "stocks", "id": "AAPL", "level": "detail", "view": "ticker_brief", "data": { … } | "text": "…", "token_count": 1834, "meta": { … } }
The older GET /v1/stocks/doc/{id}?view=… still works.

Read many

POST/v1/stocks/read
Up to 50 ids, one level. Missing ids come back with error: "not_found" and are not charged.

Parameters

ParameterTypeDescription
ids REQUIRED string[] Document ids.
level brief · detail · full= detail Level for every id.
extra prices · financials · events · news · filings · insiders · features Read one side instead.

Example

{ "domain": "stocks", "level": "detail", "docs": [ { "id": "…", "data": { … } }, { "id": "…", "error": "not_found" } ], "meta": { … } }

Facets

GET/v1/stocks/facets?field={field}
Legal values for a filter field, so an agent never guesses; precomputed fields carry counts, declared enums come without. Free, no key.

Parameters

ParameterTypeDescription
field REQUIRED source · news_kind · form · event_type · semantic · side Filter field with facets.
limit integer= 50 Max values.

Example

{ "domain": "stocks", "field": "…", "values": [ { "value": "…", "count": 3120 } ], "meta": { … } }

Askregistered key+ /stream

POST/v1/stocks/ask
Ask about US equities: companies by theme, a ticker's prices and news flow, events, insider trades, financials, macro; questions about a past moment are answered as_of that moment. Citations are upstream record ids ([stocks: title]); answers end with data sources and a not-investment-advice note. effort low / medium / high = 50 / 100 / 200 credits. Append /stream for NDJSON; the first event is always billing. A failure before the first answer_delta is refunded.

Parameters

ParameterTypeDescription
query REQUIRED string 1–2000 characters. Be specific; ask for numbers if you want numbers.
effort low · medium · high= low Reading rounds, and the price: 50 / 100 / 200 credits. Your plan caps it.
verbose bool= false Include the tool-call trace (tool_call / tool_result / thinking events when streaming).
top_k integer= 10 Speculative prefetch size.
stream_answer bool= true Streaming only: false emits one answer event instead of deltas.
max_rounds integer 0–8, overrides the effort preset.
force_answer_after number Seconds; hard cutover into the answer phase.
max_answer_tokens integer= 4096 Hitting it sets answer_truncated.
language string Answer language; defaults to the query’s.

Example

{ "answer": "… 上游每条记录的 id(px: / evt_ / news: / filing: / form4: / fin: / macro:…@vintage)原样引用,并注明 license …", "sources": [ … ], "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false }, "coverage"?: { … }, "meta": { "credits": { "charged": 50, … } } }
Citations are real — every id in answer exists in this domain (format 上游每条记录的 id(px: / evt_ / news: / filing: / form4: / fin: / macro:…@vintage)原样引用,并注明 license). sources is the retrieval set, not the citation list. answer_truncated means incomplete.