// go sdk

TickerDB for Go.

Strongly-typed client for the TickerDB HTTP API. Idiomatic Go, full struct definitions, and context support. Install and start pulling market data immediately.

try for free playground

// quick start

One command. Ready to go.

Install the SDK and start pulling market data in under a minute. Responses include raw JSON in Data plus parsed rate limits.

install

// install the sdk
go get github.com/tickerdb/tickerdb-go

package main

import (
    "context"
    "fmt"
    "log"

    tickerdb "github.com/tickerdb/tickerdb-go"
)

func main() {
    client := tickerdb.NewClient("tdb_your_api_key")

    resp, err := client.Summary(context.Background(), "AAPL", nil)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(string(resp.Data))
    fmt.Printf("Requests remaining: %d\n", resp.RateLimits.RequestsRemaining)
}

view on pkg.go.dev

// multi-step analysis

Chain calls. Build context.

Pull a summary, check for historical band transitions, then monitor your watchlist for changes. Each call returns a response wrapper with raw JSON data and parsed rate limits.

client.Summary(ctx, "AAPL", nil)

Full categorical breakdown — trend, momentum, volatility, fundamentals

client.Summary(ctx, "AAPL", &tickerdb.SummaryOptions{ Field: tickerdb.Ptr("rsi_zone"), Band: tickerdb.Ptr("deep_oversold") })

Historical band transitions for RSI entering deep oversold

client.WatchlistChanges(ctx, nil)

State changes across your monitored tickers

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

resp, _ := client.WatchlistChanges(ctx, nil)

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
}

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