A 股歷史行情數(shù)據(jù) API 接口

A 股歷史行情數(shù)據(jù) API 接口

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

image.png

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

請求示例: https://api.gugudata.com/stock/cn?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&begindate=YOUR_VALUE&enddate=YOUR_VALUE&adjust=

數(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)即可。

image.png

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)原料。

image.png

咕咕數(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 供用戶使用。

目前已開放的數(shù)據(jù)接口 API

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容