// astro

Market data for
Astro projects.

Use the TickerDB Node.js SDK in Astro API endpoints and <code>.astro</code> components. Pre-computed financial data with no infrastructure to maintain.

try for free read the docs

// setup

Install the SDK.

Add tickerdb to your Astro project. Works with any rendering mode — static, server, or hybrid.

terminal

npm install tickerdb

Set TICKERDB_KEY in your .env file. Access it with import.meta.env.TICKERDB_KEY.

// usage

Works in endpoints and components.

Call the SDK in API endpoints for JSON responses, or directly in .astro component frontmatter to render data at build time or on request.

API Endpoint src/pages/api/summary/[ticker].ts

import type { APIRoute } from "astro";
import { TickerDB } from "tickerdb";

const client = new TickerDB(import.meta.env.TICKERDB_KEY);

export const GET: APIRoute = async ({ params }) => {
  const summary = await client.summary(params.ticker!);
  return new Response(JSON.stringify(summary), {
    headers: { "Content-Type": "application/json" },
  });
};

Astro Component src/components/StockCard.astro

---
import { TickerDB } from "tickerdb";
const client = new TickerDB(import.meta.env.TICKERDB_KEY);
const summary = await client.summary("AAPL");
---
<div>
  <h2>AAPL</h2>
  <p>Trend: {summary.trend.direction}</p>
  <p>RSI: {summary.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 Endpoint src/pages/api/watchlist/changes.ts

import type { APIRoute } from "astro";
import { TickerDB } from "tickerdb";

const client = new TickerDB(import.meta.env.TICKERDB_KEY);

export const GET: APIRoute = async () => {
  const changes = await client.watchlist.changes();
  return new Response(JSON.stringify(changes), {
    headers: { "Content-Type": "application/json" },
  });
};

json

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

// ai integration

Feed an AI agent.

TickerDB's categorical 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 Endpoint src/pages/api/briefing/[ticker].ts

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

const client = new TickerDB(import.meta.env.TICKERDB_KEY);
const anthropic = new Anthropic();

export const GET: APIRoute = async ({ params }) => {
  const summary = await client.summary(params.ticker!);

  const msg = await anthropic.messages.create({
    model: "claude-sonnet-4-20250514",
    max_tokens: 1024,
    messages: [{
      role: "user",
      content: `Analyze this stock data:\n${JSON.stringify(summary)}`,
    }],
  });

  return new Response(JSON.stringify({ analysis: msg.content[0].text }), {
    headers: { "Content-Type": "application/json" },
  });
};

// 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"
  }
}