> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valyu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial Data API for AI - Stocks, Crypto, Forex, ETFs

> Access real-time market data through one API. Stock prices, cryptocurrency, forex, ETFs, commodities, and company fundamentals for AI agents and trading applications.

Access real-time financial market data through Valyu's unified API. Stock prices, cryptocurrency, forex, ETFs, commodities, and company fundamentals.

## Available Datasets

### Market Data

| Dataset                   | Description                             | Size            | Updates   |
| ------------------------- | --------------------------------------- | --------------- | --------- |
| `valyu/valyu-stocks`      | Global stock prices across 75 exchanges | 200K+ stocks    | Real-time |
| `valyu/valyu-crypto`      | Cryptocurrency prices and market cap    | 200+ coins      | Real-time |
| `valyu/valyu-forex`       | Foreign exchange rates                  | 180+ pairs      | Real-time |
| `valyu/valyu-etfs`        | ETF prices and data                     | 25K+ ETFs       | Real-time |
| `valyu/valyu-funds`       | Mutual fund prices                      | 10K+ funds      | Real-time |
| `valyu/valyu-commodities` | Commodity futures prices                | 60+ commodities | Real-time |

### Company Fundamentals

| Dataset                               | Description              | Coverage       | Updates   |
| ------------------------------------- | ------------------------ | -------------- | --------- |
| `valyu/valyu-earnings-US`             | Quarterly earnings data  | 10K+ companies | Real-time |
| `valyu/valyu-balance-sheet-US`        | Balance sheet data       | 10K+ companies | Quarterly |
| `valyu/valyu-income-statement-US`     | Income statements        | 10K+ companies | Quarterly |
| `valyu/valyu-cash-flow-US`            | Cash flow statements     | 10K+ companies | Quarterly |
| `valyu/valyu-dividends-US`            | Dividend payment history | 10K+ companies | Daily     |
| `valyu/valyu-insider-transactions-US` | Insider trading activity | 10K+ companies | Daily     |

## Quick Start

<CodeGroup>
  ```python Python theme={null}
  from valyu import Valyu

  valyu = Valyu()

  # Get stock price
  response = valyu.search(
      "NVIDIA stock price today",
      search_type="proprietary",
      included_sources=["valyu/valyu-stocks"],
      max_num_results=1
  )

  print(response.results[0].content)
  ```

  ```javascript JavaScript theme={null}
  import { Valyu } from "valyu-js";

  const valyu = new Valyu();

  // Get stock price
  const response = await valyu.search(
    "NVIDIA stock price today",
    {
      searchType: "proprietary",
      includedSources: ["valyu/valyu-stocks"],
      maxNumResults: 1
    }
  );

  console.log(response.results[0].content);
  ```
</CodeGroup>

## Natural Language Queries

Valyu understands natural language queries for financial data:

```python theme={null}
# These all work:
"Apple stock price last week"
"Bitcoin price since January 2024"
"EUR/USD exchange rate today"
"Gold price year to date"
"Tesla earnings last quarter"
```

## Use Cases

* **Trading signals** - Real-time price data for algorithmic trading
* **Portfolio tracking** - Monitor holdings across asset classes
* **Fundamental analysis** - Access financial statements and metrics
* **Market research** - Track trends and market movements
* **Risk management** - Monitor exposures and correlations

## Combine with SEC Filings

Pair market data with regulatory filings for comprehensive analysis:

```python theme={null}
response = valyu.search(
    "Apple revenue growth guidance",
    search_type="proprietary",
    included_sources=[
        "valyu/valyu-sec-filings",
        "valyu/valyu-earnings-US",
        "valyu/valyu-income-statement-US"
    ],
    max_num_results=15
)
```

## Related Data Sources

<CardGroup cols={2}>
  <Card title="SEC Filings" icon="building-columns" href="/sources/sec-filings">
    3M+ regulatory documents
  </Card>

  <Card title="Economic Data" icon="chart-area">
    FRED, BLS, World Bank indicators
  </Card>
</CardGroup>