DEV Community

Cover image for How I Built a Live Stock Market AI Agent in ~40 Lines of TypeScript
Valyu AI profile image Prosper Otemuyiwa
Prosper Otemuyiwa for Valyu AI

Posted on

How I Built a Live Stock Market AI Agent in ~40 Lines of TypeScript

#ai #agents #typescript #valyu

I got tired of jumping between Yahoo Finance, a broker dashboard, and a Google News tab every time I wanted a quick read on a stock. What I actually wanted: type a question, get a grounded answer that pulls live prices, recent earnings, and current news in one shot.

Turns out you can wire this up in an afternoon with Vercel AI SDK and Valyu's financeSearch + webSearch tools. Here's how.

What we're building

A Node.js CLI agent you run like this:

npx tsx agent.ts "What's happening with NVDA? Give me price, recent earnings, and any news I should know about."
Enter fullscreen mode Exit fullscreen mode

It streams back a real answer, not a hallucinated one, pulled from live financial data and current web sources.

Setup

You need two things:

  1. A Valyu API key - free $10 credit when you sign up at platform.valyu.ai
  2. An Anthropic API key (or swap in OpenAI/any other AI SDK provider) 
pnpm add ai @ai-sdk/anthropic @valyu/ai-sdk
Enter fullscreen mode Exit fullscreen mode

Create a .env file:

VALYU_API_KEY=your-valyu-key
ANTHROPIC_API_KEY=your-anthropic-key
Enter fullscreen mode Exit fullscreen mode

The agent 

// agent.ts
import { streamText, stepCountIs } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
import { financeSearch, webSearch } from "@valyu/ai-sdk";

const query = process.argv[2] ?? "What's the current price and outlook for AAPL?";

const result = streamText({
  model: anthropic("claude-3-5-sonnet-20241022"),
  messages: [
    {
      role: "system",
      content: `You are a stock market analyst with access to live financial data and web search.
- Use financeSearch for stock prices, earnings, dividends, balance sheets, and insider transactions
- Use webSearch for recent news, analyst sentiment, and market context
- Always cite sources
- Be specific: include actual numbers, dates, and figures from your search results`,
    },
    {
      role: "user",
      content: query,
    },
  ],
  tools: {
    financeSearch: financeSearch(),
    webSearch: webSearch(),
  },
  stopWhen: stepCountIs(5),
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

console.log("\n");
Enter fullscreen mode Exit fullscreen mode

That's the whole thing. The agent loop is handled by stepCountIs(5), the model keeps calling tools until it has enough data to answer, up to 5 steps.

How it works

When you run it, the agent:

  1. Receives your question
  2. Decides which tools to call (financeSearch, webSearch, or both)
  3. Gets results back. Real prices, actual earnings figures, live news
  4. Synthesizes an answer with citations
  5. Streams it back token by token

The financeSearch tool pulls from stock prices, earnings reports, income statements, balance sheets, dividend history, and insider transaction data. webSearch covers current news, analyst coverage, and anything else on the open web.

For a query like "What's happening with NVDA?" you'd typically see it call financeSearch for price and recent earnings, then webSearch for news about data center demand or any recent analyst upgrades, then combine them into a coherent analysis.

Extending it

A few directions from here:

Add more tools for deeper research:

import { secSearch, economicsSearch } from "@valyu/ai-sdk";

tools: {
  financeSearch: financeSearch(),
  webSearch: webSearch(),
  sec: secSearch(),          // 10-K, 10-Q, 8-K filings
  economics: economicsSearch(), // FRED, BLS macro data
},
Enter fullscreen mode Exit fullscreen mode

Compare multiple tickers:

content: "Compare MSFT and GOOGL on trailing P/E, revenue growth, and recent earnings beats"
Enter fullscreen mode Exit fullscreen mode

The agent will run parallel searches and give you a side-by-side.

Control costs with config options:

financeSearch({
  maxNumResults: 5,        // fewer results = lower cost
  relevanceThreshold: 0.8, // only high-quality matches
})
Enter fullscreen mode Exit fullscreen mode

What the data actually covers

financeSearch isn't just price tickers. It pulls from:

  • Historical and real-time stock, crypto, and forex prices
  • Earnings per share, revenue, and guidance
  • Balance sheets, income statements, cash flow
  • Insider buy/sell transactions (Form 4 data)
  • Dividend history

So queries like "How have TSLA insiders been trading over the last 6 months?" or "What's Apple's free cash flow trend since 2021?" work out of the box.

Running it 

npx tsx agent.ts "Is AMD a buy right now? Give me current price, latest earnings, and analyst sentiment."
Enter fullscreen mode Exit fullscreen mode

Sample output (abridged):

AMD is currently trading at $X.XX, down X% today...

Recent Earnings (Q4 2024):
- Revenue: $X.XB (beat estimates by X%)
- EPS: $X.XX vs $X.XX expected
- Data center segment grew XX% YoY...

Analyst Sentiment:
According to recent coverage from [source], consensus is...
Enter fullscreen mode Exit fullscreen mode

The numbers are real. The sources are cited. No hallucination.

The Underlying API

Under the hood, @valyu/ai-sdk is a thin wrapper around Valyu's DeepSearch API. If you want to build a custom tool, one that only searches specific financial sources, you can drop down to the raw tool() from the AI SDK:

import { tool } from "ai";
import { z } from "zod";

const cryptoSearch = tool({
  description: "Search cryptocurrency price and market data",
  inputSchema: z.object({
    query: z.string(),
  }),
  execute: async ({ query }) => {
    const response = await fetch("https://api.valyu.ai/v1/search", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-key": process.env.VALYU_API_KEY,
      },
      body: JSON.stringify({
        query,
        search_type: "proprietary",
        included_sources: ["valyu/valyu-crypto"],
        max_num_results: 5,
      }),
    });
    return response.json();
  },
});
Enter fullscreen mode Exit fullscreen mode

Full list of available sources and parameters at docs.valyu.ai.

Code

Full example is a single file, agent.ts , above is all you need. If you build something on top of this, the main things to think about are:

  • System prompt quality matters a lot for financial queries. Be explicit about what each tool is for
  • stepCountIs(5) is usually enough for single-stock analysis; bump to 8-10 for comparative research
  • Stream the output for better UX - streamText over generateText

The Valyu finance data covers benchmarks like 73% accuracy on 120 finance questions vs 55% for Google search, which matters when you're asking specific questions about earnings or insider activity where precision is the point.

Top comments (2)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.