tickdb-ai

tickdb-ai Fundamentals Events API

The fundamentals-events API from tickdb-ai — 8 operation(s) for fundamentals-events.

GitHub OpenAPI

Operations 8

GET /v1/fundamentals/news 个股新闻 #
GET /v1/fundamentals/news/{news_id} 新闻详情 #
GET /v1/fundamentals/calendar/report 财报日历 #
GET /v1/fundamentals/calendar/dividend 股息日历 #
GET /v1/fundamentals/calendar/split 拆股日历 #
GET /v1/fundamentals/calendar/ipo 新股日历 #
GET /v1/fundamentals/calendar/other 其他日历 #
GET /v1/fundamentals/market/status 市场状态 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tickdb-ai/openapi/tickdb-ai-fundamentals-events-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tickdb-ai:tickdb-ai-fundamentals-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tickdb-ai-fundamentals-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TickDB Fundamentals Events API
  description: TickDB 统一实时行情数据 API，提供 REST 和 WebSocket 接入。
  version: 1.0.3
  contact:
    email: support@tickdb.ai
servers:
- url: https://api.tickdb.ai
  description: 生产环境
security:
- ApiKeyAuth: []
tags:
- name: fundamentals-events
paths:
  /v1/fundamentals/news:
    get:
      tags:
      - fundamentals-events
      summary: 个股新闻
      description: 获取个股新闻列表、发布时间和正文可用状态。
      operationId: getFundamentalsNews
      parameters:
      - $ref: '#/components/parameters/SymbolQuery'
      - $ref: '#/components/parameters/TypeQuery'
      - $ref: '#/components/parameters/NewsLimitQuery'
      - $ref: '#/components/parameters/FromQuery'
      - $ref: '#/components/parameters/ToQuery'
      responses:
        '200':
          $ref: '#/components/responses/NewsResponse'
        default:
          $ref: '#/components/responses/NewsErrorResponse'
  /v1/fundamentals/news/{news_id}:
    get:
      tags:
      - fundamentals-events
      summary: 新闻详情
      description: 根据新闻 ID 查询新闻正文或可用摘要。
      operationId: getFundamentalsNewsDetail
      parameters:
      - $ref: '#/components/parameters/NewsIDPath'
      responses:
        '200':
          $ref: '#/components/responses/NewsDetailResponse'
        '400':
          $ref: '#/components/responses/NewsErrorResponse'
        '404':
          $ref: '#/components/responses/NewsErrorResponse'
        default:
          $ref: '#/components/responses/NewsErrorResponse'
  /v1/fundamentals/calendar/report:
    get:
      tags:
      - fundamentals-events
      summary: 财报日历
      description: 查询财报和业绩公布事件。
      operationId: getFundamentalsCalendarReport
      parameters:
      - $ref: '#/components/parameters/CalendarFromQuery'
      - $ref: '#/components/parameters/CalendarToQuery'
      - $ref: '#/components/parameters/CalendarMarketQuery'
      - $ref: '#/components/parameters/CalendarSymbolsQuery'
      - $ref: '#/components/parameters/CalendarLimitQuery'
      - $ref: '#/components/parameters/CursorQuery'
      responses:
        '200':
          $ref: '#/components/responses/CalendarResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
  /v1/fundamentals/calendar/dividend:
    get:
      tags:
      - fundamentals-events
      summary: 股息日历
      description: 查询分红派息事件。
      operationId: getFundamentalsCalendarDividend
      parameters:
      - $ref: '#/components/parameters/CalendarFromQuery'
      - $ref: '#/components/parameters/CalendarToQuery'
      - $ref: '#/components/parameters/CalendarMarketQuery'
      - $ref: '#/components/parameters/CalendarSymbolsQuery'
      - $ref: '#/components/parameters/CalendarLimitQuery'
      - $ref: '#/components/parameters/CursorQuery'
      responses:
        '200':
          $ref: '#/components/responses/CalendarResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
  /v1/fundamentals/calendar/split:
    get:
      tags:
      - fundamentals-events
      summary: 拆股日历
      description: 查询拆股、合股等事件。
      operationId: getFundamentalsCalendarSplit
      parameters:
      - $ref: '#/components/parameters/CalendarFromQuery'
      - $ref: '#/components/parameters/CalendarToQuery'
      - $ref: '#/components/parameters/CalendarMarketQuery'
      - $ref: '#/components/parameters/CalendarSymbolsQuery'
      - $ref: '#/components/parameters/CalendarLimitQuery'
      - $ref: '#/components/parameters/CursorQuery'
      responses:
        '200':
          $ref: '#/components/responses/CalendarResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
  /v1/fundamentals/calendar/ipo:
    get:
      tags:
      - fundamentals-events
      summary: 新股日历
      description: 查询新股发行与上市事件。
      operationId: getFundamentalsCalendarIPO
      parameters:
      - $ref: '#/components/parameters/CalendarFromQuery'
      - $ref: '#/components/parameters/CalendarToQuery'
      - $ref: '#/components/parameters/CalendarMarketQuery'
      - $ref: '#/components/parameters/CalendarSymbolsQuery'
      - $ref: '#/components/parameters/CalendarLimitQuery'
      - $ref: '#/components/parameters/CursorQuery'
      responses:
        '200':
          $ref: '#/components/responses/CalendarResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
  /v1/fundamentals/calendar/other:
    get:
      tags:
      - fundamentals-events
      summary: 其他日历
      description: 按类别查询宏观数据、休市、会议等其他财经事件。
      operationId: getFundamentalsCalendarOther
      parameters:
      - $ref: '#/components/parameters/CalendarFromQuery'
      - $ref: '#/components/parameters/CalendarToQuery'
      - $ref: '#/components/parameters/CalendarOtherCategoryQuery'
      - $ref: '#/components/parameters/CalendarMarketQuery'
      - $ref: '#/components/parameters/CalendarSymbolsQuery'
      - $ref: '#/components/parameters/CalendarLimitQuery'
      - $ref: '#/components/parameters/CursorQuery'
      responses:
        '200':
          $ref: '#/components/responses/CalendarResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
  /v1/fundamentals/market/status:
    get:
      tags:
      - fundamentals-events
      summary: 市场状态
      description: 查询不同市场当前的交易阶段和市场时间。
      operationId: getFundamentalsMarketStatus
      responses:
        '200':
          description: 请求成功。
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/SuccessEnvelope'
                - type: object
                  properties:
                    data:
                      type: object
                      required:
                      - markets
                      properties:
                        markets:
                          type: array
                          items:
                            type: object
                            required:
                            - market
                            - market_time
                            - trade_status
                            properties:
                              market:
                                type: string
                                example: US
                              market_time:
                                type: string
                                format: date-time
                              trade_status:
                                type: integer
        default:
          $ref: '#/components/responses/ErrorResponse'
components:
  parameters:
    NewsLimitQuery:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 200
        default: 50
      description: 返回数量，默认 50，范围 `1–200`
    NewsIDPath:
      name: news_id
      in: path
      required: true
      schema:
        type: string
        pattern: ^[1-9][0-9]*$
      description: 新闻列表返回的不透明文章 ID，按字符串传递
    TypeQuery:
      name: type
      in: query
      required: false
      schema:
        type: string
        enum:
        - stock
      description: 产品类型，当前支持 `stock`
    FromQuery:
      name: from
      in: query
      required: false
      schema:
        type: string
        format: date
        examples:
        - 2024-01-01
      description: 起始日期，格式 `YYYY-MM-DD`
    CalendarLimitQuery:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 500
        default: 100
      description: 每页数量，`1–500`，默认 `100`
    CalendarFromQuery:
      name: from
      in: query
      required: false
      schema:
        type: string
        format: date
      description: 起始日期，格式 `YYYY-MM-DD`
    CalendarSymbolsQuery:
      name: symbols
      in: query
      required: false
      schema:
        type: string
        minLength: 1
        examples:
        - AAPL.US
        - AAPL.US,700.HK,600519.SH
      description: 股票代码，英文逗号分隔，最多 50 个
    CalendarToQuery:
      name: to
      in: query
      required: false
      schema:
        type: string
        format: date
      description: 结束日期，格式 `YYYY-MM-DD`
    CalendarMarketQuery:
      name: market
      in: query
      required: false
      schema:
        type: string
        enum:
        - US
        - HK
        - CN
      description: 市场过滤：`US`、`HK`、`CN`；市场受限的 API Key 必填
    SymbolQuery:
      name: symbol
      in: query
      required: true
      schema:
        type: string
        examples:
        - AAPL
        - '700'
        - '600519'
        - AAPL.US
        - 700.HK
        - 600519.SH
      description: 股票代码
    ToQuery:
      name: to
      in: query
      required: false
      schema:
        type: string
        format: date
        examples:
        - 2026-12-31
      description: 结束日期，格式 `YYYY-MM-DD`
    CursorQuery:
      name: cursor
      in: query
      required: false
      schema:
        type: string
        minLength: 1
      description: 下一页游标；第一页不传
    CalendarOtherCategoryQuery:
      name: category
      in: query
      required: true
      schema:
        type: string
        enum:
        - macrodata
        - closed
        - meeting
        - merge
        - halt_resume
        - special_treatment
        - special_treatment_start
        - special_treatment_end
        - listing_status
        - listing_suspension
        - listing_resumption
        - delisting
        - lockup_expiry
      description: 其他事件类别，取值见下表
  responses:
    ErrorResponse:
      description: 错误响应。常见 HTTP 状态包括 400（参数错误）、401（鉴权失败）、403（权限或配额限制）、404（无匹配数据）、429（请求频率限制）和 503（服务暂不可用）。
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          examples:
            missingAPIKey:
              summary: 缺少 API Key
              value:
                code: '1002'
                message: API key is required. Provide via X-API-Key header
                error: '1002'
            missingKind:
              summary: 缺少必填参数
              value:
                code: 40001
                message: kind is required
                data: null
            endpointForbidden:
              summary: API Key 无权访问该接口
              value:
                code: 3009
                message: This endpoint is not allowed for your API key
                data: null
            marketForbidden:
              summary: API Key 未开放该市场
              value:
                code: 3010
                message: Fundamentals market not allowed for your API key
                data:
                  market: US
            noAvailableSource:
              summary: 数据暂不可用
              value:
                code: 5003
                message: Data is temporarily unavailable
                data: null
            notFound:
              summary: 无匹配数据
              value:
                code: 40404
                message: shareholder detail not found
                data: null
            businessNoData:
              summary: 查询条件无有效业务数据
              value:
                code: 40405
                message: valuation time series not found
                data: null
    CalendarResponse:
      description: 财报日历响应。
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CalendarEnvelope'
    NewsErrorResponse:
      description: 错误响应。常见 HTTP 状态包括 400（参数错误）、401（鉴权失败）、403（权限或配额限制）、404（无匹配数据）、429（请求频率限制）和 503（服务暂不可用）。
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NewsErrorEnvelope'
    NewsResponse:
      description: 个股新闻响应。
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NewsEnvelope'
    NewsDetailResponse:
      description: 新闻详情响应。
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NewsDetailEnvelope'
  schemas:
    NewsErrorEnvelope:
      type: object
      required:
      - code
      - message
      properties:
        code:
          description: TickDB API 业务错误码；可能为整数或字符串。
          oneOf:
          - type: integer
          - type: string
        message:
          type: string
          description: 面向调用方的错误说明。
        error:
          type: string
          description: 兼容错误标识；仅部分错误响应返回。
        data:
          description: 可选的错误上下文。
          oneOf:
          - type: 'null'
          - type: object
            additionalProperties: true
          - type: array
            items: {}
      additionalProperties: true
    NewsDetailItem:
      type: object
      required:
      - news_id
      - title
      - description
      - published_at
      - detail_status
      - content_scope
      - body_text
      - body_html
      properties:
        news_id:
          type: string
          pattern: ^[1-9][0-9]*$
          description: 不透明新闻 ID。
        title:
          type: string
          description: 新闻标题。
        description:
          type:
          - string
          - 'null'
          description: 列表摘要。
        published_at:
          type: string
          format: date-time
          description: 发布时间。
        detail_status:
          type: string
          enum:
          - pending
          - succeeded
          - blocked
          - failed
        content_scope:
          type: string
          enum:
          - full
          - excerpt
          - unknown
          - none
        body_text:
          type:
          - string
          - 'null'
          description: 规范化 UTF-8 正文纯文本。
        body_html:
          type:
          - string
          - 'null'
          description: 白名单消毒后的语义 HTML。
      additionalProperties: false
    NewsEnvelope:
      type: object
      required:
      - code
      - data
      properties:
        code:
          type: integer
          const: 0
        data:
          $ref: '#/components/schemas/NewsData'
      additionalProperties: false
    CalendarEventData:
      type: object
      required:
      - key
      - value_type
      - value_text
      - value_raw
      properties:
        key:
          type: string
          description: 附加数据键名，部分记录可能为空字符串。
        value_type:
          type: string
          description: 附加数据类型。
        value_text:
          type:
          - string
          - 'null'
          description: 展示值。
        value_raw:
          type:
          - string
          - 'null'
          description: 原始值。
      additionalProperties: false
    CalendarData:
      type: object
      required:
      - from
      - to
      - events
      properties:
        from:
          type: string
          format: date
          description: 查询起始日期，闭区间。
        to:
          type: string
          format: date
          description: 查询结束日期，闭区间。
        events:
          type: array
          description: 按 event_datetime 升序排列的财经事件，最多 500 条。
          maxItems: 500
          items:
            $ref: '#/components/schemas/FullCalendarEvent'
      additionalProperties: false
    FullCalendarEvent:
      type: object
      required:
      - category
      - content
      - counter_name
      - currency
      - date_type
      - event_datetime
      - event_type
      - market
      - star
      - symbol
      properties:
        category:
          type: string
          description: 事件细分类别，例如 ipo_offering、ipo_listing；请求参数 category 使用上层筛选类别。
        event_datetime:
          type: string
          format: date-time
          description: 事件时间，UTC RFC3339。
        symbol:
          type: string
          description: 标准化股票代码；全局事件可为空字符串。
        market:
          type: string
          enum:
          - US
          - HK
          - CN
          description: 事件所属市场。
        event_type:
          type: string
          description: 事件类型。
        content:
          type: string
          description: 事件内容。
        counter_name:
          type:
          - string
          - 'null'
          description: 相关标的名称。
        date_type:
          type:
          - string
          - 'null'
          description: 日期类型。
        star:
          type: integer
          description: 事件重要性。
        currency:
          type:
          - string
          - 'null'
          description: 币种。
        issue_price:
          type:
          - string
          - 'null'
          description: IPO 发行价格；仅 IPO 事件返回，无可用价格时为 null。
        data:
          type: array
          description: 事件附加数据；没有附加数据时省略。
          items:
            $ref: '#/components/schemas/CalendarEventData'
      additionalProperties: false
    SuccessEnvelope:
      type: object
      required:
      - code
      - data
      properties:
        code:
          type: integer
          const: 0
          description: 业务状态码，成功为 0。
    NewsData:
      type: object
      required:
      - symbol
      - limit
      - news
      properties:
        symbol:
          type: string
          description: 标准化股票代码。
        limit:
          type: integer
          description: 返回条数上限。
        news:
          type: array
          description: 新闻列表。
          items:
            $ref: '#/components/schemas/NewsItem'
      additionalProperties: false
    ErrorEnvelope:
      type: object
      required:
      - code
      - message
      properties:
        code:
          description: TickDB API 业务错误码；可能为整数或字符串，客户端应归一化为字符串后比较。
          oneOf:
          - type: integer
          - type: string
        message:
          type: string
          description: 错误说明。
        error:
          type: string
          description: 兼容错误标识；仅部分错误响应返回。
        data:
          description: 可选的错误上下文；可能为 null、对象或数组。
          oneOf:
          - type: 'null'
          - type: object
            additionalProperties: true
          - type: array
            items: {}
    CalendarEnvelope:
      allOf:
      - $ref: '#/components/schemas/SuccessEnvelope'
      - type: object
        required:
        - page
        properties:
          data:
            $ref: '#/components/schemas/CalendarData'
          page:
            $ref: '#/components/schemas/CalendarPage'
    CalendarPage:
      type: object
      required:
      - next_cursor
      - limit
      properties:
        next_cursor:
          type:
          - string
          - 'null'
          description: 下一页游标；末页为 null。
        limit:
          type: integer
          minimum: 1
          maximum: 500
          description: 当前分页上限。
      additionalProperties: false
    NewsDetailEnvelope:
      type: object
      required:
      - code
      - data
      properties:
        code:
          type: integer
          const: 0
        data:
          $ref: '#/components/schemas/NewsDetailItem'
      additionalProperties: false
    NewsItem:
      type: object
      required:
      - news_id
      - title
      - description
      - published_at
      - has_body
      properties:
        news_id:
          type: string
          pattern: ^[1-9][0-9]*$
          description: 不透明新闻 ID。
        title:
          type: string
          description: 新闻标题；个别记录可能为空字符串。
        description:
          type:
          - string
          - 'null'
          description: 摘要。
        published_at:
          type: string
          format: date-time
          description: 发布时间。
        has_body:
          type: boolean
          description: 当前是否存在可展示正文。
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
x-user-api-scope:
  primary_user_api_count: 25
  authentication: X-API-Key
x-fundamentals-product-scope:
  supported_stock_categories:
  - market: US
    exchanges:
    - NASDAQ
    - NYSE
    - AMEX
    category: stock
  - market: HK
    exchanges:
    - HKEX
    category: stock
  - market: CN
    exchanges:
    - SH
    - SZ
    category: stock
  unsupported_upstream_categories:
  - US_ARCA
  - US_BATS
  - CN_BJ_STOCK
  - CN_SH_ETF
  - CN_SZ_ETF
  unsupported_behavior: 不承诺 fundamentals 数据可用性；当前接口行为包括结构化 404 或格式正确的成功空响应。