A股分時(shí)交易數(shù)據(jù)辨图，全量A股分時(shí)交易數(shù)據(jù)，分鐘級(jí)交易數(shù)據(jù) / 多時(shí)間段區(qū)間肢藐。
1. 產(chǎn)品功能
支持所有 A 股分時(shí)交易數(shù)據(jù)查詢；
支持 1吱韭、5吆豹、15、30理盆、60 分鐘交易區(qū)間痘煤；
毫秒級(jí)查詢性能；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）猿规；
全面兼容 Apple ATS衷快；
全國多節(jié)點(diǎn) CDN 部署；
接口極速響應(yīng)姨俩，多臺(tái)服務(wù)器構(gòu)建 API 接口負(fù)載均衡蘸拔。
2. API 文檔
接口詳情: https://www.gugudata.com/api/details/stockcnperminute
接口地址: https://api.gugudata.com/stock/cn/stockcnperminute
返回格式: application/json; charset=utf-8
請(qǐng)求方式: GET
請(qǐng)求協(xié)議: HTTPS
請(qǐng)求示例: https://api.gugudata.com/stock/cn/stockcnperminute?appkey=YOUR_APPKEY &symbol=YOUR_VALUE &period=5 &begindate=YOUR_VALUE &enddate=YOUR_VALUE &adjust=YOUR_VALUE
數(shù)據(jù)預(yù)覽: https://www.gugudata.com/preview/stockcnperminute
接口測試: https://api.gugudata.com/stock/cn/stockcnperminute/demo
3. 請(qǐng)求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認(rèn)值 | 備注 | ||||
|---|---|---|---|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費(fèi)后獲取的 APPKEY | ||||
| symbol | string | 否 | YOUR_VALUE | 傳遞單支股票代碼，如: 600031环葵〉髑希可通過前置接口或參見 A 股股票代碼參數(shù)枚舉頁面 | ||||
| period | int | 否 | 5 | 交易數(shù)據(jù)時(shí)間區(qū)間，可選時(shí)間區(qū)間價(jià)參數(shù)為: 1 | 5 | 15 | 30 | 60 (分鐘)张遭， 其中 1 分鐘時(shí)間區(qū)間交易數(shù)據(jù)僅返回近 5 個(gè)交易日不復(fù)權(quán)數(shù)據(jù) |
| begindate | string | 否 | YOUR_VALUE | 交易開始時(shí)間邓萨，參數(shù)格式為: 2021-01-01 09:00:00 | ||||
| enddate | string | 否 | YOUR_VALUE | 交易結(jié)束時(shí)間，參數(shù)格式為: 2021-01-01 09:00:00，與開始時(shí)間最大時(shí)間跨度支持 366 個(gè)自然日缔恳，獲取全量數(shù)據(jù)請(qǐng)分批獲取宝剖，數(shù)據(jù)量較大，請(qǐng)保持合理的請(qǐng)求頻率 | ||||
| adjust | string | 否 | YOUR_VALUE | 查詢前復(fù)權(quán)歉甚、后復(fù)權(quán)數(shù)據(jù)万细，如果傳遞參數(shù)值為 pre，那么返回前復(fù)權(quán)數(shù)據(jù)（所有數(shù)據(jù)進(jìn)行了前復(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ù)返回時(shí)間 |
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量仁烹，一般用于分頁計(jì)算 |
| Data.Symbol | string | A 股股票代碼 |
| Data.TimeKey | double | 最新價(jià)，單位：元 |
| Data.Open | double | 今日開盤價(jià)咧虎，單位：元 |
| Data.Close | double | 昨收價(jià)卓缰，單位：元 |
| Data.High | double | 最高，單位：元 |
| Data.Low | double | 最低砰诵，單位：元 |
| Data.ChangePercent | double | 漲跌幅 征唬，單位：% |
| Data.ChangeAmount | double | 漲跌額 ，單位：元 |
| Data.TradingVolume | double | 成交量茁彭，單位：手 |
| Data.TradingAmount | int | 成交額 总寒，單位：元 |
| Data.Swing | double | 振幅，單位：% |
| Data.TurnoverRate | double | 換手率 理肺，單位：% |
5. 接口響應(yīng)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態(tài)碼斷言接口正常返回 |
| -1 | 請(qǐng)求失敗 | 請(qǐng)求處理請(qǐng)求失敗 |
| 501 | 參數(shù)錯(cuò)誤 | 請(qǐng)檢查您傳遞的參數(shù)個(gè)數(shù)以及參數(shù)類型是否匹配 |
| 502 | 請(qǐng)求頻率受限 | 一般建議每秒請(qǐng)求不超過 100 次 |
| 503 | APPKEY 權(quán)限超限/訂單到期 | 請(qǐng)至開發(fā)者中心檢查您的 APPKEY 是否到期或是否權(quán)限超限 |
| 504 | APPKEY 錯(cuò)誤 | 請(qǐng)檢查傳遞的 APPKEY 是否為開發(fā)者中心獲取到的值 |
| 505 | 請(qǐng)求的次數(shù)超出接口限制 | 請(qǐng)檢查對(duì)應(yīng)接口是否有請(qǐng)求次數(shù)限制以及您目前的接口請(qǐng)求剩余次數(shù) |
| 900 | 接口內(nèi)部響應(yīng)錯(cuò)誤 | 接口可用性為 99.999%摄闸，如獲取到此狀態(tài)碼請(qǐng)郵件聯(lián)系我們 |
6. 開發(fā)語言請(qǐng)求示例代碼
示例代碼包含的開發(fā)語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他語言進(jìn)行對(duì)應(yīng)的 RESTful API 請(qǐng)求實(shí)現(xiàn)即可妹萨。
7. 常見問題 Q&A
-
Q: 數(shù)據(jù)請(qǐng)求有緩存嗎年枕？
A: 所有的數(shù)據(jù)都是直接返回的，部分周期性數(shù)據(jù)在更新周期內(nèi)數(shù)據(jù)是緩存的乎完。
-
Q: 如何保證請(qǐng)求時(shí) key 的安全性熏兄？
A: 一般建議將對(duì)我們 API 的請(qǐng)求放置在您應(yīng)用的后端服務(wù)中發(fā)起，您應(yīng)用的所有前端請(qǐng)求都應(yīng)該指向您自己的后端服務(wù)树姨，這樣的架構(gòu)也更加地純粹且易維護(hù)摩桶。
-
Q: 接口可以用于哪些開發(fā)語言？
A: 可以使用于所有可以進(jìn)行網(wǎng)絡(luò)請(qǐng)求的開發(fā)語言娃弓，用于您項(xiàng)目快速地進(jìn)行數(shù)據(jù)構(gòu)建典格。
-
Q: 接口的性能可以保證嗎？
A: 接口后臺(tái)架構(gòu)和我們給企業(yè)提供的商業(yè)項(xiàng)目架構(gòu)一致台丛，您可以通過訪問測試接口查看接口相關(guān)返回性能與信息耍缴。
咕咕數(shù)據(jù)砾肺，專業(yè)的數(shù)據(jù)提供商，提供專業(yè)全面的數(shù)據(jù)接口防嗡、商業(yè)數(shù)據(jù)分析变汪，讓數(shù)據(jù)成為您的生產(chǎn)原料。
咕咕數(shù)據(jù)基于我們七年來為企業(yè)客戶提供的千億級(jí)數(shù)據(jù)存儲(chǔ)與性能優(yōu)化蚁趁、相關(guān)海量基礎(chǔ)數(shù)據(jù)支撐裙盾，將合規(guī)的部分通用數(shù)據(jù)、通用功能抽象成產(chǎn)品級(jí)數(shù)據(jù) API他嫡，大大滿足了用戶在產(chǎn)品開發(fā)過程中對(duì)基礎(chǔ)數(shù)據(jù)的需求番官，同時(shí)降低了海量數(shù)據(jù)的存儲(chǔ)與運(yùn)維成本，以及復(fù)雜功能的技術(shù)門檻與人力開發(fā)成本钢属。
除了我們已開放的分類數(shù)據(jù)與功能接口外徘熔，還有海量數(shù)據(jù)正在整理、清洗淆党、整合酷师、構(gòu)建中，后期會(huì)開放更多的數(shù)據(jù)與云端功能接口 API 供用戶使用染乌。
