GET Stock Financial Data

Overview

Provides stock financial data query capabilities, including income statements, revenue breakdowns, cash flow statements, balance sheets, valuation statistics, dividend indicators, dividend payout records, and earnings data — 8 categories in total.

Request Frequency

This API shares the same rate limits as other endpoints. The number of allowed requests per second depends on your subscription plan. Please refer to the Rate Limit for details.

Error Codes

See the HTTP Error Codes section for reference.

Authentication

Each request must include your API Key in the header.

Header

Type

Required

Description

apiKey

String

Yes

Your API Key associated with your current plan.

Endpoint

1. Earnings Report Status

Endpoint

Base path: /common/basic/financial/earning_status Full path: https://data.infoway.io/common/basic/financial/earning_status

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

AAPL.US

type

String

Yes

Instrument type: STOCK_US / STOCK_CN / STOCK_HK / STOCK_JP / STOCK_IN / STOCK_KS / STOCK_TW

STOCK_US

Example Request

GET https://data.infoway.io/common/basic/financial/earning_status?symbol=AAPL.US&type=STOCK_US

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "403a9a4c-5409-408b-9c57-5e633c8652c4",
  "data": {
    "symbol": "AAPL.US",
    "latestReportedPeriod": "2026-Q2",
    "latestReportedTime": "2026-07-08T16:05:16",
    "latestEpsActual": 2.0100,
    "latestRevenueActual": 111184000000.00,
    "nextPeriod": "2026-Q3",
    "nextEpsEstimate": 1.8522,
    "nextRevenueEstimate": 106233517738.00
  }
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

latestReportedPeriod

string

Latest published report period, e.g. 2026-Q1; markets with semi-annual reporting (e.g. HK) may return 2025-H2; null if no published record exists

latestReportedTime

string

Publication detection time of the latest report (the time the system detected the release and persisted it, lagging by at most one sync cycle; not the exchange announcement time)

latestEpsActual

decimal

Actual EPS of the latest published period

latestRevenueActual

decimal

Actual revenue of the latest published period

nextPeriod

string

Next upcoming report period, e.g. 2026-Q2; null if no upcoming record exists

nextEpsEstimate

decimal

Market EPS estimate for the next period

nextRevenueEstimate

decimal

Market revenue estimate for the next period

Notes

Report periods are at period granularity (e.g. 2026-Q3); exact publication dates are not provided.
To determine whether an instrument's earnings report has been published, compare latestReportedPeriod against the period you are interested in.
If the instrument does not exist or has no earnings data, data is null.

2. Income Statement

Query a company's revenue, costs, and profit data.

Endpoint

Base path: /common/basic/financial/income_statement

Full path: https://data.infoway.io/common/basic/financial/income_statement

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

000001.SZ

type

String

Yes

Instrument type

STOCK_CN

period_type

String

Report period: fq=quarterly, fy=annual, fh=semi-annual. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/income_statement?symbol=000001.SZ&type=STOCK_CN&period_type=fq

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "total_revenue",
      "itemName": "Total_revenue",
      "itemGroup": "Income Statement",
      "itemValue": 54032000000,
      "ttm": 210000000000,
      "parentItemId": ""
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period: fq=quarterly, fy=annual, fh=semi-annual

periodDate

string

Report date, e.g. 2025-12-31

itemId

string

Line item ID

itemName

string

Line item name

itemGroup

string

Group

itemValue

decimal

Value

ttm

decimal

Trailing twelve months

parentItemId

string

Parent item ID (non-empty for sub-items)

Common Items (itemId)

itemId

Description

total_revenue

Total Revenue

cost_of_goods

Cost of Goods Sold

gross_profit

Gross Profit

operating_expenses

Operating Expenses

operating_income

Operating Income

net_income

Net Income

3. Revenue Breakdown

Query revenue breakdown by business segment or geographic region.

Endpoint

Base path: /common/basic/financial/revenue

Full path: https://data.infoway.io/common/basic/financial/revenue

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

AAPL.US

type

String

Yes

Instrument type

STOCK_US

period_type

String

Report period: fy=annual (primary). Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/revenue?symbol=AAPL.US&type=STOCK_US

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "periodType": "fy",
      "periodDate": "2024",
      "itemId": "product_iphone",
      "itemName": "Product_iphone",
      "itemGroup": "Revenue by business",
      "itemValue": 200583000000,
      "ttm": null
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodDate

string

Report date

itemId

string

Item ID

itemName

string

Item name

itemGroup

string

Group (Revenue by business / Revenue by region)

itemValue

decimal

Value

ttm

decimal

Trailing twelve months

4. Cash Flow Statement

Query operating, investing, and financing cash flow data.

Endpoint

Base path: /common/basic/financial/cash_flow

Full path: https://data.infoway.io/common/basic/financial/cash_flow

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

000001.SZ

type

String

Yes

Instrument type

STOCK_CN

period_type

String

Report period: fq=quarterly, fy=annual. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/cash_flow?symbol=000001.SZ&type=STOCK_CN&period_type=fq

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "cf_oper",
      "itemName": "Cf_oper",
      "itemGroup": "Cash Flow Statement",
      "itemValue": 25000000000,
      "ttm": null
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodDate

string

Report date

itemId

string

Line item ID

itemName

string

Line item name

itemGroup

string

Group

itemValue

decimal

Value

ttm

decimal

Trailing twelve months

Common Items (itemId)

itemId

Description

cf_oper

Operating Cash Flow

cf_invest

Investing Cash Flow

cf_finance

Financing Cash Flow

cf_free_cash_flow

Free Cash Flow

5. Balance Sheet

Query assets, liabilities, and shareholders' equity at a point in time.

Endpoint

Base path: /common/basic/financial/balance_sheet Full path: https://data.infoway.io/common/basic/financial/balance_sheet

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

000001.SZ

type

String

Yes

Instrument type

STOCK_CN

period_type

String

Report period: fq=quarterly, fy=annual. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/balance_sheet?symbol=000001.SZ&type=STOCK_CN&period_type=fy

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fy",
      "periodDate": "2025-12-31",
      "itemId": "total_assets",
      "itemName": "Total_assets",
      "itemGroup": "Balance Sheet",
      "itemValue": 255000000000,
      "ttm": null
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodDate

string

Report date

itemId

string

Line item ID

itemName

string

Line item name

itemGroup

string

Group

itemValue

decimal

Value

ttm

decimal

Trailing twelve months

Common Items (itemId)

itemId

Description

total_assets

Total Assets

total_liabilities

Total Liabilities

total_equity

Total Equity

cash_and_equiv

Cash and Equivalents

total_debt

Total Debt

6. Valuation & Statistics

Query PE, PB, ROE, and other valuation and financial ratios.

Endpoint

Base path: /common/basic/financial/statistics

Full path: https://data.infoway.io/common/basic/financial/statistics

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

000001.SZ

type

String

Yes

Instrument type

STOCK_CN

period_type

String

Report period. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/statistics?symbol=000001.SZ&type=STOCK_CN

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "000001.SZ",
      "periodType": "fq",
      "periodDate": "2025-12-31",
      "itemId": "pe_ratio",
      "itemName": "Pe_ratio",
      "itemGroup": "Valuation ratios",
      "itemValue": 25.5,
      "ttmStr": "24.8",
      "currentValue": 26.1
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodDate

string

Report date

itemId

string

Metric ID

itemName

string

Metric name

itemGroup

string

Group

itemValue

decimal

Value

ttmStr

string

TTM value (may be "-")

currentValue

decimal

Current value

Item Groups (itemGroup)

itemGroup

Description

Key stats

Market cap, shares, revenue, and other core metrics

Valuation ratios

PE, PB, PS, and other valuation ratios

Profitability ratios

Gross margin, net margin, ROE, and other profitability metrics

Liquidity ratios

Current ratio, quick ratio

Solvency ratios

Debt-to-asset ratio, interest coverage ratio

7. Dividend Indicators

Query per-share dividend, dividend yield, payout ratio, and other dividend metrics.

Endpoint

Base path: /common/basic/financial/dividend

Full path: https://data.infoway.io/common/basic/financial/dividend

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

00700.HK

type

String

Yes

Instrument type

STOCK_HK

period_type

String

Report period: fq=quarterly, fy=annual. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/dividend?symbol=00700.HK&type=STOCK_HK

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "00700.HK",
      "periodType": "fy",
      "periodDate": "2025-12-31",
      "itemId": "dividend_yield",
      "itemName": "Dividend_yield",
      "itemGroup": "Dividend",
      "itemValue": 1.25,
      "ttmStr": "1.30",
      "currentValue": 1.28
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodDate

string

Report date

itemId

string

Metric ID

itemName

string

Metric name

itemGroup

string

Group

itemValue

decimal

Value

ttmStr

string

TTM value

currentValue

decimal

Current value

8. Dividend Payout History

Query each dividend payout's ex-date, amount, and type.

Endpoint

Base path: /common/basic/financial/dividend_payout

Full path: https://data.infoway.io/common/basic/financial/dividend_payout

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

AAPL.US

type

String

Yes

Instrument type

STOCK_US

Example Request

GET https://data.infoway.io/common/basic/financial/dividend_payout?symbol=AAPL.US&type=STOCK_US

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "exDate": 1747267200000,
      "recordDate": 1747353600000,
      "paymentDate": 1747948800000,
      "amount": 0.26,
      "type": "quarterly"
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

exDate

int64

Ex-dividend date (Unix timestamp in milliseconds)

recordDate

int64

Record date (Unix timestamp in milliseconds)

paymentDate

int64

Payment date (Unix timestamp in milliseconds)

amount

decimal

Dividend amount

type

string

Type: quarterly / interim / special

9. Earnings (EPS/Revenue Beat)

Query actual vs. estimated EPS and revenue (Beat/Miss).

Endpoint

Base path: /common/basic/financial/earnings

Full path: https://data.infoway.io/common/basic/financial/earnings

Request Parameters

Parameter

Type

Required

Description

Example

symbol

String

Yes

Ticker symbol

AAPL.US

type

String

Yes

Instrument type

STOCK_US

period_type

String

Report period: fq=quarterly, fy=annual. Returns all if omitted

Example Request

GET https://data.infoway.io/common/basic/financial/earnings?symbol=AAPL.US&type=STOCK_US&period_type=fq

Response Example

{
  "ret": 200,
  "msg": "success",
  "traceId": "xxx",
  "data": [
    {
      "symbol": "AAPL.US",
      "periodType": "fq",
      "periodKey": "2026-Q1",
      "epsActual": 1.65,
      "epsEstimate": 1.62,
      "epsPercentage": 1.85,
      "revenueActual": 124300000000,
      "revenueEstimate": 122500000000,
      "revenuePercentage": 1.47
    }
  ]
}

Response Fields

Field

Type

Description

symbol

string

Ticker symbol (user-provided format)

periodType

string

Report period

periodKey

string

Report period key (e.g. 2026-Q1 or 2025)

epsActual

decimal

EPS actual value

epsEstimate

decimal

EPS estimated value

epsPercentage

decimal

EPS deviation %

revenueActual

decimal

Revenue actual value

revenueEstimate

decimal

Revenue estimated value

revenuePercentage

decimal

Revenue deviation %

General Reference

Instrument Types (type)

Value

Description

STOCK_US

US Stocks

STOCK_CN

China A-Shares

STOCK_HK

Hong Kong Stocks

STOCK_IN

India Stocks

STOCK_JP

Japan Stocks

STOCK_KS

Korea Stocks

STOCK_TW

Taiwan Stocks

Symbol Formats

Market

Format

Example

China A-Shares

{code}.{suffix}

000001.SZ

Hong Kong

{code}.HK

00700.HK

{ticker}.US

AAPL.US

India

{ticker}.IN

RELIANCE.IN

Japan

{code}.JP

7203.JP

Korea

{code}.KS

005930.KS

Taiwan

{code}.TW

2330.TW

PreviousGET Stock Detail Data

NextGET Symbol Fundamentals

Last updated 2 months ago