Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Fetch income statement, balance sheet, and cash flow statement for any public company.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
kind | string | Required | Report type: `IncomeStatement`, `BalanceSheet`, `CashFlow`, `All` |
period | string | Required | Report period: `Annual`, `SemiAnnual`, `Q1`, `Q2`, `Q3`, `ThreeQ`, `QuarterlyFull` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
list | object | Required | Report data grouped by kind (key: report type code, e.g. `IS`, `BS`, `CF`) |
title | string | Optional | Indicator title |
short_title | string | Optional | Short title |
currency | string | Optional | Currency |
has_yoy | boolean | Optional | Whether year-over-year data is available |
entry | string | Optional | Entry identifier |
periods | string[] | Optional | Available reporting periods |
accounts | object[] | Optional | List of financial line items |
field | string | Required | Field identifier |
percent | boolean | Optional | Whether the value is a percentage |
tip | string | Optional | Tooltip description |
values | object[] | Optional | Historical values by period |
period | string | Required | Period label (e.g. `FY 2024`) |
year | integer | Optional | Fiscal year |
fp_end | string | Optional | Period end timestamp |
value | string | Optional | Reported value |
ratio | string | Optional | Ratio value |
yoy | string | Optional | Year-over-year growth rate |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"list": {
"IS": {
"indicators": [
{
"title": "Income Statement",
"short_title": "IS",
"currency": "USD",
"has_yoy": true,
"entry": "IS",
"periods": [
"FY2025",
"FY2024"
],
"accounts": [
{
"field": "EPS",
"name": "Earnings Per Share(USD)",
"percent": false,
"tip": "",
"values": [
{
"period": "FY 2025",
"year": 2025,
"fp_end": "1758945600",
"value": "7.46",
"ratio": "",
"yoy": "0.227"
}
]
}
]
}
]
}
}
}
}Error code
See the Error Codes page for the full list of error codes.