Skip to main content
Search markets, fundamentals, filings, macro data, and regulatory signals through one API. Built for investment research, diligence, monitoring, and compliance - with structured data and full-text filings side by side.

What you can do

Investment research

Earnings, fundamentals, valuation comps, and guidance analysis.

Market monitoring

Real-time movers, prices, crypto/forex, and insider activity.

Filings and ownership

10-K/10-Q/8-K, 13F holdings, 13D/13G ownership, insider transactions.

Macro and compliance

FRED, IMF, World Bank, BLS macro via Search; sanctions screening via DeepResearch.

Sources

Markets and fundamentals (subscription)

SourceContent
valyu/valyu-stocks, valyu/valyu-crypto, valyu/valyu-forexGlobal stock, crypto, and FX prices
valyu/valyu-etfs, valyu/valyu-funds, valyu/valyu-commoditiesETFs, mutual funds, commodity futures
valyu/valyu-market-movers-USBiggest gainers, losers, most active
valyu/valyu-earnings-US, valyu/valyu-earnings-calendar-USQuarterly/annual earnings and calendar
valyu/valyu-statistics-USKey ratios and metrics
valyu/valyu-balance-sheet-US, -income-statement-US, -cash-flow-USFull financial statements
valyu/valyu-dividends-US, valyu/valyu-insider-transactions-USDividends, Form 4 insider trades

Filings, macro, and signals (subscription)

SourceContent
valyu/valyu-sec-filings10-K, 10-Q, 8-K, 13F, 13D/13G, S-4, DEF 14A
Patents: patents (USPTO), patents-epo (EPO)IP filings and prior art
Prediction markets: Polymarket, KalshiEvent-probability signals
Macro: valyu/valyu-fred, imf, valyu/valyu-worldbank-indicators, valyu/valyu-bls, valyu/valyu-usaspendingRates, GDP, inflation, labour, federal spend

DeepResearch only

These high-signal sources are not searchable datasets - reach them by running a DeepResearch task (POST /v1/deepresearch/tasks) with the topic in your query. Calling search() with them will fail.
SourceContent
Short-seller reports, buyside lettersActivist and fund research
Sanctions: OFAC SDN, UN, UK HMT, INTERPOLCompliance and screening
FDIC BankFindBank charters, financials, failures
Semiconductor industry newsSupply-chain and chip-sector signals
Web search and open academic sources are on every plan. Subscription datasets are searchable via the Search and Answer API; a subscription also lowers your cost per credit. See pricing and the data catalog.

Quick start

Let Valyu route to the right datasets automatically:
from valyu import Valyu

valyu = Valyu("your-api-key-here")
response = valyu.search("Apple's latest quarterly earnings and revenue growth trends")
print(response)

SEC filings, holdings and ownership

Search 3M+ filings in natural language - no accession numbers, CIK codes, or tickers required.
  • 10-K / 10-Q / 8-K - financials, MD&A, risk factors, material events
  • 13F-HR - institutional holdings from funds with $100M+ AUM
  • SC 13D / 13G - activist (13D) and passive (13G) 5%+ ownership stakes
  • Ask for a specific section (“risk factors”, “MD&A”), a time period (“FY2024”, “Q3 2023”), or set response_length="max" for an entire filing (up to ~400k characters)
# Specific section
risk_factors = valyu.search("Apple 10-K risk factors section")

# Entire filing
full_filing = valyu.search("Tesla 10-K FY2024", response_length="max")

# Institutional holdings and activist ownership
holdings = valyu.search("Goldman Sachs 13F-HR holdings report")
activist = valyu.search("13D filings for Apple")

# Insider transactions (Form 4)
insider = valyu.search("insider transactions for Pfizer during 2020")
13D vs 13G: both report 5%+ stakes. 13D signals activist intent; 13G is passive. A new 13D often flags a potential activist campaign - useful for event-driven strategies.
For metrics (ratios, earnings comps, balance sheets) pin structured datasets like valyu/valyu-statistics-US. For qualitative context (strategy, risk factors, MD&A) use valyu/valyu-sec-filings, or let Valyu route across both.

DeepResearch-only signals

Sanctions screening, short-seller reports, buyside letters, FDIC BankFind, and semiconductor news are not searchable datasets - run a DeepResearch task with the topic in your query and the agent pulls the relevant source.
from valyu import Valyu

valyu = Valyu("your-api-key-here")

task = valyu.deepresearch.create(
    query="Screen Acme Corp and its directors against OFAC SDN, UN, and UK HMT sanctions lists",
)
result = valyu.deepresearch.wait(task.deepresearch_id)
print(result.output)

Build a finance research agent

Wire Valyu into an AI agent for finance - filings, fundamentals, macro, and diligence.

Open in Cursor

Repeatable analyses with Workflows

Recurring work maps onto DeepResearch Workflows - templated research you re-run with new inputs, like an earnings-preview pack by ticker and quarter, a company diligence deep-dive, or a TAM/SAM/SOM market sizing by sector.

Limitations

  • Market data may carry a 1-5 minute delay.
  • Some structured datasets currently cover US markets.
  • Sanctions, short-seller reports, buyside letters, FDIC BankFind, and semiconductor news are DeepResearch-only, not direct Search.