Ticker API

openapi: 3.1.0
info:
  title: Ticker API
  version: '2026-11-08'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-08: 10 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Ticker has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 9
    pages-with-code: 2
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-08'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://findticker.com/docs/api
  - https://findticker.com/docs/mcp
  - https://findticker.com/enterprise
  - https://findticker.com/docs/skills
servers:
- url: https://api.findticker.com
paths:
  /api/feed/v1/events/analytics:
    post:
      operationId: post_api_feed_v1_events_analytics
      tags:
      - Api
      summary: 'Enterprise: live event ticket pricing data API'
      x-source: https://findticker.com/enterprise
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiFeedV1EventsAnalyticsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiFeedV1EventsAnalyticsResponse'
      x-evidence:
        kind: documentation
  /api/feed/v1/events/{eventid}/analytics:
    get:
      operationId: get_api_feed_v1_events_eventid_analytics
      tags:
      - Api
      summary: 'One flat reading per event: price, inventory and demand.'
      description: Returns a single aggregated analytics reading for the given event.
      x-source: https://findticker.com/docs/api
      parameters:
      - name: eventid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/feed/v1/events/{eventid}/history:
    get:
      operationId: get_api_feed_v1_events_eventid_history
      tags:
      - Api
      summary: The event's readings over time, up to 60 days back.
      description: Provides historical readings for the event covering up to the past 60 days.
      x-source: https://findticker.com/docs/api
      parameters:
      - name: eventid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/feed/v1/events/{eventid}/shopping:
    get:
      operationId: get_api_feed_v1_events_eventid_shopping
      tags:
      - Api
      summary: The latest reading for an event and its series of past readings.
      description: Provides the current reading and a series of past readings for the specified event.
      x-source: https://findticker.com/docs/api
      parameters:
      - name: eventid
        in: path
        required: true
        schema:
          type: string
      - name: range
        in: query
        required: false
        schema:
          type: string
        description: Time range for the series, e.g., "28d".
      - name: columns
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of columns to include, e.g., "interest,sales".
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/feed/v1/performers/{performerid}:
    get:
      operationId: get_api_feed_v1_performers_performerid
      tags:
      - Api
      summary: A performer's rank and its history.
      description: Returns the rank of the performer and historical rank data.
      x-source: https://findticker.com/docs/api
      parameters:
      - name: performerid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/feed/v1/search:
    get:
      operationId: get_api_feed_v1_search
      tags:
      - Api
      summary: Event and performer ids for a name.
      description: Returns event and performer IDs that match the supplied name query.
      x-source: https://findticker.com/docs/api
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Search term for name‑to‑id lookup.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/feed/v1/usage:
    get:
      operationId: get_api_feed_v1_usage
      tags:
      - Api
      summary: What the account has spent this billing cycle.
      description: Shows usage and spending information for the current billing cycle.
      x-source: https://findticker.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /docs/skills/ticker-plugin.zip:
    get:
      operationId: get_docs_skills_ticker_plugin_zip
      tags:
      - Docs
      summary: Skills Ticker's free skills for Claude, Codex, Cursor and other assistants, as a download.
      description: Download the ticker-plugin.zip containing the skills and the Ticker MCP server for Claude Code.
      x-source: https://findticker.com/docs/skills
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /docs/skills/ticker-skills.zip:
    get:
      operationId: get_docs_skills_ticker_skills_zip
      tags:
      - Docs
      summary: Skills Ticker's free skills for Claude, Codex, Cursor and other assistants, as a download.
      description: Download the ticker-skills.zip containing only the skill folders for other clients.
      x-source: https://findticker.com/docs/skills
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/screen:
    post:
      operationId: post_v1_screen
      tags:
      - Screen
      summary: Screener runs screen_events, a screen in the app's screener, and a POST /v1/screen on the API.
      x-source: https://findticker.com/docs/mcp
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiFeedV1EventsAnalyticsRequest:
      type: object
      properties:
        event_ids:
          type: array
          description: Event ids
      required:
      - event_ids
    PostApiFeedV1EventsAnalyticsResponse:
      type: object
      properties:
        data:
          type: array
          description: Analytics data per event
        meta:
          type: object
          description: Metadata about the request
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Docs
- name: Screen