A 股歷史行情數(shù)據(jù) API 接口
所有A股歷史交易行情數(shù)據(jù),全量歷史交易 / 包含前后復(fù)權(quán)數(shù)據(jù)。

1. 產(chǎn)品功能
支持所有 A 股全量歷史(天)交易查詢;
包含上交所和深交所所有股票數(shù)據(jù);
每日 A 股收盤后更新當(dāng)日交易數(shù)據(jù),停牌不更新;
支持一次查詢多個股票歷史數(shù)據(jù);
支持任意時間段查詢;
超高查詢效率,千萬級數(shù)據(jù)毫秒級返回;
支持查詢所有交易數(shù)據(jù)的未復(fù)權(quán)、前復(fù)權(quán)、后復(fù)權(quán)數(shù)據(jù);
全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
全面兼容 Apple ATS;
全國多節(jié)點 CDN 部署;
接口極速響應(yīng),多臺服務(wù)器構(gòu)建 API 接口負載均衡。
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/stockcn
接口地址: https://api.gugudata.com/stock/cn
返回格式: application/json; charset=utf-8
請求方式: GET
請求協(xié)議: HTTPS
數(shù)據(jù)預(yù)覽: https://www.gugudata.com/preview/stockcn
接口測試: https://api.gugudata.com/stock/cn/demo
前置接口
前置接口說明: 查詢 A 股股票代碼列表數(shù)據(jù),支持分頁查詢
前置接口地址: https://api.gugudata.com/stock/cnsymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE
前置接口參數(shù)說明: appkey=YOUR_APPKEY&pageindex=第幾頁&pagesize=每頁返回數(shù)量,最大 50 條
前置接口返回格式: application/json; charset=utf-8
前置接口返回說明: 包含股票編碼、股票名稱、股票中文名稱
前置接口請求方式: GET
前置接口請求協(xié)議: HTTPS
3. 請求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認(rèn)值 | 備注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY |
| symbol | string | 是 | YOUR_VALUE | A股股票代碼,具體值參見 A股股票代碼參數(shù)枚舉頁面。支持一次查詢多個股票,使用逗號隔開,參數(shù)格式為:600031,600036 |
| begindate | string | 是 | YOUR_VALUE | 股票交易開始時間,格式為 20200101 |
| enddate | string | 是 | YOUR_VALUE | 股票交易結(jié)束時間,格式為 20200101,與開始時間最大時間跨度支持 366 個自然日,獲取全量數(shù)據(jù)請分批獲取,數(shù)據(jù)量較大,請保持合理的請求頻率 |
| adjust | string | 否 | 查詢前復(fù)權(quán)、后復(fù)權(quán)數(shù)據(jù),如果傳遞參數(shù)值為 pre,那么返回前復(fù)權(quán)數(shù)據(jù)(所有數(shù)據(jù)進行了前復(fù)權(quán));如果傳遞參數(shù)值為 after,那么返回后復(fù)權(quán)數(shù)據(jù);默認(rèn)值為空或不傳遞,返回未復(fù)權(quán)數(shù)據(jù) |
4. 返回參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 備注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態(tài)碼 |
| DataStatus.StatusDescription | string | 接口返回狀態(tài)說明 |
| DataStatus.ResponseDateTime | string | 接口數(shù)據(jù)返回時間 |
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量,一般用于分頁計算 |
| Data.TimeKey | int | 交易日期 |
| Data.Symbol | string | A股股票代碼 |
| Data.StockName | string | 股票名稱 |
| Data.Open | double | 開盤價 |
| Data.Close | double | 收盤價 |
| Data.High | double | 最高 |
| Data.Low | double | 最低 |
| Data.TradingAmount | double | 成交額 ,單位:元 |
| Data.TradingAmount | int | 成交量,單位:股 |
| Data.Swing | double | 振幅,單位:% |
| Data.ChangePercent | double | 漲跌幅 ,單位:% |
| Data.ChangeAmount | double | 漲跌額 ,單位:元 |
| Data.TurnoverRate | double | 換手率 ,單位:% |
5. 接口 HTTP 響應(yīng)標(biāo)準(zhǔn)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 200 | 接口正常響應(yīng) | 業(yè)務(wù)狀態(tài)碼參見下方 接口自定義狀態(tài)碼 |
| 403 | 請求頻率超限 | CDN 層通過 IP 請求頻率智能判斷,一般的高頻請求不會觸發(fā)此狀態(tài)碼 |
6. 接口響應(yīng)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態(tài)碼斷言接口正常返回 |
| -1 | 請求失敗 | 請求處理請求失敗 |
| 501 | 參數(shù)錯誤 | 請檢查您傳遞的參數(shù)個數(shù)以及參數(shù)類型是否匹配 |
| 502 | 請求頻率受限 | 一般建議每秒請求不超過 100 次 |
| 503 | APPKEY 權(quán)限超限/訂單到期 | 請至開發(fā)者中心檢查您的 APPKEY 是否到期或是否權(quán)限超限 |
| 504 | APPKEY 錯誤 | 請檢查傳遞的 APPKEY 是否為開發(fā)者中心獲取到的值 |
| 505 | 請求的次數(shù)超出接口限制 | 請檢查對應(yīng)接口是否有請求次數(shù)限制以及您目前的接口請求剩余次數(shù) |
| 900 | 接口內(nèi)部響應(yīng)錯誤 | 接口可用性為 99.999%,如獲取到此狀態(tài)碼請郵件聯(lián)系我們 |
7. 開發(fā)語言請求示例代碼
示例代碼包含的開發(fā)語言:C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等,其他語言進行對應(yīng)的 RESTful API 請求實現(xiàn)即可。

8. 常見問題 Q&A
-
Q: 數(shù)據(jù)請求有緩存嗎?
A: 所有的數(shù)據(jù)都是直接返回的,部分周期性數(shù)據(jù)在更新周期內(nèi)數(shù)據(jù)是緩存的。
-
Q: 如何保證請求時 key 的安全性?
A: 一般建議將對我們 API 的請求放置在您應(yīng)用的后端服務(wù)中發(fā)起,您應(yīng)用的所有前端請求都應(yīng)該指向您自己的后端服務(wù),這樣的架構(gòu)也更加地純粹且易維護。
-
Q: 接口可以用于哪些開發(fā)語言?
A: 可以使用于所有可以進行網(wǎng)絡(luò)請求的開發(fā)語言,用于您項目快速地進行數(shù)據(jù)構(gòu)建。
-
Q: 接口的性能可以保證嗎?
A: 接口后臺架構(gòu)和我們給企業(yè)提供的商業(yè)項目架構(gòu)一致,您可以通過訪問測試接口查看接口相關(guān)返回性能與信息。
咕咕數(shù)據(jù),專業(yè)的數(shù)據(jù)提供商,提供專業(yè)全面的數(shù)據(jù)接口、商業(yè)數(shù)據(jù)分析,讓數(shù)據(jù)成為您的生產(chǎn)原料。

咕咕數(shù)據(jù)基于我們七年來為企業(yè)客戶提供的千億級數(shù)據(jù)存儲與性能優(yōu)化、相關(guān)海量基礎(chǔ)數(shù)據(jù)支撐,將合規(guī)的部分通用數(shù)據(jù)、通用功能抽象成產(chǎn)品級數(shù)據(jù) API,大大滿足了用戶在產(chǎn)品開發(fā)過程中對基礎(chǔ)數(shù)據(jù)的需求,同時降低了海量數(shù)據(jù)的存儲與運維成本,以及復(fù)雜功能的技術(shù)門檻與人力開發(fā)成本。
除了我們已開放的分類數(shù)據(jù)與功能接口外,還有海量數(shù)據(jù)正在整理、清洗、整合、構(gòu)建中,后期會開放更多的數(shù)據(jù)與云端功能接口 API 供用戶使用。