Financial Data API for AI - SEC Filings & Market Data

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)

Source	Content
`valyu/valyu-stocks`, `valyu/valyu-crypto`, `valyu/valyu-forex`	Global stock, crypto, and FX prices
`valyu/valyu-etfs`, `valyu/valyu-funds`, `valyu/valyu-commodities`	ETFs, mutual funds, commodity futures
`valyu/valyu-market-movers-US`	Biggest gainers, losers, most active
`valyu/valyu-earnings-US`, `valyu/valyu-earnings-calendar-US`	Quarterly/annual earnings and calendar
`valyu/valyu-statistics-US`	Key ratios and metrics
`valyu/valyu-balance-sheet-US`, `-income-statement-US`, `-cash-flow-US`	Full financial statements
`valyu/valyu-dividends-US`, `valyu/valyu-insider-transactions-US`	Dividends, Form 4 insider trades

Filings, macro, and signals (subscription)

Source	Content
`valyu/valyu-sec-filings`	10-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, Kalshi	Event-probability signals
Macro: `valyu/valyu-fred`, `imf`, `valyu/valyu-worldbank-indicators`, `valyu/valyu-bls`, `valyu/valyu-usaspending`	Rates, 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.

Source	Content
Short-seller reports, buyside letters	Activist and fund research
Sanctions: OFAC SDN, UN, UK HMT, INTERPOL	Compliance and screening
FDIC BankFind	Bank charters, financials, failures
Semiconductor industry news	Supply-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)

import { Valyu } from "valyu-js";

const valyu = new Valyu("your-api-key-here");
const response = await valyu.search("Apple's latest quarterly earnings and revenue growth trends");
console.log(response);

curl -X POST https://api.valyu.ai/v1/search \
  -H "x-api-key: your-valyu-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Apple latest quarterly earnings and revenue growth trends" }'

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")

const riskFactors = await valyu.search("Apple 10-K risk factors section");
const fullFiling = await valyu.search("Tesla 10-K FY2024", { responseLength: "max" });
const holdings = await valyu.search("Goldman Sachs 13F-HR holdings report");
const activist = await valyu.search("13D filings for Apple");
const insider = await valyu.search("insider transactions for Pfizer during 2020");

curl -X POST https://api.valyu.ai/v1/search \
  -H "x-api-key: your-valyu-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Tesla 10-K FY2024", "response_length": "max" }'

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)

curl -X POST https://api.valyu.ai/v1/deepresearch/tasks \
  -H "x-api-key: your-valyu-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Screen Acme Corp and its directors against OFAC SDN, UN, and UK HMT sanctions lists" }'

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.

Getting Started

Guides & Best Practices

Use Cases

Core Concepts

Compare

Account & Pricing

Other

Finance

What you can do

Investment research

Market monitoring

Filings and ownership

Macro and compliance

Sources

Markets and fundamentals (subscription)

Filings, macro, and signals (subscription)

DeepResearch only

Quick start

SEC filings, holdings and ownership

DeepResearch-only signals

Build a finance research agent

Repeatable analyses with Workflows

Limitations

​What you can do

Investment research

Market monitoring

Filings and ownership

Macro and compliance

​Sources

​Markets and fundamentals (subscription)

​Filings, macro, and signals (subscription)

​DeepResearch only

​Quick start

​SEC filings, holdings and ownership

​DeepResearch-only signals

​Build a finance research agent

​Repeatable analyses with Workflows

​Limitations

What you can do

Sources

Markets and fundamentals (subscription)

Filings, macro, and signals (subscription)

DeepResearch only

Quick start

SEC filings, holdings and ownership

DeepResearch-only signals

Build a finance research agent

Repeatable analyses with Workflows

Limitations