跳到内容
API v1 · 2026-11-17

API 文档

以统一数据结构覆盖 46 个市场(AMF · SEC · BaFin · SIX SER · RNS · SEDI · Consob · CNMV · AFM · FSMA · Oslo · Helsinki · Copenhagen · ASX · FMA · CVM · HKEX · BSE-Sofia · Tadawul · DART · EDINET · SSE · SZSE · SEBI · KNF · PSE · NZX · JSE)的内部人交易 API。 金额统一换算为 EUR/USD。内联提供散户视角的 T+30/T+90/T+365 回测。评分透明(7 个可拆解因子)。 原生支持 AI:为 Claude、Cursor、Windsurf 提供 MCP 服务器。API 随 Pro 与 Quant 套餐开放。

交互式 Swagger UI ↗面向 AI 的 MCP 服务器 ↗生成 API 密钥 ↗OpenAPI JSON 规范 ↗与 Quiver、OpenInsider 对比 ↗
API 访问 · 封闭测试
Insiders Trades 目前处于封闭测试阶段。API 和 MCP 服务器随 Pro 与 Quant 套餐开放。加入候补名单即可提前使用(每日 334 次请求、5 年 API 历史数据、MCP、邮件提醒)。
响应示例 · GET /v1/declarations
$ 
入门

快速开始

三步发出第一个请求:

  1. 创建账户,然后前往 我的账户 → API 密钥。
  2. 生成一个带名称的密钥(例如 "Production bot")。请立即复制,之后将不再显示。
  3. 在每个请求中加入请求头 Authorization: Bearer <key>。
curl https://insiders-trades.com/api/v1/me \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
安全

认证

每个请求必须包含恰好一个有效且未撤销的 API 密钥。支持以下两种格式:

  • Authorization: Bearer <key> · 标准方式,推荐使用。
  • X-Api-Key: <key> · 当您的 HTTP 客户端无法妥善处理 Authorization 请求头时的替代方式。
密钥仅在创建时显示一次。如果遗失,请撤销后重新生成。限制:每个账户最多 10 个有效密钥。已撤销的密钥仍会保留在历史记录中。

密钥格式

text
sit_live_<32 个 base62 字符>

可见前缀示例(可安全写入日志):sit_live_Ab1C
完整密钥约 40 个字符。服务器端以哈希(SHA-256)形式存储,
无法以明文找回。

密钥无效、过期或已撤销

任何认证错误都会以统一格式返回 HTTP 401:

json
{
 "error": {
 "code": "invalid_api_key",
 "message": "API 密钥无效、未知或已撤销。请在您的账户中生成新密钥。",
 "status": 401
 }
}
基础

核心概念

基础 URL

text
https://insiders-trades.com

通用元数据

每个 200 响应都包含一个 meta 对象,其中有服务器延迟,以及一个 dataFreshness 小字典,记录各数据块的最后更新时间,便于客户端判断是否需要使缓存失效。

json
{
 "items": [ /* ... */ ],
 "meta": {
 "requestedAt": "2026-04-20T18:32:11.123Z",
 "latencyMs": 47,
 "dataFreshness": {
 "priceAt": "2026-04-20T16:01:45.120Z",
 "financialsAt": "2026-04-20T15:04:10.940Z"
 }
 }
}

分页

列表类端点支持 ?limit(默认 50,最大 200)和 ?offset(默认 0)。返回的 total 字段可用于遍历全部结果。

时间戳格式

所有时间戳均为 ISO 8601 UTC 格式(2026-04-20T18:32:11.123Z)。

可为空的字段

数据库中缺失的字段会序列化为 null(绝不省略),从而可以区分 "数据缺失" 与字段错误。

BigInt(金额)

marketCap、revenue、totalAmount 等字段可能超出 JS 浮点数的精度范围(253)。它们以数字形式返回,但对于较大的总额(如 L'Oréal 的 1950 亿欧元…),如果需要精确到 1 欧元以下,客户端代码应使用 BigInt。

API 参考

端点

所有端点均为只读,按领域分组。所有列表类端点均可通过 ?market=<code> 进行跨市场筛选(代码见 GET /v1/markets)。

── 认证
GET/api/v1/me

验证密钥并获取身份信息

返回密钥所有者的信息以及密钥本身的元数据。可作为 ping 用于确认密钥仍然有效。

curl https://insiders-trades.com/api/v1/me -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
── 状态与统计
GET/api/v1/health

系统状态

检测数据库连通性(附实测延迟),并记录数据管道各阶段的时间戳。可用于发现每小时定时任务或评分任务已停止。

bash
curl https://insiders-trades.com/api/v1/health -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
响应(节选)
json
{
 "status": "ok",
 "database": { "reachable": true, "latencyMs": 187 },
 "lastAmfPublicationAt": "2026-04-20T16:20:03.577Z",
 "lastIngestAt": "2026-04-20T16:59:53.841Z",
 "lastScoringAt": "2026-04-20T17:59:59.061Z",
 "lastBacktestAt": "2026-04-19T20:13:54.245Z",
 "lastFinancialsAt": "2026-04-20T15:04:10.940Z",
 "lastPriceAt": "2026-04-20T16:01:45.120Z"
}
GET/api/v1/stats

全局计数

申报、公司、内部人及回测的总数,按时间窗口(24 小时 / 7 天 / 30 天)的细分,以及全局平均评分。

bash
curl https://insiders-trades.com/api/v1/stats -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/markets

列出支持的市场 / 监管机构

已接入的监管机构目录,附实时计数(申报、公司)及各市场的覆盖时间窗口。建议在集成启动时调用一次,以确认可用数据。

bash
curl https://insiders-trades.com/api/v1/markets -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
json
{
 "total": { "markets": 8, "declarations": 31420, "companies": 2480 },
 "markets": [
 { "code": "fr", "iso": "FR", "label": "FR", "regulator": "AMF",
 "currency": "EUR", "declarations": 18900, "companies": 1240,
 "coverage": { "oldestPubDate": "2015-01-05T...", "latestPubDate": "2026-05-17T..." } },
 { "code": "us", "iso": "US", "label": "US", "regulator": "SEC (Form 4)",
 "currency": "USD", "declarations": 9100, "companies": 720, "coverage": { ... } },
 { "code": "de", "regulator": "BaFin", ... },
 { "code": "ch", "regulator": "SIX SER", ... },
 { "code": "uk", "regulator": "RNS (LSE)", ... },
 { "code": "ca", "regulator": "SEDI", ... },
 { "code": "it", "regulator": "Consob", ... },
 { "code": "es", "regulator": "CNMV", ... }
 ],
 "meta": { "requestedAt": "...", "latencyMs": 90 }
}
── 公司
GET/api/v1/companies

列出公司

返回筛选后的公司。

查询参数
名称类型默认值说明
qstring·按名称搜索(不区分大小写)
isinstring·按 ISIN 精确筛选
marketstring·按上市市场筛选(例如 Euronext Paris)
marketCodeenum·市场代码,以 GET /api/v1/markets 列出的为准(例如 fr、us、jp)
hasLogoboolean·仅返回有(true)或没有(false)标志的公司
sortenumnamename | marketCap | recent
orderenumascasc | desc
limitinteger501 → 200
offsetinteger0分页偏移量
bash
curl "https://insiders-trades.com/api/v1/companies?q=lvmh&limit=3" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
响应(截断)
json
{
 "total": 585, "offset": 0, "limit": 3,
 "items": [
 {
 "name": "LVMH MOET HENNESSY-LOUIS VUITTON",
 "slug": "lvmh-moet-hennessy-louis-vuitton-0042",
 "isin": "FR0000121014",
 "market": "Euronext Paris",
 "yahooSymbol": "MC.PA",
 "marketCap": 320200000000,
 "currentPrice": 643.40,
 "trailingPE": 22.43,
 "analystReco": "buy",
 "targetMean": 595.72,
 "logoUrl": "https://.../lvmh.webp",
 "declarationsCount": 147,
 "priceAt": "2026-04-20T16:01:45.120Z",
 "financialsAt": "2026-04-20T15:04:10.940Z"
 }
 ],
 "meta": { "requestedAt": "...", "latencyMs": 650, "dataFreshness": { ... } }
}
GET/api/v1/companies/{slug}

公司详情(完整基本面)

返回完整档案:利润表、资产负债表、估值(P/E、P/B、beta)、分析师一致预期(评级、目标价均值/高/低)以及技术指标(52 周、50/200 日均线、股息率)。

路径参数
名称类型默认值说明
slug必填string·公司的唯一 URL 标识(见列表)
bash
curl https://insiders-trades.com/api/v1/companies/bouygues-1454 \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
对于没有分析师覆盖的微型股,市场数据字段(trailingPE、analystReco、targetMean…)可能为 null。
GET/api/v1/companies/{slug}/declarations

某公司的内部人申报

某公司高管的完整交易历史,按 pubDate 降序排列。

路径参数
名称类型默认值说明
slug必填string·公司 slug
查询参数
名称类型默认值说明
directionenum·BUY | SELL(默认:全部)
minScorenumber·signalScore 阈值
limitinteger501 → 200
offsetinteger0分页偏移量
bash
curl "https://insiders-trades.com/api/v1/companies/bouygues-1454/declarations?direction=BUY&minScore=40&limit=5" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/companies/{slug}/insider-flow

汇总的内部人净买入 / 净卖出流量

单家公司的净买入减净卖出,按月(或 ISO 周)分桶,附按内部人汇总及 90 天滚动信号。用于识别增持或减持阶段。

路径参数
名称类型默认值说明
slug必填string·公司 slug
查询参数
名称类型默认值说明
windowDaysinteger73030 → 3650 天
bucketenummonthmonth | week
bash
curl "https://insiders-trades.com/api/v1/companies/bouygues-1454/insider-flow?windowDays=365&bucket=month" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
json
{
 "company": { "name": "BOUYGUES", "slug": "bouygues-1454", "marketCap": 12400000000 },
 "windowDays": 365, "bucket": "month",
 "totals": { "tradeCount": 47, "buyAmount": 18450000, "sellAmount": 2100000, "netAmount": 16350000, "sellToBuyRatio": 0.114 },
 "rolling90d": { "buyAmount": 7800000, "sellAmount": 0, "netAmount": 7800000 },
 "buckets": [
 { "period": "2025-06", "buyAmount": 1200000, "sellAmount": 0, "netAmount": 1200000, "tradeCount": 4 },
 { "period": "2025-07", "buyAmount": 840000, "sellAmount": 320000, "netAmount": 520000, "tradeCount": 3 }
 ],
 "topInsiders": [
 { "name": "M. BOUYGUES", "slug": "martin-bouygues", "function": "PDG",
 "buyAmount": 6400000, "sellAmount": 0, "netAmount": 6400000, "tradeCount": 12 }
 ]
}
── 高管
GET/api/v1/insiders

列出高管

已跟踪的高管,支持按姓名模糊搜索。

查询参数
名称类型默认值说明
qstring·按名称搜索(不区分大小写)
limitinteger501 → 200
offsetinteger0分页偏移量
bash
curl "https://insiders-trades.com/api/v1/insiders?q=arnault&limit=5" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/insiders/{slug}

高管详情

个人档案、所关联的公司及职位,以及其申报的平均评分和最高评分。

路径参数
名称类型默认值说明
slug必填string·高管 slug
bash
curl https://insiders-trades.com/api/v1/insiders/bernard-arnault \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/insiders/{slug}/declarations

某高管的交易历史

完整的交易链,涵盖所有公司,按 pubDate 降序排列。

路径参数
名称类型默认值说明
slug必填string·高管 slug
查询参数
名称类型默认值说明
limitinteger50Max 200
offsetinteger0分页偏移量
bash
curl https://insiders-trades.com/api/v1/insiders/bernard-arnault/declarations \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/insiders/{slug}/timeline

带累计持仓的时间线

单个内部人按时间排序的交易,并逐行重算各公司的累计成交量,可逐笔看到持仓的形成过程。

路径参数
名称类型默认值说明
slug必填string·高管 slug
查询参数
名称类型默认值说明
fromISO date·pubDate 下限(可选)
toISO date·pubDate 上限(可选)
limitinteger5001 → 2000
bash
curl "https://insiders-trades.com/api/v1/insiders/bernard-arnault/timeline?from=2024-01-01&limit=200" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
── 申报
GET/api/v1/declarations

高级申报搜索

通用端点,提供 12 个可组合的筛选条件。是导出历史数据集或按条件分析的主要入口。

查询参数
名称类型默认值说明
marketenum·市场代码,以 GET /api/v1/markets 列出的为准(默认:all)
currencyenum·EUR | USD | GBP | CHF | SEK | NOK | DKK | AUD | CAD · 增加 transaction.converted
sinceISO date·from 的别名。与 sort=pubDate&order=asc 搭配可实现增量轮询。
includestring·需内联的关联对象(CSV 格式)。支持:backtest
fromISO date·筛选 pubDate >= from
toISO date·筛选 pubDate <= to
minScorenumber·signalScore 最低阈值
maxScorenumber·signalScore 最高阈值
directionenum·BUY | SELL
clusterboolean·true = 仅集群交易
minAmountnumber·最低金额(€)
companystring·按公司名称搜索
insiderstring·按高管姓名搜索
isinstring·按 ISIN 精确筛选
sortenumpubDatepubDate | signalScore | amount
orderenumdescasc | desc
limitinteger501 → 200
offsetinteger0分页偏移量
bash
# 过去 30 天 v3 评分 ≥ 50 的前 20 个买入信号
curl "https://insiders-trades.com/api/v1/declarations?direction=BUY&minScore=50&from=2026-03-20&sort=signalScore&order=desc&limit=20" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
多市场示例
bash
# 仅美国买入,金额以 EUR 计,并内联 backtest
curl "https://insiders-trades.com/api/v1/declarations?market=us&direction=BUY&currency=EUR&include=backtest&limit=20" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

# 增量轮询:自昨日以来的所有新申报,按升序排列
curl "https://insiders-trades.com/api/v1/declarations?since=2026-05-16&sort=pubDate&order=asc&limit=200" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

# DE+CH 集群买入(德国 Vorstand + 瑞士董事会),金额超过 50 万 EUR
curl "https://insiders-trades.com/api/v1/declarations?market=de&cluster=true&minAmount=500000" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/declarations/{amfId}

申报详情(含回测)

完整对象,如已计算则包含散户视角的 T+30/90/365 回测。入场价:pubDate+1 收盘价。

路径参数
名称类型默认值说明
amfId必填string·AMF 标识(例如 2026DD1108988)
bash
curl https://insiders-trades.com/api/v1/declarations/2026DD1108988 \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
backtest 数据块节选
json
"backtest": {
"returnBasis": "retail_pubDate_plus_1_close",
 "direction": "BUY",
"priceAtPub": 33.10,
"returnsPct": {
  "T30": 4.16,
  "T90": 8.23,
  "T365": 19.88
},
"pubLeakPct": 2.0,
 "computedAt": "2026-04-19T20:13:54.245Z"
}
── 信号
GET/api/v1/signals

热门信号(买入 / 卖出)

快速获取滚动时间窗口内评分最高的信号。适合仪表盘或通知机器人。

查询参数
名称类型默认值说明
directionenumBUYBUY | SELL
lookbackDaysinteger7时间窗口(1 → 90)
minScoreinteger40最低评分(0 → 100)
limitinteger20Max 100
bash
curl "https://insiders-trades.com/api/v1/signals?direction=BUY&minScore=50&lookbackDays=7&limit=5" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
── 评分(透明度)
GET/api/v1/scoring/explain/{amfId}

将 signalScore 拆解为 7 个加权因子

返回 v3 综合评分 7 个因子中每个因子的取值、原始得分、上限及简要说明。没有黑箱,任何信号都可自行审计。方法论:见 /methodology。

路径参数
名称类型默认值说明
amfId必填string·唯一标识(例如 2026DD1108988 或 SEC:0001127602-25-009876)
bash
curl https://insiders-trades.com/api/v1/scoring/explain/SEC:0001127602-25-009876 \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
json
{
 "declaration": { "amfId": "SEC:...", "storedScore": 78, "direction": "BUY", ... },
 "breakdown": {
 "sumFactorPoints": 78,
 "factors": [
 { "key": "pctOfMarketCap", "label": "Trade size vs market cap",
 "value": 0.42, "points": 14, "maxPoints": 16, "description": "Log-scaled..." },
 { "key": "directionalCluster", "label": "Directional cluster (±30d)",
 "value": 3, "points": 15, "maxPoints": 18, "description": "..." },
 { "key": "trackRecord", "label": "Insider track record (Bayesian-shrunk)",
 "value": 8.4, "sampleSize": 12, "points": 11, "maxPoints": 14, "description": "..." }
 ],
 "notes": [ "Sum of factor points is clamped to [0, 100]." ]
 }
}
── 回测
GET/api/v1/backtest

全局回测统计

各期限(T+30、T+90、T+365)的散户平均收益以及 T+90 胜率。可按方向 / 评分 / 时间段筛选。

查询参数
名称类型默认值说明
directionenum·BUY | SELL(默认:两者)
minScorenumber·按所属申报的 signalScore 筛选
fromISO·筛选 pubDate >= from
toISO·筛选 pubDate <= to
bash
curl "https://insiders-trades.com/api/v1/backtest?direction=BUY&minScore=50" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
响应示例
json
{
 "filters": { "direction": "BUY", "minScore": "50", "from": null, "to": null },
 "total": 2 340,
 "byDirection": { "BUY": 2340 },
"returnBasis": "retail_pubDate_plus_1_close",
 "averageReturnsPct": {
"T30": 1.24, "T90": 4.62, "T365": 9.85
 },
 "sampleCounts": {
"T30": 2340, "T90": 2290, "T365": 1940
 },
 "winRates90d": { "BUY": 0.582, "SELL": null }
}
── 搜索
── 策略与表现
GET/api/v1/strategy/winning

旧版筛选观察名单

满足旧版观察名单 6 项筛选条件的信号(集群、中盘股、关键职位、时效 ≤ 7 天、收购、v3 评分 ≥ 40)。仅供观察:无预期收益,也无经过验证的配置,响应的 proof 区块已注明。

查询参数
名称类型默认值说明
lookbackDaysinteger36530 → 1825
minScoreinteger700 → 100
bash
curl "https://insiders-trades.com/api/v1/strategy/winning?minScore=70" \
 -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/oos-performance

按排名组的实盘跟踪(前 3、前 5、前 10)

与 /performance 相同的数字:每家公司自首次进入前 k 名之日起计为一个持仓,与同期所在地区指数比较,分 30 天、90 天和 1 年,附覆盖率和 95% 区间。自 2026-10-13 起为第 2 版。公开,无需 API 密钥。

bash
curl "https://insiders-trades.com/api/v1/oos-performance"
── 匿名沙盒
GET/api/v1/sandbox/{path}

匿名代理(每 24 小时 10 次调用,无需密钥)

无需认证即可代理 /api/v1/* 的 READ 路由。24 小时滑动上限:每个指纹 10 次调用(机器人 UA 为 3 次)。拒绝数据中心 IP,第 6 次调用起需验证码,每个响应均带水印。批量导出、MCP、webhooks 不经由代理。

bash
# 无需请求头,直接试试:
curl "https://insiders-trades.com/api/v1/sandbox/declarations?limit=3"
curl "https://insiders-trades.com/api/v1/sandbox/signals?direction=BUY&limit=5"
curl "https://insiders-trades.com/api/v1/sandbox/status"
POST/api/v1/sandbox/challenge

面向机器人 user-agent 的 POW

签发 HMAC challenge(16 位难度,TTL 10 分钟)。客户端需找到一个 nonce,使 sha256(challenge + ':' + nonce) 以 4 个十六进制零开头,然后在下一次调用中带上 X-Sandbox-POW-Challenge + X-Sandbox-POW-Solution。

bash
curl -X POST "https://insiders-trades.com/api/v1/sandbox/challenge"
数据结构

数据模型

共有五个主要实体。以下是 API 中公开的字段(部分内部字段,如索引或技术性时间戳,未包含在内)。

Company

slugstringURL 标识,例如 bouygues-1454
namestring公司名称(来源 AMF)
isinstring | nullInternational Securities ID Number
marketstring | null例如 Euronext Paris
yahooSymbolstring | null用于价格 / 基本面的市场代码
marketCapnumber | null市值(€)
currentPricenumber | null最新已知价格
trailingPE, forwardPE, priceToBook, betanumber | null估值指标
analystReco, analystScore, targetMean, targetHigh, targetLowmixed分析师一致预期
dividendYield, fiftyTwoWeekHigh/Low, fiftyDayAverage, twoHundredDayAveragenumber | null技术指标
logoUrlstring | null标志 URL
priceAt, financialsAt, analystAtISO date-time各数据块的更新时间

Insider

slugstringURL 标识
namestring高管姓名(来源 AMF)
declarationsCountinteger交易总数
companiesCompany[]关联公司及所任职位

Declaration

amfIdstring唯一 AMF 标识(例如 2026DD1108988)
pubDateISO date-timeAMF 发布日期
transactionDateISO date-time | null交易生效日期
pdfUrlstringAMF 官方 PDF 链接
transactionobjectnature, instrument, isin, unitPrice, volume, totalAmount, currency, venue
insiderobjectname, slug, function
companyobjectname, slug, yahooSymbol, marketCap
signalobjectscore (0-100), pctOfMarketCap, pctOfInsiderFlow, insiderCumNet, isCluster, scoredAt

BacktestResult(嵌套于 Declaration.backtest)

directionstringBUY | SELL | OTHER
returnBasisstringretail_pubDate_plus_1_close
priceAtPubnumber | null散户入场价(pubDate+1 收盘价)
returnsPct.T30 / T90 / T365number | null各期限的散户收益
pubLeakPctnumber | null交易至发布之间的价格变动
computedAtISO date-time计算执行时间

Signal(v3 评分组件,实时计算)

scorenumber (0-100)v3 综合评分(10 个组成部分 · 见 /methodologie)
pctOfMarketCapnumber | null金额 / 市值比率(%)
pctOfInsiderFlownumber | null占该高管总流量的比例
insiderCumNetnumber | null截至本笔交易的累计净额(买入 - 卖出)
isClusterboolean≥ 2 名高管在 ±30 天内同向交易(v3 方向性)
错误

错误处理

所有错误均采用统一格式(类似 RFC-7807):

json
{
 "error": {
 "code": "<machine_readable_slug>",
 "message": "<可读的错误说明>",
 "status": <http_status>
 }
}

错误代码

StatusCode触发条件
401missing_api_key缺少 Authorization 或 X-Api-Key 请求头
401invalid_api_key密钥格式错误、未知或已撤销。被封禁的用户同样如此。
404company_not_found公司 slug 不存在
404insider_not_found高管 slug 不存在
404declaration_not_foundamfId 不存在
500internal_error服务器错误,请将 URL 和时间告知我们
对任何 ≥ 500 的响应,请使用指数退避重试(例如 1 秒、2 秒、4 秒,最多 5 次)。切勿重试 401 / 404。
配额

速率限制与最佳实践

测试阶段的默认上限:

  • 封闭测试:网页浏览不限量,免费账户每天可发出 20 次沙盒请求(计数器于 00:00 UTC 重置)。API 密钥从 Pro 和 Quant 套餐开始提供。
  • 每秒 10 次请求(突发)· 足以满足大多数用途。每个响应都带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset(ISO 8601)。
  • 每个账户最多 10 个有效密钥。超出时,请在您的密钥页面撤销其中一个。
  • 用户可实时查看用量计数(总计 + 今日),管理员亦可查看(含主要调用方)。

最佳实践

  • 关注数据时效。数据并非每秒变化。价格每天刷新一次,我们 46 个市场(AMF、SEC、BaFin、SIX SER、RNS、SEDI、Consob、CNMV、AFM、FSMA、Oslo、Helsinki、Copenhagen、ASX、FMA、CVM、HKEX、BSE-Sofia、Tadawul、DART、EDINET、SSE、SZSE、SEBI、KNF、PSE、NZX、JSE 等)的内部人申报则按数据源每天更新数次。请参考 meta.dataFreshness 调整轮询频率。
  • 积极使用缓存。公司详情很少变化,可在客户端缓存至 priceAt + 1h。
  • 正确分页。使用合理的 limit (20-50),大数据量时配合 offset。
  • 重试 5xx 错误。使用指数退避,最多 5 次。
  • 安全保管密钥。切勿以明文形式存放在 Git 仓库、前端代码或日志中。
示例

代码示例

获取今日热门信号

const API = "https://insiders-trades.com";
const KEY = process.env.INSIDERS_API_KEY;

async function topSignals(direction = "BUY", days = 1) {
 const url = new URL(API + "/api/v1/signals");
 url.searchParams.set("direction", direction);
 url.searchParams.set("lookbackDays", String(days));
 url.searchParams.set("minScore", "50");
 url.searchParams.set("limit", "10");

 const res = await fetch(url, {
 headers: { Authorization: "Bearer " + KEY },
 });
 if (!res.ok) throw new Error(`HTTP ${res.status}`);
 const { items, meta } = await res.json();

 console.log(`${items.length} signals · latency ${meta.latencyMs}ms`);
 for (const s of items) {
 console.log(
 `[${s.signal.score}] ${s.company.name.padEnd(32)} ${s.insider.name} · ${s.transaction.amount}€`
);
 }
}

topSignals();

将某公司的全部申报导出为 CSV

import csv, os, requests

API = "https://insiders-trades.com"
KEY = os.environ["INSIDERS_API_KEY"]

def fetch_all(slug):
 items, offset = [], 0
 while True:
 r = requests.get(
 f"{API}/api/v1/companies/{slug}/declarations",
 params={"limit": 100, "offset": offset},
 headers={"Authorization": f"Bearer {KEY}"},
)
 r.raise_for_status()
 page = r.json()
 items.extend(page["items"])
 if offset + 100 >= page["total"]:
 break
 offset += 100
 return items

with open("bouygues_declarations.csv", "w", newline="") as f:
 rows = fetch_all("bouygues-1454")
 w = csv.writer(f)
 w.writerow(["pubDate", "insider", "role", "nature",
 "isin", "unitPrice", "volume", "amount", "score"])
 for d in rows:
 w.writerow([
 d["pubDate"],
 d["insider"]["name"],
 d["insider"]["function"],
 d["transaction"]["nature"],
 d["transaction"]["isin"],
 d["transaction"]["unitPrice"],
 d["transaction"]["volume"],
 d["transaction"]["totalAmount"],
 d["signal"]["score"],
 ])
print(f"Wrote {len(rows)} rows")
版本

更新日志

v1.0.0 · 2026-04-20
  • 公开 API 上线。
  • 18 个端点,API 密钥认证,每个响应均附带数据时效与速率限制元数据。
  • 交互式 Swagger UI 位于 /api/docs。
  • 2026 年 10 月 11 日:insider 对象(REST、OpenAPI、MCP)移除 gender 字段。该字段为推断所得,并非申报内容,不再公开。
支持

帮助、反馈、SLA

API 目前处于封闭测试阶段,仅限受邀访问。测试期间不提供合同级 SLA,但团队每天监控数据时效(各市场每天多次采集,价格每日更新)。

  • 申请测试资格或提高配额:请联系 contact@insiders-trades.com。
  • 缺陷 / 异常:请提供确切的 URL、时间(UTC)以及所用密钥的 prefix。
  • 路线图:用于推送通知的 POST 端点、新信号 webhooks、细粒度权限范围。
合规使用。内部人申报(AMF、SEC、BaFin、SIX、RNS、SEDI、Consob、CNMV、AFM、FSMA、Oslo、Helsinki、Stockholm、Copenhagen、ASX、FMA、Dublin 等)是公开信息,但速率限制同样保护我们读取的监管机构和数据供应商。滥用行为将导致密钥被立即撤销。

准备好接入内部人信号了吗?

10 秒生成密钥,复制快速开始中的 cURL 示例,然后通过 Swagger 实时探索各个端点。