Get the values of a company over time
get_seriesThe values of one company over time: items of its statements and ratios together (measures: revenue, net_income, total_assets, cfo, corp.operating_margin, roic), a whole statement (statement: income_statement, balance_sheet, cash_flow) or a category of ratios. frequency is quarterly, annual, ttm (ratios over the last 4 quarters) or quarter_end; from and to are fiscal periods or ISO dates; at gives the snapshot that was the latest on a date. Each value comes with its unit, method and source documents, a ratio with the documents of the figures it is computed from. A page holds the latest periods and next gives the earlier ones; not_included names what is left out, such as the quarters of a company that reports fiscal years only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "<company>"
},
"name": "get_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | an ISO date: the snapshot that was the latest on that date, in place of the latest snapshot | |
| to | No | last period, in the same forms | |
| from | No | first period: a fiscal year (2024), a fiscal quarter (FY2024 Q2) or an ISO date | |
| limit | No | periods in one page (default 12) | |
| cursor | No | the next of an earlier answer, for the next page of the same call | |
| compact | No | values and units only, without definitions, methods and documents | |
| company | Yes | the company of a search result (apple), or a ticker or CIK | |
| category | No | every ratio of one category, for example Credit metrics or Profitability | |
| measures | No | item keys, item labels or ratio ids or short names | |
| frequency | No | default: quarters where the company reports them, ttm for ratios | |
| statement | No | every item of one statement |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| next | No | ||
| as_of | No | ||
| count | Yes | ||
| first | No | ||
| series | Yes | ||
| company | Yes | ||
| reports | No | ||
| citation | No | ||
| complete | Yes | ||
| returned | No | ||
| snapshot | Yes | ||
| conventions | No | ||
| not_included | Yes | ||
| latest_period | No |