API 文档
本站全部数据的对外接口 · REST + SSE · 只读 GET · JSON(UTF-8) · 时间 ISO-8601(UTC)
Base URLhttps://dataapi.xiaoyinsi.com在线交互文档ReDoc(全参数与响应 schema)↗ · OpenAPI 源 /openapi.yaml鉴权除根路径、/docs、/health 外均需 API key:请求头 X-API-Key,或查询参数 ?api_key=(SSE/浏览器场景)。密钥请联系管理员开通。限流与计费默认 120 次/分钟(滑动窗口),超限 429 + Retry-After;开通 credits 计费的 key 每请求扣 1,SSE 每帧推送扣 1,余额耗尽 402。分页列表端点通用 limit(默认 50,上限 500)/offset;响应带 meta.total。
本站(data.xiaoyinsi.com)全部页面即由这套 API 驱动,所见即接口能力。
统一响应信封
// 列表端点
{ "data": [ ... ], "meta": { "total": 1514, "limit": 50, "offset": 0, "as_of": "…" } }
// 单资源端点: 直接返回对象
// 错误(任何端点, 配合 401/402/404/429/500)
{ "error": { "code": "NOT_FOUND", "message": "…" } }数据源三类,各分组备注标明:🔵 站内采集库(本站采集进程持续入库,新鲜度见各组)· 🔴 实时第三方(请求现抓,短缓存,无历史)· ⚡ SSE 推送(长连接,新数据秒级)。
端点目录
新闻快讯🔵 站内采集 · 入库 ≤1s 推送 · 24h 滚动窗口
/news
快讯检索:market(板块)/source(来源)/q(关键词)/from/to;枚举见 /news/markets、/news/sources
/news/streamSSE
实时推送:retry → snapshot(全量)→ append(增量);key 走 ?api_key=
/feed/{channel}
白牌频道(无来源/无外链,跨源去重,英文已翻中文):?limit=&since=&lang=;条目含 title_en/title_zh 按 id 双语配对;频道列表见 /feed/channels
/feed/{channel}/streamSSE
白牌实时流,协议同 /news/stream;lang=en 英文原文流(纯英文),默认中文流;只推近 2h 内发布的条目
SEC 文件 · 举牌 · 内部人🔵 站内落库 · ≤3 分钟入库 · 支持历史回查
/filings
SEC 文件流:type 前缀匹配含修正案(8-K/10-K/4/13F-HR/SCHEDULE 13D…)/from/to;举牌(13D/13G)行富集 标的 ticker、申报人持股 pct、持股演变链 pct_prev/pct_change、逐人 filers[]、filing_basis(13D 理由 / 13G 申报依据,法定互斥一列渲染)等 20+ 字段
/insider-trades
内部人 Form 4 开放市场买卖:ticker/action/from/to;含成交价、股数与金额
政客交易🔵 三官方源聚合 · 小时级采集(申报法定滞后 ≤45 天)
/congress-trades
STOCK Act 披露:ticker/filer/party/chamber/branch/state/type/asset_type/owner/amount_min/days 等;全字段带中文 label(党派/州名全称/议院/持有人/方向/资产类别);price_est 交易日推算价;updated_since 增量同步
/congress/politicians
政客名录+交易统计:party/chamber/q/sort,驱动榜单与搜索
/congress/stats
热门统计:days 窗口;总笔数/买卖分解/热门标的/最活跃议员
机构 13F · 明星投资人🔵 holdings.db · 季度申报(月度检查)
/managers
搜机构管理人(q)或按 AUM 排序的全量目录(分页);8000+ 家申报机构
/managers/{cik}/holdings
某机构最新持仓;class 为 SEC 申报原文,putcall 附中文 label
/managers/{cik}/changes
相邻两季调仓差分:建仓/增持/减持/清仓,按市值变动排序
/managers/{cik}/evolution
组合演变:前 N 大持仓逐季市值时序
/holdings
反查:ticker= 或 cusip= 谁持有某票;/holdings/periods 可查询季度
/stars
明星投资人 43 位策展名单:结构化中英文名、13F 持仓(aum)、真·基金规模(raum, Form ADV)、分类 label、头像
高管 · 公司🔵 站内图谱 · 定时刷新
/executives
高管检索(q/company/role);/executives/{cik} 个人履历、/events 任免事件流
/executive-changes
全市场高管变动流:action(上任/离任/职务变更)/company
/companies
公司目录(q/letter/分页,total 为全量);/companies/{ticker} 档案、/executives 高管层、/board-analytics 董事会画像
个股评分 · 行情🔵 每日快照 + 🔴 实时行情
/scores
全池四维评分:min/sector/grade/sort;overall 0-100 与 A-F 档;/scores/{symbol} 单票(无则 404)
/tickers/{ticker}/prices
🔴 个股详情合集:日线、档案、市值(请求现抓,短缓存)
/ipos
🔴 近期与即将 IPO(6h 缓存)
/analysis/fundamentals
基本面事实层:PIT 财务/TTM/生存力 + 站内独家信号(政客/13F/内部人/评分),零 LLM 纯代码计算
ARK 基金 · Reddit 情绪🔵 每交易日 / 日内多轮
/funds/{fund}/holdings
ARK 某基金当前持仓;/trades 历史买卖、/funds/movers 仓位异动榜
/tickers/{ticker}/fund-ownership
反查某票在各 ARK 基金的仓位时序
/sentiment/reddit
散户社区热榜(board/limit);/timeseries 单票提及量时序
一级市场(未上市公司)🔵 Form D 全量 62.6 万份 + 融资新闻 + YC 名录
/pe/events
融资事件流(主视图):days/q/sector(七板块)/has_investors;一行=日期·公司·轮次·金额·投资方(领投在前,带类型标注)
/pe/companies
最近有融资的未上市公司列表;/pe/company?key= 单公司融资档案(轮次时间线+双证据溯源)
/pe/rounds
Form D 原始申报流(高级视图);/pe/news 融资新闻、/pe/yc YC 名录、/pe/stats 统计
数据中台🔵 万能时序与归档直通
/timeseries
通用时序查询;目录见 /timeseries/catalog
/datasets
每日 Parquet 归档分区列表;/datasets/{name}/{date} 下载分区文件
/health
数据中台健康度(免 key)
快速上手
# REST: 近 30 天 $100k+ 的政客股票交易 curl -H "X-API-Key: $KEY" \ "https://dataapi.xiaoyinsi.com/congress-trades?days=30&amount_min=100001&has_ticker=1" # SSE: 白牌快讯实时流(默认中文; lang=en 英文原文, 同 id 可双语配对) curl -N "https://dataapi.xiaoyinsi.com/feed/us/stream?api_key=$KEY"
// 浏览器 / Node
const es = new EventSource(`https://dataapi.xiaoyinsi.com/feed/us/stream?api_key=${KEY}`);
es.addEventListener("snapshot", (e) => console.log("全量", JSON.parse(e.data).items));
es.addEventListener("append", (e) => console.log("新快讯", JSON.parse(e.data).items));注意事项
- 🔴 实时第三方端点(行情/IPO)依赖上游可用性,偶发 5xx 请指数退避重试;此类端点无历史数据。
- 13F 为季度快照、法定滞后 ≤45 天;评分为每日快照——跨源组合数据注意时间基准不同。
- limit 全局上限 500,大批量请翻页,并发轰会触发 429。
- 图像资产为本站托管绝对 URL(政客头像/明星投资人头像/公司 logo),无 key、可长缓存,跨域直接可加载。
- 新闻快讯保留窗口 24 小时(可从上游重取的非财务数据);SEC/政客/13F 等数据线自入库之日起累积历史。