API 文档
接口地址: https://api.gugudata.com/stock/us/fundamental
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/us/fundamental?appkey=YOUR_APPKEY&symbol=AAPL&type=ALL&startYear=2020&endYear=2025
数据预览: https://www.gugudata.com/preview/usfundamental
接口测试: https://api.gugudata.com/stock/us/fundamental/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 查询美股股票代码列表数据,支持分页查询
前置接口地址: https://api.gugudata.com/stock/ussymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 50 条
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
YOUR_APPKEY |
购买接口后获取的调用凭证。请仅在服务端安全保存,不要写入公开代码或客户端日志。 |
| symbol |
string |
是 |
AAPL |
单只美股代码,支持字母、数字、点和短横线。 |
| type |
string |
否 |
ALL |
可选 ALL、PB、PE;INFO 作为原有 ALL 语义的兼容值。 |
| startYear |
integer |
否 |
|
起始财年,范围为 2009 至当前年份。 |
| endYear |
integer |
否 |
|
结束财年,且不能小于 startYear。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次业务参数摘要,不包含 APPKEY。 |
| DataStatus.StatusCode |
integer |
业务状态码,100 表示成功。 |
| DataStatus.StatusDescription |
string |
业务状态说明。 |
| DataStatus.ResponseDateTime |
string |
服务端响应时间。 |
| DataStatus.DataTotalCount |
integer |
当前查询条件下的全部匹配数量。 |
| Data.FiscalYear |
integer |
财年。 |
| Data.FiscalPeriodEndDate |
string |
财年期末日期。 |
| Data.FilingDate |
string |
年度报告提交日期。 |
| Data.FormType |
string |
年度报告类型。 |
| Data.Currency |
string |
金额字段币种。 |
| Data.Revenue |
number|null |
营业收入。 |
| Data.GrossProfit |
number|null |
毛利润。 |
| Data.OperatingIncome |
number|null |
营业利润。 |
| Data.NetIncome |
number|null |
净利润。 |
| Data.EarningsPerShareBasic |
number|null |
基本每股收益。 |
| Data.EarningsPerShareDiluted |
number|null |
稀释每股收益。 |
| Data.TotalAssets |
number|null |
总资产。 |
| Data.TotalLiabilities |
number|null |
总负债。 |
| Data.StockholdersEquity |
number|null |
股东权益。 |
| Data.CashAndCashEquivalents |
number|null |
现金及现金等价物。 |
| Data.LongTermDebt |
number|null |
长期债务。 |
| Data.OperatingCashFlow |
number|null |
经营活动现金流。 |
| Data.CapitalExpenditure |
number|null |
资本开支。 |
| Data.FreeCashFlow |
number|null |
自由现金流。 |
| Data.SharesOutstanding |
number|null |
期末流通股数。 |
| Data.BookValuePerShare |
number|null |
每股账面价值。 |
| Data.FiscalPeriodEndClose |
number|null |
财年期末附近收盘价。 |
| Data.PriceToEarningsRatio |
number|null |
市盈率。 |
| Data.PriceToBookRatio |
number|null |
市净率。 |