三步发出第一个请求:
- 创建账户,然后前往 我的账户 → API 密钥。
- 生成一个带名称的密钥(例如 "Production bot")。请立即复制,之后将不再显示。
- 在每个请求中加入请求头
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。
所有端点均为只读,按领域分组。所有列表类端点均可通过 ?market=<code> 进行跨市场筛选(代码见 GET /v1/markets)。
── 认证
curl https://insiders-trades.com/api/v1/me -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
── 状态与统计
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"
}bash
curl https://insiders-trades.com/api/v1/stats -H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
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
列出公司
返回筛选后的公司。
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
q | string | · | 按名称搜索(不区分大小写) |
isin | string | · | 按 ISIN 精确筛选 |
market | string | · | 按上市市场筛选(例如 Euronext Paris) |
marketCode | enum | · | 市场代码,以 GET /api/v1/markets 列出的为准(例如 fr、us、jp) |
hasLogo | boolean | · | 仅返回有(true)或没有(false)标志的公司 |
sort | enum | name | name | marketCap | recent |
order | enum | asc | asc | desc |
limit | integer | 50 | 1 → 200 |
offset | integer | 0 | 分页偏移量 |
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。
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
slug必填 | string | · | 公司 slug |
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
direction | enum | · | BUY | SELL(默认:全部) |
minScore | number | · | signalScore 阈值 |
limit | integer | 50 | 1 → 200 |
offset | integer | 0 | 分页偏移量 |
bash
curl "https://insiders-trades.com/api/v1/companies/bouygues-1454/declarations?direction=BUY&minScore=40&limit=5" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
slug必填 | string | · | 公司 slug |
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
windowDays | integer | 730 | 30 → 3650 天 |
bucket | enum | month | month | 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
列出高管
已跟踪的高管,支持按姓名模糊搜索。
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
q | string | · | 按名称搜索(不区分大小写) |
limit | integer | 50 | 1 → 200 |
offset | integer | 0 | 分页偏移量 |
bash
curl "https://insiders-trades.com/api/v1/insiders?q=arnault&limit=5" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
slug必填 | string | · | 高管 slug |
bash
curl https://insiders-trades.com/api/v1/insiders/bernard-arnault \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
slug必填 | string | · | 高管 slug |
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
limit | integer | 50 | Max 200 |
offset | integer | 0 | 分页偏移量 |
bash
curl https://insiders-trades.com/api/v1/insiders/bernard-arnault/declarations \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
slug必填 | string | · | 高管 slug |
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
from | ISO date | · | pubDate 下限(可选) |
to | ISO date | · | pubDate 上限(可选) |
limit | integer | 500 | 1 → 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"
── 申报
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
market | enum | · | 市场代码,以 GET /api/v1/markets 列出的为准(默认:all) |
currency | enum | · | EUR | USD | GBP | CHF | SEK | NOK | DKK | AUD | CAD · 增加 transaction.converted |
since | ISO date | · | from 的别名。与 sort=pubDate&order=asc 搭配可实现增量轮询。 |
include | string | · | 需内联的关联对象(CSV 格式)。支持:backtest |
from | ISO date | · | 筛选 pubDate >= from |
to | ISO date | · | 筛选 pubDate <= to |
minScore | number | · | signalScore 最低阈值 |
maxScore | number | · | signalScore 最高阈值 |
direction | enum | · | BUY | SELL |
cluster | boolean | · | true = 仅集群交易 |
minAmount | number | · | 最低金额(€) |
company | string | · | 按公司名称搜索 |
insider | string | · | 按高管姓名搜索 |
isin | string | · | 按 ISIN 精确筛选 |
sort | enum | pubDate | pubDate | signalScore | amount |
order | enum | desc | asc | desc |
limit | integer | 50 | 1 → 200 |
offset | integer | 0 | 分页偏移量 |
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¤cy=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"
路径参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
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"
}── 信号
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
direction | enum | BUY | BUY | SELL |
lookbackDays | integer | 7 | 时间窗口(1 → 90) |
minScore | integer | 40 | 最低评分(0 → 100) |
limit | integer | 20 | Max 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]." ]
}
}── 回测
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
direction | enum | · | BUY | SELL(默认:两者) |
minScore | number | · | 按所属申报的 signalScore 筛选 |
from | ISO | · | 筛选 pubDate >= from |
to | ISO | · | 筛选 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 }
}── 搜索
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
q必填 | string | · | 查询词(至少 2 个字符) |
limit | integer | 8 | 每组最大数量(1 → 50) |
bash
curl "https://insiders-trades.com/api/v1/search?q=total" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
── 策略与表现
GET/api/v1/strategy/winning
旧版筛选观察名单
满足旧版观察名单 6 项筛选条件的信号(集群、中盘股、关键职位、时效 ≤ 7 天、收购、v3 评分 ≥ 40)。仅供观察:无预期收益,也无经过验证的配置,响应的 proof 区块已注明。
查询参数
| 名称 | 类型 | 默认值 | 说明 |
|---|
lookbackDays | integer | 365 | 30 → 1825 |
minScore | integer | 70 | 0 → 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
slug | string | URL 标识,例如 bouygues-1454 |
name | string | 公司名称(来源 AMF) |
isin | string | null | International Securities ID Number |
market | string | null | 例如 Euronext Paris |
yahooSymbol | string | null | 用于价格 / 基本面的市场代码 |
marketCap | number | null | 市值(€) |
currentPrice | number | null | 最新已知价格 |
trailingPE, forwardPE, priceToBook, beta | number | null | 估值指标 |
analystReco, analystScore, targetMean, targetHigh, targetLow | mixed | 分析师一致预期 |
dividendYield, fiftyTwoWeekHigh/Low, fiftyDayAverage, twoHundredDayAverage | number | null | 技术指标 |
logoUrl | string | null | 标志 URL |
priceAt, financialsAt, analystAt | ISO date-time | 各数据块的更新时间 |
Insider
slug | string | URL 标识 |
name | string | 高管姓名(来源 AMF) |
declarationsCount | integer | 交易总数 |
companies | Company[] | 关联公司及所任职位 |
Declaration
amfId | string | 唯一 AMF 标识(例如 2026DD1108988) |
pubDate | ISO date-time | AMF 发布日期 |
transactionDate | ISO date-time | null | 交易生效日期 |
pdfUrl | string | AMF 官方 PDF 链接 |
transaction | object | nature, instrument, isin, unitPrice, volume, totalAmount, currency, venue |
insider | object | name, slug, function |
company | object | name, slug, yahooSymbol, marketCap |
signal | object | score (0-100), pctOfMarketCap, pctOfInsiderFlow, insiderCumNet, isCluster, scoredAt |
BacktestResult(嵌套于 Declaration.backtest)
direction | string | BUY | SELL | OTHER |
returnBasis | string | retail_pubDate_plus_1_close |
priceAtPub | number | null | 散户入场价(pubDate+1 收盘价) |
returnsPct.T30 / T90 / T365 | number | null | 各期限的散户收益 |
pubLeakPct | number | null | 交易至发布之间的价格变动 |
computedAt | ISO date-time | 计算执行时间 |
Signal(v3 评分组件,实时计算)
score | number (0-100) | v3 综合评分(10 个组成部分 · 见 /methodologie) |
pctOfMarketCap | number | null | 金额 / 市值比率(%) |
pctOfInsiderFlow | number | null | 占该高管总流量的比例 |
insiderCumNet | number | null | 截至本笔交易的累计净额(买入 - 卖出) |
isCluster | boolean | ≥ 2 名高管在 ±30 天内同向交易(v3 方向性) |
所有错误均采用统一格式(类似 RFC-7807):
json
{
"error": {
"code": "<machine_readable_slug>",
"message": "<可读的错误说明>",
"status": <http_status>
}
}错误代码
| Status | Code | 触发条件 |
|---|
401 | missing_api_key | 缺少 Authorization 或 X-Api-Key 请求头 |
401 | invalid_api_key | 密钥格式错误、未知或已撤销。被封禁的用户同样如此。 |
404 | company_not_found | 公司 slug 不存在 |
404 | insider_not_found | 高管 slug 不存在 |
404 | declaration_not_found | amfId 不存在 |
500 | internal_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 字段。该字段为推断所得,并非申报内容,不再公开。
API 目前处于封闭测试阶段,仅限受邀访问。测试期间不提供合同级 SLA,但团队每天监控数据时效(各市场每天多次采集,价格每日更新)。
合规使用。内部人申报(AMF、SEC、BaFin、SIX、RNS、SEDI、Consob、CNMV、AFM、FSMA、Oslo、Helsinki、Stockholm、Copenhagen、ASX、FMA、Dublin 等)是公开信息,但速率限制同样保护我们读取的监管机构和数据供应商。滥用行为将导致密钥被立即撤销。
准备好接入内部人信号了吗?
10 秒生成密钥,复制快速开始中的 cURL 示例,然后通过 Swagger 实时探索各个端点。