# 美股历年基本财务数据 API 数据接口


美股历年基本财务数据 API 数据接口

历年PB/PE数据，全量美股数据，最全PB/PE数据。

![gugudata_api_cover](https://static.gugudata.com/api_us_fundamental.png)

# 1. 产品功能

- 支持所有美股全量财报数据查询；
- 分别包括市净率 (Price to book ratio 即 P/B)、市盈率 (PE ratio 即 P/E)数据；
- 返回多项财务指标；
- 多数据源清洗整合，海量数据毫秒级返回；
- 数据持续更新与维护；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- [接口调用状态与状态监控](https://www.gugudata.com/status)

# 2. API 文档

**接口详情:** [https://www.gugudata.com/api/details/usfundamental](https://www.gugudata.com/api/details/usfundamental)

**接口地址:** 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=YOUR_VALUE&type=

**数据预览:** [https://www.gugudata.com/preview/usfundamental](https://www.gugudata.com/preview/usfundamental)

**接口测试:** [https://api.gugudata.com/stock/us/fundamental/demo](https://api.gugudata.com/stock/us/fundamental/demo)

# 3. 请求参数

| 参数名 | 参数类型 | 是否必须 |   默认值    |                             备注                             |
| :----: | :------: | :------: | :---------: | :----------------------------------------------------------: |
| appkey |  string  |    是    | YOUR_APPKEY |                     付费后获取的 APPKEY                      |
| symbol |  string  |    否    | YOUR_VALUE  | 传递单支股票代码，如: AAPL。具体值参见 [美股股票代码参数枚举页面](https://www.gugudata.com/enum/stockus/symbols) |
|  type  |  string  |    是    |             |                财报数据类型，可选值为：PB\|PE                |

# 4. 返回参数

|            参数名            | 参数类型 |                             备注                             |
| :--------------------------: | :------: | :----------------------------------------------------------: |
|    DataStatus.StatusCode     |   int    |                        接口返回状态码                        |
| DataStatus.StatusDescription |  string  |                       接口返回状态说明                       |
| DataStatus.ResponseDateTime  |  string  |                       接口数据返回时间                       |
|  DataStatus.DataTotalCount   |   int    |             此条件下的总数据量，一般用于分页计算             |
|         Data.columns         | string[] | 财报的数据列名称，date,stock_price,pb.book_value_per_share,pb.price_to_book_ratio,pe.ttm_net_eps,pe.pe_ratio。 |
|          Data.data           |  string  |                   对应时间点的具体财报数据                   |
|         Data.data.pb         | string[] | book_value_per_share: 每股账面净值, price_to_book_ratio: 市净率 (Price to book ratio 即 P/B) |
|         Data.data.pe         | string[] | ttm_net_eps: 标普500行业指数每股收益 (EPS-TTM), pe_ratio: 市盈率 (PE ratio 即 P/E) |