API 文档
本页收录 31 个常用端点（服务端共 56 个）。参数表由服务端 OpenAPI 自动生成， 每个端点可展开查看参数、请求与响应示例。
计费方式
计费公式 实收 = ⌈(基础 + 条数/批次) × 修饰符 × 0.5⌉，最低 ¥0.005；查不到不收费（返回 0 条时本单为 ¥0）。 下面每一行都标出折后实收价，每个响应都带 X-Antitone-Cost-CNY（本次金额）与 X-Antitone-Credits（原始计量）回执。
鉴权
服务端调用用 API Key；浏览器里已登录的控制台走会话签名。两者都放在请求头里。
API Key 通道免签名，直接放请求头即可： Authorization: Bearer nhk_xxxxxxxx.yyyyyyyyyyyyyyyyyyyy # 或（等价）：X-API-Key: nhk_xxxxxxxx.yyyyyyyyyyyyyyyyyyyy 服务端只存密钥的 SHA-256 哈希，密钥泄漏后无法找回、只能轮换。 泄漏的 Key 不能创建新 Key、不能动钱包、不能访问管理接口。
浏览器用登录令牌访问时，除 Bearer 外还要带防抓包签名：
X-NS-TS : <秒级时间戳>
X-NS-SIG: HMAC-SHA256(session_key, `${ts}|${METHOD}|${path}`) ← path 不含 query
X-NS-DEVICE: <设备指纹>
session_key 在登录响应里返回一次（页面表单由 WebCrypto 现算，无需后端参与）。
用 API Key 时不需要这套签名。快速开始
注册 → 在控制台创建 Key → 带 Key 调用。响应头里直接给出本次花费。
# 1. 在官网注册（注册/登录接口不对外文档化，避免被批量刷号） # https://antione.cc → 注册 → 控制台 # 2. 控制台 → API Keys → 创建 Key（完整密钥只显示一次） # 3. 用 Key 直接调用（API Key 通道免签名） curl -H "Authorization: Bearer nhk_xxx.yyy" \ "https://api.antione.cc:8443/v1/news?limit=20" # 响应头里就有本次实收（API 按人民币计价）： # X-Antitone-Cost-CNY: 0.0050 ← 本次金额 # X-Antitone-Credits: 1 ← 原始计量 # X-Antitone-Balance: 98 # 4. 查余额 / 权益 curl -H "Authorization: Bearer nhk_xxx.yyy" \ "https://api.antione.cc:8443/v1/account/me"
A情报
全网财经资讯与事件簇。基础价含前 20 条，超出按实际返回条数分档加价。
情报列表检索 —— 最常用的端点。可按关键词、个股、市场、板块、题材、事件类型、事件发生地（region）、内容形态、时间窗组合筛选；每条带重要度、情绪、事件发生地、内容形态、确定性（传闻 / 据知情人士 / 已证实）、事件簇归属。翻页用返回体里的 cursor。region / content_type / 新事件类型是 2026-10 起的标注口径（近 90 天已回填）；时间窗内覆盖不全时响应会带 annotation_coverage 说明。
| 参数 | 位置 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
q | query | string | — | 关键词，需出现在标题里；多词需同时命中，常见行业词自动扩展同义词（半导体≈芯片 / 集成电路，新能源≈锂电 / 储能 / 光伏…，见 query_echo.expanded_terms） |
source_id | query | integer | — | 来源 ID（控制台「源管理」可查） |
story_id | query | string | — | 事件簇 ID —— 传它可只看某个事件簇的成员报道 |
event_type | query | string | — | 事件类型码（29 个受控码）：政策 event.policy、监管执法 event.regulatory_action、财报 event.earnings、业绩预告 event.guidance、经营 event.operations、合同订单 event.contract、并购 event.m_and_a、股东增减持 event.shareholder_change、融资 event.financing、机构评级 event.analyst_rating、行情 event.market_move、宏观数据 event.macro_data、地缘 event.geopolitical_risk 等 |
market | query | string | — | 市场码：market.cn_equity / market.hk_equity / market.us_equity / market.cn_macro 等 |
impact_relation | query | string | — | 影响方向：positive（利好）/ negative（利空）/ neutral（中性） |
entity | query | string | — | 实体名（公司 / 机构 / 人名） |
ticker | query | string | — | 股票代码，如 600519 / 000001 / AAPL |
sector | query | string | — | 板块码，如 sector.technology（11 个受控码，不造新码） |
theme | query | string | — | 题材码，如 theme.robot / theme.innovative_drug / theme.energy_storage（共 19 个，来自 /v1/themes/overview） |
min_importance | query | integer | — | 最低重要度 1–5。≥4 视为重大事件（推送与雷达高亮都用这个阈值） |
published_from | query | string | — | 起始时间（ISO 8601 或 YYYY-MM-DD）。决定历史跨度与计费倍率：≤7 天 ×1、≤30 天 ×2、≤180 天 ×3、更长 ×5 |
published_to | query | string | — | 结束时间（ISO 8601 或 YYYY-MM-DD） |
include_full_text | query | boolean | — | 是否返回正文全文。×3 计费，且需要 full_text 权益 |
limit | query | integer | 50 | 返回条数上限。按返回量计费，拉得越多越贵 |
cursor | query | string | — | 分页游标：上一页返回的 next_cursor |
origin_market | query | string | — | 按来源的本土市场过滤：cn / hk / us（market 是「影响到的市场」，会含海外事件） |
sentiment | query | string | — | 情绪方向：neg 明显负面（≤ -0.3）/ pos 明显正面（≥ 0.3），各约占一成；找风险用 neg |
sort | query | string | — | 排序：time 按时间倒序（默认，可翻页）/ importance 按重要度取（不分页） |
a_share | query | boolean | — | true = 只要点名了 A 股个股（沪深北代码）的条目 |
per_day | query | integer | — | 每个北京时间自然日各取重要度最高的 N 条（1–20），复盘多天时保证每天都有；不分页 |
region | query | string | — | 事件发生地：ISO 二位码逗号分隔（CN / US / HK / JP…）、GLOBAL，或 domestic（= CN）/ foreign（非 CN）。与 origin_market（谁报道的）不同 |
content_type | query | string | — | 只要这些内容形态（逗号分隔）：report 报道 / announcement 公告原文 / data_release 数据发布 / research 研报观点 / market_wrap 行情播报 / opinion 评论 / roundup 汇总 / promo 软文 / non_finance 非财经 |
exclude_content_type | query | string | — | 排除这些内容形态，如 market_wrap,roundup,promo 去掉盘面播报、要闻汇总与软文 |
curl -H "Authorization: Bearer nhk_xxx.yyy" \ "https://api.antione.cc:8443/v1/news?ticker=600519&min_importance=4&limit=20" \ -H "X-Antitone-Billing-Detail: 1"
{
"items": [
{
"public_id": "8f3c…",
"title": "央行开展 3800 亿元 MLF 操作",
"summary": "1 年期 MLF 全额续作并小幅加量…",
"published_at": "2026-09-15T09:12:00+08:00",
"market": "market.cn_macro",
"impact_relation": "positive",
"importance": 4,
"event_type": "event.monetary_policy",
"region": "CN",
"content_type": "report",
"certainty": "confirmed",
"event_date": null,
"story_id": "b21e…",
"story_title": "流动性投放加码",
"tickers": ["600519"],
"sectors": ["sector.financials"],
"source": "财联社"
}
],
"cursor": "eyJ…",
"_billing": {
"credits": 2,
"breakdown": { "base": 1, "volume": 1, "modifiers": { "items": 20 } },
"balance": 98,
"settled": false
}
}B板块题材
按行业 / 题材聚合的情报热度（新闻数、情绪、风险、头条事件），由情报标注计算，不含价格。
C档案与基本面
A 股公司档案与基本面。估值（PE / PS / PB）按前收盘价计算并注明口径，不提供实时价格。
E实时推送
连接费按小时计（同 Key 同小时只计一次）；事件费按 100 条一档；每日 100 条免费。价格自动鼓励收窄订阅 —— 裸订全量约 4.4 万条/日 ≈ ¥66/月。
F账号与用量（全免费）
注册与登录在官网完成 —— 认证类接口不对外文档化，避免被批量调用刷号。以下端点供 API Key 与已登录控制台使用。
下载与更新
桌面端当前版本 v0.11.1，安装包托管在 api.antione.cc:8443/dl/。 安装包未做代码签名，macOS 首次打开若提示「已损坏/未验证」，请右键 →「打开」放行一次。
| 平台 | 文件 | 大小 | SHA-256 |
|---|---|---|---|
| macOS · 首次安装（DMG） | Antitone_0.11.1_mac-aarch64.dmg | 11.28 MB | f192d1055e1e03c46501a03dc87285a1e5adb439d681425f8c74e0a2a39b4975 |
| macOS · 自动更新（ZIP） | Antitone_0.11.1_mac-aarch64.zip | 10.03 MB | dd64c1ef4ed036a6d9d3c99175399b1cdeea4f0111665a2649f1c5111cc412dd |
| Windows x64 | Antitone_0.11.1_x64-setup.exe | 7.22 MB | 333b884a2715de0b477aa1c9eb9708ec359385c24ba95ec1fd63ee8f5bc49766 |
自动更新：macOS 的更新包是 ZIP（上表第二行）， 由客户端自动下载解压替换，无需手动操作。桌面端启动时向 /v1/app/update 查询最新版本。 低于服务端要求的最低版本时会弹窗要求更新；更新包下载后校验 SHA-256，不匹配则拒绝安装。
手动校验：macOS 用 shasum -a 256 Antitone_0.11.1_mac-aarch64.zip； Windows 用 certutil -hashfile Antitone_0.11.1_x64-setup.exe SHA256， 与上表对照一致即可安装。
错误语义
常见错误按状态码区分语义，响应体为 JSON，调用方可按下表处理。
| 状态码 | 含义 | 响应体 |
|---|---|---|
| 401 | 凭证无效 / 已吊销 / 被暂停 | {error:"key_paused", reason, since} |
| 402 | 余额不足 | {error:"insufficient_credits", balance, unsettled, need_credits, topup_url} |
| 403 | 缺作用域 / 该接口不开放给 API Key | {error:"insufficient_scope", required_scope, granted_scopes} |
| 429 | 超速率 / 超日配额 | Retry-After + {limit:"rpm"|"daily", reset_at} |