开发文档

Base URL：http://aiguq.com —— 19 个数据接口 + WebSocket 实时推送，覆盖 A 股量化所需的行情、板块、财务、日历全量数据面。全部 GET 请求、JSON 返回、零依赖。

平台概览 #

覆盖沪深北三市 5227 只标的，数据粒度从逐笔分笔到月线，从盘口快照到财务报表。数据目录：

通用约定 #

统一响应结构

成功与错误是两种 JSON 形态：

// 成功：HTTP 200，code = 0，业务数据全部在 data
{ "code": 0, "msg": "ok", "ts": 1792294420366, "data": { ... }, "tier": "企业版" }

// 失败：HTTP 4xx/5xx，body 只有 detail；响应头 x-rate-reason 携带原因
HTTP/1.1 429 Too Many Requests
x-rate-reason: day_limit
{ "detail": "超过当日配额" }

证券代码格式

全站统一 交易所后缀 格式，传入 6 位裸代码时自动识别市场：

字段单位约定

数据时区均为北京时间；ts 是服务器响应时刻，time 是行情本身的时刻。字段值为空时返回 null（不会返回 NaN 或乱码哨兵值）。

鉴权方式 #

两种方式等价，任选其一：

快速开始 #

三步完成第一次调用：① 在 控制台注册并复制 API Key → ② 复制下方任一示例（替换 ak-...）→ ③ 运行。

# 实时行情：贵州茅台
curl "http://aiguq.com/v1/quote?code=600519" \
     -H "X-API-Key: ak-你的Key"

# pip install requests
import requests

KEY = {"X-API-Key": "ak-你的Key"}
r = requests.get("http://aiguq.com/v1/quote",
                 headers=KEY, params={"code": "600519"})
data = r.json()
if data["code"] == 0:
    item = data["data"]["item"]
    print(item["last"], item["change_pct"], "%")
else:
    print("出错:", data["detail"] if r.status_code != 200 else data["msg"])

// 浏览器 / Node 均可
const r = await fetch(
  "http://aiguq.com/v1/quote?code=600519",
  { headers: { "X-API-Key": "ak-你的Key" } });
const data = await r.json();
console.log(data.data.item.last);

在线调试台 #

填入你的 Key，点「发送」直接看真实返回 —— 调不通时先来这里复现。

// 返回结果将显示在这里。Key 只发往本站，不会存到任何地方。

实时快照 · /v1/quote #

单只标的的最新快照：价格、量额与五档盘口。盘中实时更新，收盘后返回最终快照。

// GET /v1/quote?code=600519 → 200 OK
{ "code": 0, "msg": "ok",
  "data": { "item": {
    "code": "600519.SH",   "last": 1329.0,
    "open": 1311.57,       "high": 1329.88,
    "low": 1301.68,        "pre_close": 1312.97,
    "change_pct": 1.22,    "volume": 38502,
    "amount": 5075528300,  "pvolume": 3850175,
    "status": 5,           "time": 1792135817000,
    "ask": [1329.0, ...],  "bid": [1328.9, ...],
    "ask_vol": [12, ...],  "bid_vol": [30, ...]
} } }

批量行情 · /v1/quote/batch #

一次拉多只快照，字段与 quote 完全一致，一次请求只计 1 次调用。

K 线 · /v1/kline #

OHLCV 完整的 K 线序列：8 种周期 × 5 种复权方式 × 支持任意起止区间，无需预下载数据。冷门标的分钟线首次请求触发服务端补数（1-3 秒）。

// GET /v1/kline?code=600519&period=1d&count=2÷nd_type=back
{ "code": 0, "msg": "ok",
  "data": { "code": "600519.SH", "period": "1d", "dividend_type": "back",
    "bars": [
      { "t": "20261015", "o": 8067.8916, "h": 8227.479, "l": 8047.7924,
        "c": 8203.4102,  "v": 57677, "a": 7537706224.0, "pre_close": 8067.8916 },
      { "t": "20261016", "o": 8196.3755, "h": 8288.3794, "l": 8146.6803,
        "c": 8283.9576,  "v": 38502, "a": 5075528306.0, "pre_close": 8203.4102 }
] } }

历史分笔 · /v1/tick_history #

单标的单日逐笔成交回放（含盘口快照），用于微观结构研究、主买主卖拆解、回测滑点建模。重量端点：一次调用计 5 次配额。

// GET /v1/tick_history?code=600519&date=20261016&count=3
{ "code": 0, "msg": "ok",
  "data": { "code": "600519.SH", "date": "20261016", "count": 3,
    "trades": [ {
      "time": 1792135802000, "lastPrice": 1329.0,
      "open": 1311.57, "high": 1329.88, "low": 1301.68,
      "lastClose": 1312.97, "amount": 2658000, "volume": 20,
      "askPrice": [1329.0, 0.0, ...], "bidPrice": [0.0, ...],
      "askVol": [120, 0, ...], "bidVol": [0, 0, ...],
      "stockStatus": 0
    }, ... ] } }

每笔均为当时点的累计快照（累计量额 + 当时五档），与行情软件分笔口径一致；相邻两笔的 volume 差值即该笔成交量。

涨幅榜 · /v1/rank · 涨停池 · /v1/zt_pool #

均无参数。rank 返回全市场涨幅 Top100；zt_pool 返回当日处于涨停价的股票（主板 10% / 创业板·科创板 20% / 北交所 30% 规则）。服务端 60 秒缓存。

// GET /v1/zt_pool
{ "code": 0, "msg": "ok",
  "data": { "count": 62, "items": [
    { "code": "300045.SZ", "last": 12.7,  "change_pct": 20.04, "volume": 714936 },
    { "code": "688592.SH", "last": 24.98, "change_pct": 19.98, "volume": 52809 },
    ... ] } }

字段：code · last（元）· change_pct（%）· volume（手）。非交易日返回上一交易日收盘后的结果。

大盘指数 · /v1/index · /f/ticker #

/v1/index 需 Key；/f/ticker 免 Key、不计用量，返回相同的五大核心指数（上证指数 / 深证成指 / 创业板指 / 沪深300 / 科创50），可用于链路验证：

// GET /v1/index
{ "code": 0, "msg": "ok",
  "data": { "items": [
    { "code": "000001.SH", "name": "上证指数", "last": 3716.284, "change_pct": 0.24 },
    ... ] } }

WebSocket 实时推送 · /ws #

订阅制 tick 实时推送，毫秒级触达。连接：ws://aiguq.com/ws?key=ak-你的Key。订阅上限：标准 3 只 / 专业 50 只 / 企业 500 只；单 Key 并发连接上限 3。

# ↑ 客户端指令
{"op": "sub",   "codes": ["600519.SH", "000001.SZ"]}
{"op": "unsub", "codes": ["000001.SZ"]}

# ↓ 服务端每笔推送（成交触发，非定时）
{"code":"600519.SH","last":1329.0,"change_pct":1.22,"volume":38502,"time":1792135817000}

# Python 完整示例（pip install websocket-client）
import json, websocket

def on_open(ws):
    ws.send(json.dumps({"op": "sub", "codes": ["600519.SH"]}))

def on_message(ws, m):
    d = json.loads(m)
    print(d["code"], d["last"], d["change_pct"], "%")

ws = websocket.WebSocketApp("ws://aiguq.com/ws?key=ak-你的Key",
    on_open=on_open, on_message=on_message)
ws.run_forever(reconnect=3)  # 断线3秒自动重连

证券列表 · /v1/stock_list #

指定市场的全部证券代码，构建股票池、批量遍历的基础。

// GET /v1/stock_list?market=SH
{ "code": 0, "msg": "ok",
  "data": { "count": 2320, "items": ["600000.SH", "600004.SH", ...] } }

合约信息 · /v1/instrument #

证券静态要素：名称、上市日期、当日涨跌停价、股本结构、最小变动价位、交易状态。做涨跌停判断、换手率计算、次新过滤的必备数据。

// GET /v1/instrument?code=600519
{ "code": 0, "msg": "ok",
  "data": { "item": {
    "ExchangeID": "SH",        "InstrumentID": "600519",
    "InstrumentName": "贵州茅台",
    "open_date": "20010827",   "trading_day": "20261016",
    "PreClose": 1312.97,       "UpStopPrice": 1444.27,
    "DownStopPrice": 1181.67,  "FloatVolume": 1250081601,
    "TotalVolume": 1250081601, "PriceTick": 0.01,
    "VolumeMultiple": 1,       "InstrumentStatus": 0,
    "IsTrading": false,        "ExpireDate": "99999999"
} } }

板块 · /v1/sector_list · /v1/sector #

7000+ 板块分类：行业（含申万体系）、概念、地域、指数板块。sector_list 拿板块名，sector 拿成分股。

// GET /v1/sector_list?keyword=银行&limit=5
{ "code": 0, "msg": "ok",
  "data": { "count": 5,
    "items": ["1000SW1银行", "1000SW2国有大型银行",
              "1000SW2股份制银行", "1000SW2银行", "300SW1银行"] } }

// GET /v1/sector?name=1000SW1银行
{ "code": 0, "msg": "ok",
  "data": { "sector": "1000SW1银行", "count": 42,
            "items": ["001227.SZ", "002807.SZ", ...] } }

板块名即板块ID，直接传给 sector 即可。静态数据，按周更新即可，无需盘中高频拉取。

指数权重 · /v1/index_weight #

指数成分及权重（按权重降序），指数增强、行业中性、组合复制的基础数据。

// GET /v1/index_weight?index=000300.SH
{ "code": 0, "msg": "ok",
  "data": { "index": "000300.SH", "count": 300,
    "items": [ { "code": "600519.SH", "weight": 5.736 },
               { "code": "300750.SZ", "weight": 2.888 },
               { "code": "601318.SH", "weight": 2.623 }, ... ] } }

weight 单位 %，合计 100。服务端缓存 24 小时。

财务数据 · /v1/financial #

8 张财务报表，返回报告期全字段。重量端点：一次调用计 2 次配额。

// GET /v1/financial?code=600519&table=Income&count=1
{ "code": 0, "msg": "ok",
  "data": { "code": "600519.SH", "tables": { "Income": {
    "count": 1,
    "records": [ { "m_timetag": "20260630",  "m_anntime": "20260815",
                   "revenue_inc": 90703260964.48,
                   "total_operating_cost": 30946044878.08,
                   "research_expenses": 114926219.6,   ... } ] } } } }

除权除息 · /v1/dividend #

证券全部历史除权除息记录与复权因子。

// GET /v1/dividend?code=600519
{ "code": 0, "msg": "ok",
  "data": { "code": "600519.SH", "count": 30,
    "items": [ { "date": "20260626", "time": 1782403200000,
                 "interest": 28.02423, "stockBonus": 0,
                 "stockGift": 0, "allotNum": 0, "allotPrice": 0,
                 "gugai": 0, "dr": 1.023663 }, ... ] } }

交易日历 · /v1/trading_dates #

交易日列表 + 节假日列表，回测循环与任务调度的基础。

// GET /v1/trading_dates?start_time=20261001&end_time=20261018
{ "code": 0, "msg": "ok",
  "data": { "dates": ["20261008", "20261009", "20261012", ...],
            "holidays": ["19910101", ..., "20261001", "20261002", ...] } }

可转债 · /v1/cb_info #

可转债基础信息：发行要素、票息、转股条款。

// GET /v1/cb_info?code=123289.SZ
{ "code": 0, "msg": "ok",
  "data": { "item": {
    "bondCode": "123289.SZ",  "bondName": "中科转债",
    "stockCode": "301175.SZ", "stockName": "中科环保",
    "bondMaturity": 6,        "bondParvalue": 100,
    "bondIssuePrice": 100,    "bondIssueSize": 1000000000,
    "bondReMainSize": 1000000000,
    "bondValueDate": 20261016, "bondMaturityDate": 20321016,
    "bondCouponRate": 0.2,    "convStartDate": 20270422, ... } } }

核心字段：bondMaturity 期限（年）· bondParvalue 面值（元）· bondIssueSize / bondReMainSize 发行/剩余规模（元）· bondCouponRate 票面利率（%）· bondValueDate / bondMaturityDate 起息/到期日 · convStartDate 转股起始日 · bondListDate / delistDate 上市/退市日。

新股申购 · /v1/ipo #

时间范围内的 IPO / 新股转债申购信息（含可转债发行）。

// GET /v1/ipo?start_time=20261001&end_time=20261018
{ "code": 0, "msg": "ok",
  "data": { "count": 5, "items": [ {
    "securityCode": "123289", "codeName": "中科转债",
    "market": "SZ", "onlineSubCode": "371175",
    "onlineSubMaxQty": 10000, "publishPrice": 100.0,
    "startDate": 20261016, "isProfit": 0,
    "industryPe": 0.0, "afterPE": 0.0 }, ... ] } }

actIssueQty 发行总量（股）· onlineSubCode / onlineSubMaxQty 申购代码 / 申购上限（股）· publishPrice 发行价（元）· industryPe / afterPE 行业/发行后市盈率。

ETF 申赎 · /v1/etf_info #

ETF 申赎清单要素（现金差额、份额净值、申赎单位等），套利与做市策略用。服务端缓存 24 小时。

// GET /v1/etf_info?code=510300.SH
{ "code": 0, "msg": "ok",
  "data": { "code": "510300.SH", "count": 1, "records": [ {
    "基金代码": "510300", "基金名称": "300ETF",
    "现金差额": 101185.26, "预估现金差额": 104273.26,
    "基金份额净值": 4.2366, "最小申购、赎回单位净值": 3812972.26,
    "最小申购、赎回单位": 900000, "现金替代比例上限": 0.5,
    "是否需要公布IOPV": 1, "申购的允许情况": 1, ... } ] } }

用量查询 · /v1/usage #

查询当前 Key 的配额消耗，不消耗当日额度。

// GET /v1/usage
{ "code": 0, "msg": "ok",
  "data": { "used": 20, "quota": 100000, "minute": 100000,
            "tier": "ent",
            "history": [ { "day": "2026-10-18", "calls": 20 } ] } }

xtquant 零改造迁移 #

已有 xtquant 代码？下载 aigu_xt.py 放进项目，只改一行 import，接口签名保持一致：

# 原来： from xtquant import xtdata
现在： import aigu_xt as xtdata

xtdata.connect(api_key="ak-你的Key")          # 或环境变量 AIGU_API_KEY
xtdata.get_full_tick(["600519.SH"])
xtdata.get_market_data_ex([], ["000001"], period="1d", count=60)
xtdata.subscribe_quote("600519.SH", callback=print)

兼容层支持行情快照、K 线、证券列表与实时订阅等常用场景，K 线无需预下载数据；实时订阅走 WebSocket（pip install websocket-client）。

错误码与排障 #

配额与限流规则 #

计费规则：一次 HTTP 数据请求计 1 次；批量行情计 1 次；financial 计 2 次、tick_history 计 5 次；/v1/usage 与 /f/ticker 不计费；WebSocket 推送不计次。日额度北京时间 0 点重置。

更新日志 #

常见问题 FAQ #