tickerbot-io Meta API

openapi: 3.2.0
info:
  title: Tickerbot Meta API
  version: 2.69.6
  summary: The stock market API designed for agents.
  description: 'Tickerbot is the stock market API designed for agents. We serve real-time and historical market data as one queryable table. You and your agents can ask it anything, without building anything custom. Every ticker is a row. Every data point is a column. 23,000+ tickers, covering US stocks and ETFs, FX, crypto, rates and metals. 452+ columns, covering raw data, calculations and conditions: price, volume, price action, technicals, fundamentals, events, profile, analyst ratings and news. Refreshed every minute, historized back to 2003. The table is the API: /v2/tickers/ returns one ticker''s whole row, /v2/signals/ returns every ticker that matches one column, /v2/scan returns every ticker that matches a SQL WHERE clause. Every read runs live or as of any date. The power is in the columns: every ticker gets the same columns, query any of them, in any combination. Ask any question: anything you want to know about the market is a query over the table. Build any trading tool: anything you want to build is a few queries in sequence. Get a free API key, or paste our setup prompt and your agent connects over MCP. Free plan: 10,000 calls a month, no card required.


    All responses carry a top-level `as_of` ISO timestamp indicating data vintage. List and history responses use opaque cursor pagination — treat `next_cursor` as a black-box token and pass it back via `?cursor=` on the next request.'
  contact:
    name: Tickerbot Support
    url: https://tickerbot.io/support
    email: support@tickerbot.io
  license:
    name: Proprietary
    url: https://tickerbot.io/terms
servers:
- url: https://api.tickerbot.io
  description: Production
security:
- apiBearer: []
tags:
- name: Meta
  description: Health and version probes.
paths:
  /v2/health:
    get:
      tags:
      - Meta
      summary: Liveness probe (no auth)
      operationId: get_health
      description: 'Liveness probe. No auth required.


        Notes:

        - Returns 200 with a small payload, and is not counted against your rate limit — safe to poll from monitoring tools.'
      responses:
        '200':
          description: Service is up.
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type:
                    - string
                    - 'null'
                    description: Server time this response was assembled (ISO 8601).
                  status:
                    type:
                    - string
                    - 'null'
                    description: '`ok` when the service is live.'
                  service:
                    type:
                    - string
                    - 'null'
                    description: Service identifier.
                  version:
                    type:
                    - string
                    - 'null'
                    description: Running build.
                  rss_mb:
                    type:
                    - integer
                    - 'null'
                    description: Resident memory of the API process, MB.
                  event_loop_lag_ms:
                    type:
                    - integer
                    - 'null'
                    description: Event-loop lag sampled over the last second, ms.
                  uptime_s:
                    type:
                    - integer
                    - 'null'
                    description: Seconds since the process started.
                  log:
                    type:
                    - object
                    - 'null'
                    description: 'Process log health: `errors_5m` and `warns_5m` (console errors and warnings in the last five minutes), and `last_error_at` (when the most recent error was logged).'
                  stream:
                    type:
                    - object
                    - 'null'
                    description: 'The WebSocket stream''s delivery health: `connections`, `accounts`, `subscribed_tickers`, `ticks` (broadcasts with at least one subscriber since start), `last_broadcast_at`, `last_delivery_at` (last broadcast whose query succeeded), `fanout_failures_10m`, `last_error_at`, `dropped_columns` (field names the live table no longer has). `fanout_failures_10m` above zero while `connections` is above zero means subscribers are not receiving updates.'
      security: []
  /v2/version:
    get:
      tags:
      - Meta
      summary: Service version (no auth)
      operationId: get_version
      description: Identifies the running build. No auth required.
      responses:
        '200':
          description: Service identity.
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type:
                    - string
                    - 'null'
                    description: Server time this response was assembled (ISO 8601).
                  service:
                    type:
                    - string
                    - 'null'
                    description: Service identifier.
                  version:
                    type:
                    - string
                    - 'null'
                    description: Semantic version of the running build.
                  build:
                    type:
                    - string
                    - 'null'
                    description: Build identifier.
      security: []
components:
  securitySchemes:
    apiBearer:
      type: http
      scheme: bearer
      bearerFormat: API key (tb_live_… or tb_test_…)
      description: 'API keys are minted in the dashboard. Send as `Authorization: Bearer <key>`.'