// vercel ai sdk

Market data tools for
the Vercel AI SDK.

Register TickerDB methods as AI SDK tools. Your language model gets access to live market summaries, watchlists, and ticker event history — grounding financial responses in real data.

try for free read the docs

// setup

Install the dependencies.

Add the TickerDB SDK alongside the Vercel AI SDK.

terminal

npm install tickerdb ai @ai-sdk/openai

Set TICKERDB_KEY in your environment variables. The SDK reads it automatically.

// usage

Register tools. Stream responses.

Define TickerDB methods as AI SDK tools with typed parameters. The model calls them automatically when it needs market data.

Tool Registration lib/market-tools.ts

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

const client = new TickerDB(process.env.TICKERDB_KEY);

export const marketTools = {
  getSummary: tool({
    description: "Get a market summary for a ticker",
    parameters: z.object({
      ticker: z.string().describe("Stock ticker symbol"),
    }),
    execute: async ({ ticker }) => client.getSummary(ticker),
  }),
  getSummaryEvents: tool({
    description: "Ticker event history via summary field/band filters",
    parameters: z.object({
      ticker: z.string().describe("Stock ticker symbol"),
      field: z.string().default("rsi_zone"),
      band: z.string().default("deep_oversold"),
    }),
    execute: async ({ ticker, field, band }) => client.getSummary(ticker, { field, band }),
  }),
};

API Route app/api/chat/route.ts

import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";
import { marketTools } from "@/lib/market-tools";

export async function POST(req) {
  const { messages } = await req.json();

  const result = streamText({
    model: openai("gpt-4o"),
    messages,
    tools: marketTools,
  });

  return result.toDataStreamResponse();
}

// agent workflow

Multi-step analysis.

Your model can chain tool calls — get a full summary, use summary event mode for historical context, then pull another ticker for comparison. Each call returns categorical data the model understands without extra prompting.

getSummary(ticker: "INTC")

Full categorical snapshot for the ticker

getSummaryEvents(ticker: "INTC", field: "rsi_zone", band: "deep_oversold")

Historical ticker events with aftermath

getSummary(ticker: "AMD")

Compare by pulling a second summary

// state changes

Track state changes effortlessly.

Most market data APIs return point-in-time snapshots. TickerDB tracks state transitions — your agent sees what changed, not just what is.

json

{
  "ticker": "AAPL",
  "changes": [
    {
      "field": "rsi_zone",
      "from": "neutral",
      "to": "oversold"
    },
    {
      "field": "trend",
      "from": "uptrend",
      "to": "downtrend"
    }
  ]
}

// what your agent sees

What your agent sees.

Every tool returns categorical facts — not raw OHLCV data. Your agent can branch on "oversold" without needing to know what RSI > 70 means.

json

{
  "ticker": "NVDA",
  "trend": "strong_uptrend",
  "momentum": {
    "rsi_zone": "overbought",
    "macd_signal": "bullish"
  },
  "volatility": "high",
  "fundamentals": {
    "pe_zone": "above_historical_avg",
    "earnings_surprise": "positive"
  }
}