> ## Documentation Index > Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt > Use this file to discover all available pages before exploring further. # 财务数据 TTM > 查询最近四个有效单季汇总的近12个月利润表或现金流量表指标。 ## 套餐权限 | 套餐 | 可用 | | - | :-: | | 免费版 | ❌ | | 基础版 | ✅ | | 专业版 | ✅ | | 全量套餐（A 股、港股、美股） | ✅ | | 企业版 | ✅ | ## 注意事项 * TTM 指滚动近12个月，由最近四个有效单季数据汇总；仅支持利润表 `IS` 和现金流量表 `CF`。 ## 支持的市场 | 市场 | 示例 | | - | - | | 美股 | AAPL.US | | 港股 | 700.HK | | A股 | 600519.SH | ## 请求参数 | 参数 | 是否必须 | 说明 | | - | :-: | - | | `symbol` | 是 | 股票代码 | | `type` | 否 | 产品类型，当前支持 `stock` | | `kind` | 是 | 报表类型：`IS` 利润表或 `CF` 现金流量表 | TTM 仅对利润表 `IS` 和现金流量表 `CF` 定义，传入资产负债表 `BS` 会返回参数错误。 ## 请求示例 ```bash theme={null} curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.tickdb.ai/v1/fundamentals/financials/ttm?symbol=AAPL&type=stock&kind=IS" ``` ## 返回字段说明 以下列出 `data` 中的字段；外层 `code=0` 表示成功。 | 字段 | 说明 | | - | - | | symbol | 股票代码。 | | kind | 报表类型：`IS` 利润表或 `CF` 现金流量表。 | | rows | 滚动近12个月的财务指标记录。 | | └─ kind | 该记录所属报表类型：`IS` 利润表或 `CF` 现金流量表。 | | └─ field\_name | 财务字段代码；[查看财务字段字典](./financial_fields_dictionary)。 | | └─ field\_display | 展示名称。 | | └─ indicator\_title | 指标标题。 | | └─ value | 对应指标的近12个月汇总值，以字符串返回。 | | └─ currency | 币种。 | | └─ is\_percent | 是否为百分比字段。 | | └─ fiscal\_year | 对应财年。 | | └─ fiscal\_period | 对应报告期。 | | └─ period\_type | `ttm`，表示滚动近12个月的汇总数据。 | | └─ period\_end | 期末日期，格式 `YYYY-MM-DD`。 | | └─ yoy | 同比变化；可能为 null。 | | └─ ratio | 比率；可能为 null。 | 返回最近四个有效单季汇总后的滚动近12个月财务指标。 ## OpenAPI ````yaml openapi.yaml GET /v1/fundamentals/financials/ttm openapi: 3.1.0 info: title: TickDB API description: TickDB 统一实时行情数据 API，提供 REST 和 WebSocket 接入。 version: 1.0.3 contact: email: support@tickdb.ai servers: - url: https://api.tickdb.ai description: 生产环境 security: - ApiKeyAuth: [] paths: /v1/fundamentals/financials/ttm: get: tags: - fundamentals-financials summary: 财务数据 TTM description: 查询最近四个有效单季汇总的近12个月利润表或现金流量表指标。 operationId: getFundamentalsFinancialsTTM parameters: - $ref: '#/components/parameters/SymbolQuery' - $ref: '#/components/parameters/TypeQuery' - $ref: '#/components/parameters/TTMKindQuery' responses: '200': $ref: '#/components/responses/FinancialRowsResponse' default: $ref: '#/components/responses/ErrorResponse' components: parameters: SymbolQuery: name: symbol in: query required: true schema: type: string examples: - AAPL - '700' - '600519' - AAPL.US - 700.HK - 600519.SH description: 股票代码 TypeQuery: name: type in: query required: false schema: type: string enum: - stock description: 产品类型，当前支持 `stock` TTMKindQuery: name: kind in: query required: true schema: type: string enum: - IS - CF description: 报表类型：`IS` 利润表或 `CF` 现金流量表 responses: FinancialRowsResponse: description: 近期财务报表响应。 content: application/json: schema: $ref: '#/components/schemas/FinancialRowsEnvelope' 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 schemas: FinancialRowsEnvelope: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: '#/components/schemas/FinancialRowsData' 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: {} SuccessEnvelope: type: object required: - code - data properties: code: type: integer const: 0 description: 业务状态码，成功为 0。 FinancialRowsData: type: object description: 财务报表数据。实测数值字段会以字符串返回以避免 JSON 浮点精度问题。 required: - symbol - kind - rows properties: symbol: type: string description: 标准化股票代码。 kind: type: string enum: - IS - BS - CF description: 报表类型：IS 利润表、BS 资产负债表、CF 现金流量表。 rows: type: array description: 所选报表类型的指标记录列表；同一报告期通常包含多条记录。 items: $ref: '#/components/schemas/FinancialRow' additionalProperties: true FinancialRow: type: object required: - kind - period_type - fiscal_year - fiscal_period - period_end - field_name - indicator_title - value properties: kind: type: string enum: - IS - BS - CF description: 报表类型：IS 利润表、BS 资产负债表、CF 现金流量表。 field_name: type: string description: 财务指标字段代码，取值见对应财务报表页面的财务字段字典。 indicator_title: type: string description: 指标标题。 field_display: type: string description: 带单位的展示名称。 value: oneOf: - type: string - type: number - type: 'null' description: 字段值。 fiscal_year: type: integer description: 财年。 fiscal_period: type: string description: 财务周期。 period_type: type: string description: >- 财务周期类型，常见值包括 q1（第一季度）、q2（第二季度）、q3（第三季度）、q4（第四季度）、saf（半年度）、af（年度）、ttm（滚动近12个月）。 period_end: type: string format: date description: 报告期结束日期。 currency: type: - string - 'null' description: 币种。 is_percent: type: boolean description: 是否为百分比指标。 yoy: type: - string - number - 'null' description: 同比值。 ratio: type: - string - number - 'null' description: 比率值。 additionalProperties: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.