> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 财报快照 > 某个股票代码的最新收益快照——实际值，以及可用时提供的可选预期值、超预期幅度和环比/同比变化字段。 指定 ticker 的最新财报快照。返回最近报告的 EPS 和收入，并在有数据时返回一致预期、相对于预期的意外幅度以及环比变化。 **最适合：** 财报发布日仪表板、跟踪是否超出或低于一致预期，以及在 ticker 卡片上显示最新财报数据。 ## 示例 ```bash theme={null} curl -X GET "https://api.aisa.one/apis/v1/financial/earnings?ticker=NVDA" \ -H "Authorization: Bearer $AISA_API_KEY" ``` ## OpenAPI ````yaml openapi/zh/openapi-financial.json GET /earnings openapi: 3.0.1 info: title: Financial Datasets API description: 股票市场 API，提供超过 30 年、涵盖 30,000 多个股票代码的实时和历史金融数据，包括财务报表、股票价格、内部人士交易、SEC 申报文件等。 version: 1.0.0 license: name: MIT url: https://opensource.org/licenses/MIT contact: name: API Support url: https://financialdatasets.ai/support email: support@financialdatasets.ai termsOfService: https://financialdatasets.ai/terms servers: - url: https://api.aisa.one/apis/v1/financial description: Production server security: - bearerAuth: [] tags: - name: Financial Statements description: Access to income statements, balance sheets, and cash flow statements - name: Market Data description: Real-time and historical price data - name: Company Information description: Company facts like ticker, name, and description - name: Earnings description: Earnings press releases and related data - name: Crypto description: Cryptocurrency price data and market information - name: News description: Real-time and historical news articles - name: SEC Filings description: SEC filings and regulatory documents - name: Insider Trades description: Insider trading activity and transactions - name: Institutional Ownership description: Equity holdings of investment managers - name: Financial Metrics description: Financial ratios, metrics, and key performance indicators paths: /earnings: get: tags: - Earnings summary: 获取收益快照 description: 获取某个股票代码的最新收益快照。仅在数据可用时返回可选的预估值/意外值和变动字段。 operationId: getEarnings parameters: - name: ticker in: query description: 股票代码。 required: true schema: type: string responses: '200': description: 收益响应 content: application/json: schema: $ref: '#/components/schemas/EarningsResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/PaymentRequiredError' '404': $ref: '#/components/responses/NotFoundError' components: schemas: EarningsResponse: type: object properties: earnings: $ref: '#/components/schemas/Earnings' Earnings: type: object properties: ticker: type: string description: 请求的股票代码。 report_period: type: string format: date description: 为该股票代码找到的最新报告期。 fiscal_period: type: string nullable: true description: 财政期间标签（例如 2025-Q4 或 2025-FY）。 currency: type: string nullable: true description: ISO 货币代码（例如 USD）。 quarterly: $ref: '#/components/schemas/EarningsTimeDimension' annual: $ref: '#/components/schemas/EarningsTimeDimension' ErrorResponse: type: object properties: error: type: string description: 简短的错误消息。 message: type: string description: 更详细的错误消息。 EarningsTimeDimension: type: object properties: fiscal_period: type: string nullable: true description: 财政期间标签（例如 2025-Q4 或 2025-FY）。 currency: type: string nullable: true description: ISO 货币代码（例如 USD）。 revenue: type: number nullable: true estimated_revenue: type: number description: 预估营收。仅在有数据时返回。 revenue_surprise: type: string description: 实际营收相较预估值的意外分类。仅在可用时返回。 enum: - BEAT - MISS - MEET earnings_per_share: type: number nullable: true estimated_earnings_per_share: type: number description: 预估每股收益。仅在可用时返回。 eps_surprise: type: string description: 每股收益相对于预估值的意外程度分类。仅在可用时返回。 enum: - BEAT - MISS - MEET net_income: type: number nullable: true gross_profit: type: number nullable: true operating_income: type: number nullable: true weighted_average_shares: type: number nullable: true weighted_average_shares_diluted: type: number nullable: true cash_and_equivalents: type: number nullable: true total_debt: type: number nullable: true total_assets: type: number nullable: true total_liabilities: type: number nullable: true shareholders_equity: type: number nullable: true net_cash_flow_from_operations: type: number nullable: true capital_expenditure: type: number nullable: true net_cash_flow_from_investing: type: number nullable: true net_cash_flow_from_financing: type: number nullable: true change_in_cash_and_equivalents: type: number nullable: true free_cash_flow: type: number nullable: true revenue_chg: type: number description: 营收变化百分比。季度数据中为环比（QoQ），年度数据中为同比（YoY）。仅在可计算时返回。 net_income_chg: type: number description: 净利润变化百分比。季度负载中为环比（QoQ），年度负载中为同比（YoY）。仅在可计算时返回。 operating_income_chg: type: number description: 营业利润的百分比变化。季度数据中为环比（QoQ），年度数据中为同比（YoY）。仅在可计算时返回。 gross_profit_chg: type: number description: 毛利润的百分比变化。季度载荷中为 QoQ，年度载荷中为 YoY。仅在可计算时返回。 net_cash_flow_from_operations_chg: type: number description: 经营活动产生的现金流量净额百分比变化。季度数据载荷中为环比，年度数据载荷中为同比。仅在可计算时返回。 net_cash_flow_from_investing_chg: type: number description: 投资活动产生的现金流量净额百分比变化。季度数据载荷中为环比，年度数据载荷中为同比。仅在可计算时返回。 net_cash_flow_from_financing_chg: type: number description: 融资活动产生的现金流量净额百分比变化。季度数据载荷中为环比，年度数据载荷中为同比。仅在可计算时返回。 free_cash_flow_chg: type: number description: 自由现金流的百分比变化。季度数据中为环比，年度数据中为同比。仅在可计算时返回。 responses: BadRequestError: description: 错误请求 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Bad Request message: Invalid request parameters UnauthorizedError: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Unauthorized message: Invalid API key provided PaymentRequiredError: description: 该请求需要付费订阅 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Payment Required message: >- This endpoint requires a paid subscription. Please upgrade your plan. NotFoundError: description: 未找到指定的资源 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Not Found message: Ticker XXXX not found securitySchemes: bearerAuth: type: http scheme: bearer ````