ANTITONE
API Reference

API 文档

本页收录 42 个常用端点（服务端共 67 个）。参数表由服务端 OpenAPI 自动生成， 每个端点可展开查看参数、请求与响应示例。

创建 API KeyAPI 概览 计费说明
BASE api.antione.cc:8443AUTH Bearer nhk_…FORMAT JSON · UTF-8
计费方式鉴权快速开始情报行情板块题材A 股特色档案实体日历 / 早晚报 / 信号实时推送账号与用量下载与更新错误语义

计费方式

计费公式 实收 = ⌈(基础 + 条数/批次) × 修饰符 × 0.5⌉，最低 ¥0.005；查不到不收费（返回 0 条时本单为 ¥0）。 下面每一行都标出折后实收价，每个响应都带 X-Antitone-Cost-CNY（本次金额）与 X-Antitone-Credits（原始计量）回执。

计价方式
按量计费 · 人民币
API 一律按人民币计价 · 当前全站 ×0.5 · 余额永久有效
每日免费
¥1.00每日重置
按账号计（非按 Key）· 另有 100 条推送额度
实时流
¥0.005/连接·小时
+ ¥0.00005/条 · Webhook 重试免费
价目表暂不可达，此处为兜底估值，实际扣费以响应头 X-Antitone-Cost-CNY 为准
计费修饰符
历史跨度 ≤7 天 ×1历史跨度 8–30 天 ×2历史跨度 31–180 天 ×3历史跨度 >180 天 ×5含全文（include_full_text） ×3

鉴权

服务端调用用 API Key；浏览器里已登录的控制台走会话签名。两者都放在请求头里。

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 调用。响应头里直接给出本次花费。

cURL
# 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 条，超出按实际返回条数分档加价。

情报列表检索 —— 最常用的端点。可按关键词、个股、市场、板块、题材、事件类型、时间窗组合筛选；每条带重要度、影响方向、事件簇归属。翻页用返回体里的 cursor。

参数
参数位置类型默认说明
qquerystring—全文关键词，匹配标题 / 摘要 / 关键词
source_idqueryinteger—来源 ID（控制台「源管理」可查）
story_idquerystring—事件簇 ID —— 传它可只看某个事件簇的成员报道
event_typequerystring—事件类型码，如 event.market_holiday
marketquerystring—市场码：market.cn_equity / market.hk_equity / market.us_equity / market.cn_macro 等
impact_relationquerystring—影响方向：positive（利好）/ negative（利空）/ neutral（中性）
entityquerystring—实体名（公司 / 机构 / 人名）
tickerquerystring—股票代码，如 600519 / 000001 / AAPL
sectorquerystring—板块码，如 sector.technology（11 个受控码，不造新码）
themequerystring—题材码，如 theme.ai_compute（来自 /v1/themes/overview）
min_importancequeryinteger—最低重要度 1–5。≥4 视为重大事件（推送与雷达高亮都用这个阈值）
published_fromquerystring—起始时间（ISO 8601 或 YYYY-MM-DD）。决定历史跨度与计费倍率：≤7 天 ×1、≤30 天 ×2、≤180 天 ×3、更长 ×5
published_toquerystring—结束时间（ISO 8601 或 YYYY-MM-DD）
include_full_textqueryboolean—是否返回正文全文。×3 计费，且需要 full_text 权益
limitqueryinteger50返回条数上限。按返回量计费，拉得越多越贵
cursorquerystring—分页游标：取上一页最后一条的 cursor 继续翻页
请求示例
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,
      "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板块题材

DA 股特色

E档案实体

F日历 / 早晚报 / 信号

G实时推送

连接费按小时计（同 Key 同小时只计一次）；事件费按 100 条一档；每日 100 条免费。价格自动鼓励收窄订阅 —— 裸订全量约 4.4 万条/日 ≈ ¥66/月。

H账号与用量（全免费）

注册与登录在官网完成 —— 认证类接口不对外文档化，避免被批量调用刷号。以下端点供 API Key 与已登录控制台使用。

下载与更新

桌面端当前版本 v0.10.2，安装包托管在 api.antione.cc:8443/dl/。 安装包未做代码签名，macOS 首次打开若提示「已损坏/未验证」，请右键 →「打开」放行一次。

平台文件大小SHA-256
macOS · 首次安装（DMG）Antitone_0.10.2_mac-aarch64.dmg11.03 MB4eaf05e39824dd203a7279ccfe3ac999c833b4905eb8cab3d9d1e6fa87589ef8
macOS · 自动更新（ZIP）Antitone_0.10.2_mac-aarch64.zip9.78 MBd1fdfdf91b8053ede557c4160c74f6e302f231a82811a7c9a282e68ebb770c9a
Windows x64Antitone_0.10.2_x64-setup.exe6.99 MB0991b0a34ca1e4573eaa1dfeb6266ceb58d1a22ef799bdada65a5fdea3517e65

自动更新：macOS 的更新包是 ZIP（上表第二行）， 由客户端自动下载解压替换，无需手动操作。桌面端启动时向 /v1/app/update 查询最新版本。 低于服务端要求的最低版本时会弹窗要求更新；更新包下载后校验 SHA-256，不匹配则拒绝安装。

手动校验：macOS 用 shasum -a 256 Antitone_0.10.2_mac-aarch64.zip； Windows 用 certutil -hashfile Antitone_0.10.2_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}