三、财务信息
3.5 年度财务
GET
/api/fundamental_annual最近一个财年的财务字段。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
| market | 必填 | 市场代码,如 NASDAQ |
| symbol | 必填 | 产品代码,如 AAPL;代码里有 & 时要写成 %26 |
说明
data里是以_fy结尾的字段。- 外壳里的
market为 null。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval},数据在 data 里。出错时 HTTP 状态码仍是 200,status 为 500,message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 market is required! / symbol is required! | 缺少 market 或 symbol |
| 200 | status=500 No Symbol | 找不到这个产品,或这个产品没有这类数据 |
示例
GET
/fundamental_annual?country=america&market=NASDAQ&symbol=AAPL请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 数据
"country": "america", // 国家
"operating_margin_fy": 31.9707997625919, // 营业利润率(年度,%)
"total_revenue_fy": 416161000000, // 营业收入(年度)
"cash_n_short_term_invest_fy": 54697000000, // 现金及短期投资(年度)
"cash_n_equivalents_fy": 33539000000, // 现金及等价物(年度)
"total_liabilities_fy": 285508000000, // 总负债(年度)
"gross_profit_fy": 195201000000, // 毛利(年度)
"earnings_per_share_diluted_fy": 7.465, // 摊薄每股收益(年度)
"free_cash_flow_fy": 98767000000, // 自由现金流(年度)
"gross_margin_fy": 46.9051641071605, // 毛利率(年度,%)
"return_on_equity_fy": 171.422449744802, // 净资产收益率(年度,%)
"earnings_per_share_basic_fy": 7.4931, // 基本每股收益(年度)
"net_margin_fy": 26.9150641218182, // 净利率(年度,%)
"net_income_fy": 112010000000 // 净利润(年度)
},
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": null, // 市场代码
"symbol": "AAPL", // 产品代码
"code": "AAPL", // 产品代码
"interval": null // K 线周期,这类接口不用
}