Access comprehensive financial intelligence with Valyu’s DeepSearch API. From real-time market data and earnings reports to SEC filings and regulatory updates, Valyu provides financial professionals with authoritative market information and structured financial datasets.

​
Why Financial Search Matters

Financial search on Valyu provides real-time, authoritative market data that enables:
  • 📈 Investment Research - Access earnings, financial statements, and market trends
  • 📊 Risk Assessment - Monitor market conditions and regulatory changes
  • 💼 Portfolio Management - Track holdings and performance metrics
  • 🏛️ Compliance Monitoring - Stay updated on regulatory filings and requirements

​
Key Financial Features

Real-Time Market Data

Live Market IntelligenceAccess current stock prices, crypto rates, forex data, and market movers as they happen.

Structured Financial Data

Clean Financial MetricsGet organized earnings data, balance sheets, income statements, and cash flows.

Regulatory Filings

SEC Documents & ComplianceSearch through 10-K, 10-Q, 8-K filings and regulatory announcements.

Market Intelligence

Advanced AnalyticsInsider transactions, dividend data, and institutional activity tracking.

​
Available Financial Datasets

Valyu provides comprehensive financial data through specialized datasets:

​
Market Data

DatasetContentUse Case
valyu/valyu-stocks-USReal-time US stock prices (NASDAQ & NYSE)Live market monitoring
valyu/valyu-cryptoCryptocurrency prices for major digital assetsCrypto trading and analysis
valyu/valyu-forexForeign exchange rates and currency dataCurrency trading and hedging

​
Fundamental Analysis

DatasetContentUse Case
valyu/valyu-earnings-USQuarterly and annual earnings dataPerformance analysis
valyu/valyu-statistics-USKey financial metrics and ratiosQuick company metrics
valyu/valyu-balance-sheet-USComplete balance sheet dataFinancial health analysis
valyu/valyu-income-statement-USRevenue, expenses, profitability metricsProfitability assessment
valyu/valyu-cash-flow-USOperating, investing, financing activitiesLiquidity analysis
valyu/valyu-dividends-USHistorical and projected dividend informationIncome investing

​
Market Intelligence

DatasetContentUse Case
valyu/valyu-insider-transactions-USExecutive and institutional trading activitySentiment analysis
valyu/valyu-market-movers-USBiggest gainers, losers, most active stocksMarket trend identification

​
Regulatory & Compliance

DatasetContentUse Case
valyu/valyu-sec-filingsSEC documents and regulatory filingsCompliance and deep research
Data Selection Tip: Use structured datasets (earnings, balance sheets) for financial metrics. Use SEC filings for detailed regulatory context and qualitative analysis.

​
Quick Start Examples

Let Valyu automatically find the best datasets for your financial queries: 
from valyu import Valyu

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

# Valyu automatically searches relevant financial datasets
response = valyu.search(
    query="Apple's latest quarterly earnings and revenue growth trends"
)

print(response)

​
Real-Time Market Data

Access current market conditions and trading activity: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="today's biggest stock gainers and notable insider trading activity"
)

# Crypto and forex data
crypto_response = valyu.search(
    query="Bitcoin price trends this week and current EUR/USD exchange rate"
)

​
Company Financial Analysis

Get comprehensive financial statements and metrics: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="Tesla's latest income statement and cash flow analysis Q4 2024"
)

# Specific company performance
performance = valyu.search(
    query="Microsoft stock price performance and recent quarterly results"
)

​
Advanced Financial Analysis

When you need precise control over data sources: 
from valyu import Valyu

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

# Limit to specific earnings data
earnings_only = valyu.search(
    query="Tesla quarterly earnings",
    included_sources=["valyu/valyu-earnings-US"]
)

# Combine multiple financial datasets
comprehensive = valyu.search(
    query="Microsoft financial performance analysis",
    included_sources=[
        "valyu/valyu-income-statement-US",
        "valyu/valyu-balance-sheet-US",
        "valyu/valyu-cash-flow-US"
    ]
)

​
SEC Filings and Regulatory Research

Access detailed regulatory documents with natural language: 
from valyu import Valyu

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

# Annual report analysis
annual_report = valyu.search(
    query="show me Tesla's annual report business strategy section"
    response_length="max" # If you want the full filing, set this to "max"
)

# Risk factor analysis
risk_factors = valyu.search(
    query="get Apple's risk factors from their latest 10-K filing"
)

# Competitive analysis
competition = valyu.search(
    query="find mentions of AI strategy in Microsoft's 2024 SEC filings"
)
The default response length is 25000 characters which may be too short for some full SEC filings. If you want the full filing, set response_length to “max” as in the Python example. Be aware that full filings can go up to 400,000 characters or approximately 100,000 tokens. Retrieve full filings only if you are confident that the context window supports it.

​
Market News and Analysis

Combine authoritative financial news sources: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="Federal Reserve interest rate policy impact on banking sector",
    included_sources=[
        "bloomberg.com",
        "reuters.com", 
        "wsj.com",
        "federalreserve.gov"
    ]
)

​
Use Case Examples

​
📊 Investment Research

Comprehensive analysis for investment decisions: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="NVIDIA financial performance GPU market share competitive position 2024",
    max_num_results=15
)

# Include analyst perspectives
analyst_view = valyu.search(
    query="NVIDIA stock analyst ratings price targets Q4 2024",
    included_sources=[
        "bloomberg.com",
        "reuters.com",
        "marketwatch.com"
    ]
)

​
💰 Portfolio Management

Monitor holdings and market performance: 
from valyu import Valyu

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

# Portfolio company earnings
portfolio_earnings = valyu.search(
    query="Apple Microsoft Tesla quarterly earnings results 2024"
)

# Dividend analysis
dividend_stocks = valyu.search(
    query="high dividend yield stocks quarterly payments 2024",
    included_sources=["valyu/valyu-dividends-US"]
)

​
🏛️ Regulatory Compliance

Stay informed on regulatory changes and requirements: 
from valyu import Valyu

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

# Regulatory updates
reg_updates = valyu.search(
    query="SEC cryptocurrency regulation banking industry impact 2024",
    included_sources=[
        "sec.gov",
        "federalreserve.gov",
        "reuters.com/business"
    ]
)

# Compliance requirements
compliance = valyu.search(
    query="new ESG reporting requirements public companies 2024"
)

​
🌐 Market Intelligence

Track market trends and opportunities: 
from valyu import Valyu

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

# Market sector analysis
sector_analysis = valyu.search(
    query="renewable energy sector growth rates market opportunities 2024"
)

# Insider trading patterns
insider_activity = valyu.search(
    query="technology sector insider buying activity large transactions",
    included_sources=["valyu/valyu-insider-transactions-US"]
)

​
Data Type Selection Guide

Efficiency Tip: Choose the right dataset for your needs. Structured datasets provide clean metrics, while SEC filings offer detailed context.

​
When to Use Structured Datasets

✅ Use structured datasets for:
  • Quick financial ratios and metrics
  • Earnings comparisons across quarters
  • Balance sheet analysis
  • Cash flow tracking
  • Dividend history
# Efficient for financial metrics
response = valyu.search(
    query="Apple P/E ratio debt-to-equity current ratio",
    included_sources=["valyu/valyu-statistics-US"]
)

​
When to Use SEC Filings

✅ Use SEC filings for:
  • Detailed business strategy analysis
  • Risk factor assessment
  • Management discussion and analysis (MD&A)
  • Competitive positioning
  • Qualitative business insights
# Rich context from regulatory documents
response = valyu.search(
    query="Tesla's business strategy and competitive advantages analysis"
    # Automatically searches SEC filings for detailed context
)

​
Best Practices

Search Strategy: Start with descriptive prompts and let Valyu automatically find relevant datasets. Use included_sources only when you need to restrict results to specific data types.

​
Effective Financial Queries

Query TypeEffective ExampleWhy It Works
Earnings Analysis”Apple Q4 2024 earnings revenue growth year-over-year”Specific company, timeframe, and metrics
Market Trends”Stock performance biggest gainers today”Clear sector focus with current data
Financial Health”Tesla balance sheet debt levels cash position”Specific financial statement and metrics
Regulatory Impact”Federal Reserve rate hikes impact on banking stocks”Event context with sector focus

​
Strategic Source Selection

For Market Analysis: 
# Authoritative financial news
included_sources = [
    "bloomberg.com",
    "reuters.com/business", 
    "wsj.com",
    "marketwatch.com"
]
For Company Fundamentals: 
# Structured financial data
included_sources = [
    "valyu/valyu-earnings-US",
    "valyu/valyu-statistics-US",
    "valyu/valyu-balance-sheet-US"
]
For Regulatory Research: 
# Government and regulatory sources
included_sources = [
    "sec.gov",
    "federalreserve.gov",
    "treasury.gov"
]

​
Research Performance Optimisation

  1. Descriptive Queries: Use financial terminology to trigger relevant datasets automatically
  2. Company Specificity: Include company names or ticker symbols for targeted results
  3. Time Context: Add “latest,” “Q4 2024,” or “recent” for current data
  4. Metric Focus: Specify financial metrics like “earnings,” “revenue,” or “cash flow”

​
Financial Workflow Integration

​
Investment Analysis Pipeline

from valyu import Valyu

def analyze_investment_opportunity(ticker, company_name):
    valyu = Valyu(api_key="your-valyu-api-key")
    
    # Financial performance
    financials = valyu.search(
        query=f"{company_name} latest quarterly earnings financial performance"
    )
    
    # Market sentiment
    news = valyu.search(
        query=f"{company_name} stock analyst ratings market sentiment",
        included_sources=["bloomberg.com", "reuters.com"]
    )
    
    # Regulatory context
    regulatory = valyu.search(
        query=f"{company_name} SEC filings business strategy risk factors"
    )
    
    return {
        "financials": financials,
        "news": news, 
        "regulatory": regulatory
    }

# Usage
analysis = analyze_investment_opportunity("AAPL", "Apple")

​
Limitations and Considerations

  • Data Delays: Market data may have standard delays (1-5 minutes for real-time quotes)
  • Regional Focus: Structured datasets currently cover US markets (NASDAQ, NYSE)
  • Access Levels: Some premium financial content may require institutional subscriptions
Financial search with Valyu provides comprehensive market intelligence and real-time financial data, enabling investment professionals, analysts, and developers to make informed decisions with authoritative, up-to-date market information.