![](https://img-blog.csdnimg.cn/direct/64941fd579d7424482838f65f9aa8a06.jpeg)
# Restful API
https://tsanghi.com/api/fin/stock/{exchange_code}/income/statement/yearly?token={token}&ticker={ticker}
指定交易所和股票代码,获取该只股票的利润表(年度)。默认返回全部历史数据,也可以使用参数start_date和end_date选择特定时间段。此接口可方便地获取全球股票的历史数据,可用于数据初始化。交易所详见交易所清单接口,股票代码详见股票清单接口。
更新周期:每周。
请求方式:GET。
# 示例:测试JSON
https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly?token=demo&ticker=600519&order=2
# 示例:测试CSV
https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly?token=demo&ticker=600519&order=2&fmt=csv
注:测试返回不超过10条数据(2年历史)
Request请求参数
参数名称 | 参数类型 | 参数选项 | 参数说明 |
token | 字符串 | 必选 | API Token。登录后获取。 |
exchange_code | 字符串 | 必选 | 交易所代码。详见交易所清单接口。 例如:XSHG(上交所)、XSHE(深交所)、XNAS(纳斯达克)。 |
ticker | 字符串 | 必选 | 股票代码。详见股票清单接口。 例如:600519(贵州茅台)、AAPL(苹果)。 |
start_date | 字符串 | 可选 | 起始日期(报告期)。格式“yyyy-mm-dd”,默认:最早日期。 |
end_date | 字符串 | 可选 | 终止日期(报告期)。格式“yyyy-mm-dd”,默认:最新日期。 |
fmt | 字符串 | 可选 | 输出格式。支持json和csv两种标准输出格式,默认:json。 |
columns | 字符串 | 可选 | 输出字段。支持自定义输出,多个字段以半角逗号分隔,默认:所有字段。 |
order | 整数 | 可选 | 按日期排序。0:不排序,1:升序,2:降序,默认:0。 |
Response响应参数
参数名称 | 参数类型 | 参数说明 |
ticker | 字符串 | 股票代码 |
report_date | 日期 | 报告期。格式“yyyy-mm-dd”。 |
currency_code | 字符串 | 币种代码。详见币种接口。 |
total_operating_revenue | 小数 | 营业总收入 |
total_profit | 小数 | 利润总额 |
net_profit | 小数 | 净利润 |
net_profit_parent_company_owners | 小数 | 归属于母公司股东的净利润 |
total_operating_cost | 小数 | 营业总成本 |
operating_cost | 小数 | 营业成本 |
research_development | 小数 | 研发费用 |
Python示例
import requests
url = f"https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly?token=demo&ticker=600519"
data = requests.get(url).json()
print(data)
Response示例
{
"msg": "操作成功",
"code": 200,
"data": [
{
"ticker": "600519",
"report_date": "2022-12-31",
"currency_code": "CNY",
"total_operating_revenue": 127553959355.97,
"total_profit": 87701489748.18,
"net_profit": 65375136766.75,
"net_profit_parent_company_owners": 62716443738.27,
"total_operating_cost": 41115610089.74,
"operating_cost": 10199195964.38,
"research_development": 135185680.4
}
]
}
2. 增量利润表(年度)
# Restful API
https://tsanghi.com/api/fin/stock/{exchange_code}/income/statement/yearly/latest?token={token}
指定交易所和日期(报告期),获取全部股票的利润表(年度)。不指定日期时,默认返回最新数据。此接口可方便地获取增量数据。
更新周期:每周。
请求方式:GET。
# 示例:测试JSON
https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly/latest?token=demo
# 示例:测试CSV
https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly/latest?token=demo&fmt=csv
注:测试返回不超过10条数据(2年历史)
Request请求参数
参数名称 | 参数类型 | 参数选项 | 参数说明 |
token | 字符串 | 必选 | API Token。登录后获取。 |
exchange_code | 字符串 | 必选 | 交易所代码。详见交易所接口。 例如:XSHG(上交所)、XSHE(深交所)、XNAS(纳斯达克)。 |
report_date | 日期 | 可选 | 报告期。格式“yyyy-mm-dd”,默认:最新日期。 |
fmt | 字符串 | 可选 | 输出格式。支持json和csv两种标准输出格式,默认:json。 |
columns | 字符串 | 可选 | 输出字段。支持自定义输出,多个字段以半角逗号分隔,默认:所有字段。 |
Response响应参数
参数名称 | 参数类型 | 参数说明 |
ticker | 字符串 | 股票代码 |
report_date | 日期 | 报告期。格式“yyyy-mm-dd”。 |
currency_code | 字符串 | 币种代码。详见币种接口。 |
total_operating_revenue | 小数 | 营业总收入 |
total_profit | 小数 | 利润总额 |
net_profit | 小数 | 净利润 |
net_profit_parent_company_owners | 小数 | 归属于母公司股东的净利润 |
total_operating_cost | 小数 | 营业总成本 |
operating_cost | 小数 | 营业成本 |
research_development | 小数 | 研发费用 |
Python示例
import requests
url = f"https://tsanghi.com/api/fin/stock/XSHG/income/statement/yearly/latest?token=demo"
data = requests.get(url).json()
print(data)
Response示例
{
"msg": "操作成功",
"code": 200,
"data": [
{
"ticker": "600343",
"report_date": "2022-12-31",
"currency_code": "CNY",
"total_operating_revenue": 1275280575.64,
"total_profit": -32166841.17,
"net_profit": -33730194.7,
"net_profit_parent_company_owners": -39962308.7,
"total_operating_cost": 1307139344.97,
"operating_cost": 1089111647.02,
"research_development": 65366514.1
},
{
"ticker": "600444",
"report_date": "2022-12-31",
"currency_code": "CNY",
"total_operating_revenue": 787842850.06,
"total_profit": 49644154.32,
"net_profit": 41234428.05,
"net_profit_parent_company_owners": 41234428.05,
"total_operating_cost": 744245371.21,
"operating_cost": 664600526.01,
"research_development": 38910478.14
}
]
}
更多详情:tsanghi.com