// next.js

Market context for
Next.js apps.

Stock market context for Next.js — pre-computed market-state signals, state change tracking, and historical event queries via the TickerDB Node.js SDK. Works in API routes, server components, and server actions.

try for free playground

// setup

Install the SDK.

Add tickerdb to your Next.js project. Works with the App Router and Pages Router.

terminal

npm install tickerdb

Set TICKERDB_KEY in your environment variables and pass it into the client when you initialize it.

// usage

Works where Next.js runs server-side.

Call the SDK in any server context — API routes, server components, server actions. Data never touches the client bundle.

API Route app/api/summary/[ticker]/route.ts

import { TickerDB } from "tickerdb";

const client = new TickerDB({ apiKey: process.env.TICKERDB_KEY! });

export async function GET(
  request: Request,
  { params }: { params: { ticker: string } }
) {
  const { data } = await client.summary(params.ticker);
  return Response.json(data);
}

Server Component app/components/StockCard.tsx

import { TickerDB } from "tickerdb";

const client = new TickerDB({ apiKey: process.env.TICKERDB_KEY! });

export default async function StockCard({ ticker }: { ticker: string }) {
  const { data } = await client.summary(ticker);

  return (
    <div>
      <h2>{ticker}</h2>
      <p>Trend: {data.trend.direction}</p>
      <p>RSI: {data.momentum.rsi_zone}</p>
    </div>
  );
}

// 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.

API Route app/api/watchlist/changes/route.ts

import { TickerDB } from "tickerdb";
import { NextResponse } from "next/server";

const client = new TickerDB({ apiKey: process.env.TICKERDB_KEY! });

export async function GET() {
  const { data } = await client.watchlistChanges();
  return NextResponse.json(data);
}

// Response includes from/to transitions:
// { "ticker": "AAPL", "field": "rsi_zone",
//   "from": "neutral", "to": "oversold" }

json

{
  "timeframe": "daily",
  "run_date": "2026-03-28",
  "changes": {
    "AAPL": [
      {
        "field": "rsi_zone",
        "from": "neutral",
        "to": "oversold"
      },
      {
        "field": "trend_direction",
        "from": "uptrend",
        "to": "downtrend"
      }
    ]
  },
  "ticker_context": {
    "AAPL": {
      "last_changed_date": "2026-03-28"
    }
  },
  "tickers_checked": 2,
  "tickers_changed": 1
}

// ai integration

Feed an AI agent.

TickerDB's categorical-first output is designed for LLMs. Feed a summary directly into a prompt — the model already understands terms like "oversold" and "strong_uptrend" without extra context.

API Route app/api/briefing/[ticker]/route.ts

import { TickerDB } from "tickerdb";
import Anthropic from "@anthropic-ai/sdk";

const ticker = new TickerDB({ apiKey: process.env.TICKERDB_KEY! });
const anthropic = new Anthropic();

export async function GET(
  request: Request,
  { params }: { params: { ticker: string } }
) {
  const { data } = await ticker.summary(params.ticker);

  const message = await anthropic.messages.create({
    model: "claude-sonnet-4-20250514",
    max_tokens: 1024,
    messages: [{
      role: "user",
      content: `Analyze this market data for ${params.ticker} and provide a brief:\n${JSON.stringify(data)}`
    }]
  });

  return Response.json({ analysis: message.content });
}

// 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",
  "data_status": "eod",
  "as_of_date": "2026-04-11",
  "trend": {
    "direction": "strong_uptrend",
    "ma_alignment": "aligned_bullish"
  },
  "momentum": {
    "rsi_zone": "overbought",
    "macd_state": "expanding_positive",
    "direction": "accelerating"
  },
  "volatility": {
    "regime": "normal",
    "regime_trend": "stable"
  },
  "fundamentals": {
    "valuation_zone": "fair_value",
    "pe_vs_historical_zone": "premium",
    "last_earnings_surprise": "beat"
  }
}