// openai custom gpts

Market data inside
your Custom GPT.

Connect TickerDB as a GPT Action. Your Custom GPT gets market summaries, ticker event history, and watchlists - giving it real financial context for conversations.

try for free playground

// setup

Add as a GPT Action.

In the GPT Builder, go to Configure -> Actions -> Create new action. Paste the starter OpenAPI schema below. It includes the same summary, search, schema, watchlist, watchlist changes, and webhook routes highlighted on this page. Add your API key under Authentication (API Key, Bearer token).

OpenAPI Schema (starter surface)

openapi: 3.1.0
info:
  title: TickerDB
  version: "1.0"
servers:
  - url: https://api.tickerdb.com
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
paths:
  /v1/summary/{ticker}:
    get:
      operationId: getSummary
      summary: Get the latest, historical, or event-mode summary for a ticker
      parameters:
        - name: ticker
          in: path
          required: true
          schema:
            type: string
        - name: field
          in: query
          schema:
            type: string
        - name: band
          in: query
          schema:
            type: string
        - name: date
          in: query
          schema:
            type: string
  /v1/search:
    get:
      operationId: getSearch
      summary: Search assets with categorical filters
  /v1/schema/fields:
    get:
      operationId: getSchema
      summary: Discover canonical field names and allowed values
  /v1/watchlist:
    get:
      operationId: getWatchlist
      summary: Get current summaries for saved watchlist tickers
  /v1/watchlist/changes:
    get:
      operationId: getWatchlistChanges
      summary: Get field-level changes across your saved watchlist
  /v1/webhooks:
    get:
      operationId: listWebhooks
      summary: List registered webhook URLs
    post:
      operationId: createWebhook
      summary: Register a webhook URL
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [url]
              properties:
                url:
                  type: string
                events:
                  type: object
    delete:
      operationId: deleteWebhook
      summary: Delete a webhook by id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [id]
              properties:
                id:
                  type: string
security:
  - bearerAuth: []

This is still a starter schema excerpt, but it now includes the same tool surface shown below. Fill in request and response schemas as needed for your GPT Action setup.

// multi-step

Multi-step analysis.

Your GPT can chain actions - get a full summary, use summary event mode for historical context, then pull another ticker for comparison. Each call returns market-state data the model understands without extra prompting.

getSummary(ticker="INTC")

Full categorical snapshot for the ticker

getSummary(ticker="INTC", field="momentum_rsi_zone", band="deep_oversold")

Historical ticker events with aftermath on paid plans

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

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