文档

地址

MCP
https://chanshu.top/api/mcp
传输Streamable HTTP,无状态:每个 POST 独立,不用 Mcp-Session-Id;GET / DELETE 回 405
鉴权OAuth 2.1:宿主里添加地址后,首次使用打开浏览器登录授权;不带凭据回 401
内容工具、prompts、initialize 的 instructions;工具清单按连接开放的工具组过滤(见工具分组,默认全部);没有写权限的写工具照样列出,调用时回拒绝

授权

获取宿主首次连接时打开浏览器,登录 chanshu 后在同意页点「允许」
读全部读工具
写按授权的 scope
scope授权页名称工具
read基础全部读工具
debt:write记录负债debt_*
watchlist:write管理自选watchlist_add / watchlist_remove
alert:write管理股价提醒alert_set / alert_remove
expense:write记录消费expense_add / expense_update / expense_delete / expense_restore / expense_import_commit / expense_import_revoke / expense_recurring_set / expense_recurring_pause
feedback:write提交反馈feedback_create / feedback_reply / feedback_reply_retract / feedback_close / feedback_mark_read
portfolio:write管理我的持仓portfolio_record_add / portfolio_record_update / portfolio_record_delete / portfolio_record_restore / portfolio_settings_set / portfolio_cash_set
health:write设定财务健康目标finance_health_set
analysis:write记录分析笔记analysis_topic_set / analysis_memory_set / analysis_report_add / analysis_report_delete / analysis_report_restore
缺 scope写工具回「请重新授权」(持仓组与分析笔记组为 scope_missing):宿主里对 chanshu 重新登录(Claude Code 在 /mcp 里重新认证),或在账号设置断开,下次使用自动重新授权
不带 scope请求全部 scope,同意页列出全部写权限,用户点「允许」才生效
无人值守写工具带 unattended=true 表示没人在场:消费写落待确认,持仓与财务健康目标写回 needs_confirmation,反馈只能提交与追加,分析笔记照常生效(定时写入正是它的用法);确认只能本人在网页 / App 里做

工具分组

为什么宿主对启用的工具总数有上限或提示(如超过 80 只);只用行情与持仓的话,不必把 91 只全开
完整默认,全部 91 只
轻量13 只高频只读工具:search_stock / stock_quote / stock_tickers / stock_kline / stock_brief / market_breadth / stock_news / fund_detail / my_watchlist / my_positions / portfolio_pnl / portfolio_week / finance_overview
自定义按下表的组勾选
在哪选授权页「开放的工具」;之后在 账号设置 · 已连接的应用 点工具数改,宿主下次取工具列表即生效,不用重新授权
没开放的不出现在 tools/list;硬调回 isError「该工具未在此连接开放」;用到它的 prompt 也不列
不影响写权限照旧按 scope;个人 API 令牌恒为全部(只读)
组名称 · 工具数工具
market行情 · 8search_stock / stock_quote / stock_tickers / stock_trends / stock_kline / stock_brief / market_breadth / stock_margin
company公司资料 · 5stock_profile / stock_financials / stock_shareholders / stock_notices / stock_news
futures期货 · 13futures_search / futures_list / futures_quote / futures_tickers / futures_trends / futures_kline / my_futures_watchlist / futures_watchlist_add / futures_watchlist_remove / my_futures_positions / futures_record_list / futures_record_add / futures_record_delete
fund基金 · 5search_fund / fund_detail / fund_holding_changes / funds_holding_stock / fund_stock_analysis
portfolio我的持仓 · 10my_positions / portfolio_week / portfolio_record_list / portfolio_pnl / portfolio_record_add / portfolio_record_update / portfolio_record_delete / portfolio_record_restore / portfolio_settings_set / portfolio_cash_set
watch自选与提醒 · 6my_watchlist / watchlist_add / watchlist_remove / alert_list / alert_set / alert_remove
overview财务全景 · 1finance_overview
health财务健康 · 2finance_health / finance_health_set
debt负债 · 8my_loans / debt_loan_create / debt_loan_update / debt_loan_mark / debt_prepay_add / debt_prepay_revoke / debt_loan_delete / debt_loan_restore
expense消费记账 · 17expense_list / expense_get / expense_summary / expense_categories / expense_quota / expense_import_list / expense_recurring_list / expense_draft / expense_import_preview / expense_add / expense_update / expense_delete / expense_restore / expense_import_commit / expense_import_revoke / expense_recurring_set / expense_recurring_pause
feedback意见反馈 · 8feedback_list / feedback_get / feedback_image / feedback_create / feedback_reply / feedback_reply_retract / feedback_close / feedback_mark_read
analysis分析笔记 · 8analysis_state_get / analysis_report_list / analysis_report_get / analysis_topic_set / analysis_memory_set / analysis_report_add / analysis_report_delete / analysis_report_restore

宿主配置

WorkBuddy
{
  "mcpServers": {
    "chanshu": {
      "type": "http",
      "url": "https://chanshu.top/api/mcp"
    }
  }
}
连接器 → 自定义连接器 → 配置 MCP(即 ~/.workbuddy/mcp.json),保存后点「连接」在浏览器登录授权
DeepSeek Harness
- id: mcp-chanshu
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: chanshu
    transport: stdio
    command: npx
    args: ['-y', 'mcp-remote', 'https://chanshu.top/api/mcp']
追加到 ~/.dsh/profiles/desktop/cordis.patch.yml 末尾;它的 MCP 客户端不做 OAuth,经 mcp-remote 桥接登录——先在终端跑一次 npx -y mcp-remote https://chanshu.top/api/mcp 授权(令牌缓存在 ~/.mcp-auth),再重启。Windows 上 npx 起不来就改 command: cmd、args: ['/c', 'npx', '-y', 'mcp-remote', 'https://chanshu.top/api/mcp']
Claudeclaude.ai「设置 → 连接器」添加自定义连接器,填 MCP 地址,点「连接」登录授权;加一次,网页、手机、桌面和用 claude.ai 账号登录的 Claude Code 都能用
Claude Code(无 claude.ai 账号)
claude mcp add --transport http -s user chanshu https://chanshu.top/api/mcp
只给用 API Key / Bedrock / Vertex 登录的 Claude Code;-s user 让所有目录都能用,不带只加到当前目录。和上面的连接器二选一,两个都加会出现两份 chanshu;加完在会话里输入 /mcp,选 chanshu 登录授权
Codex
[mcp_servers.chanshu]
url = "https://chanshu.top/api/mcp"
Cursor
{
  "mcpServers": {
    "chanshu": {
      "url": "https://chanshu.top/api/mcp"
    }
  }
}
网页 / 手机ChatGPT 等在「连接器」里填 MCP 地址

行情

search_stock搜索股票公开读限速日配额

返回候选列表:带市场前缀的 code 与名称
q*string关键词:股票名称 / 代码 / 拼音首字母

stock_quote个股快照公开读限速日配额

返回价、涨跌、高开低、量额、市值、是否开市
注意港股、美股为延迟行情;美股时间为纽约时间、金额美元
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX

stock_tickers批量行情公开读限速日配额

返回每只最新价 / 涨跌额 / 涨跌幅;坏码或查无的进 errors
codes*array股票代码列表(1..50 个),格式同 stock_quote 的 code

stock_kline历史 K 线公开读限速日配额

返回日 / 周 / 月 K 线,一次一页(120 或 250 根)
注意没有分钟线;更早的数据带 end 往前翻,每页计一次限速与日配额
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX
periodday / week / monthK 线周期:day / week / month,默认 day
lmt120 / 250这一页的根数:120(默认,约半年日线)或 250(约一年日线)
endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一根的前一天;空 = 最新一页

market_breadth市场涨跌家数公开读限速日配额

返回上涨 / 下跌 / 平盘家数与合计;asOf 为取数时刻
注意上游失败时回最近一次成功的数据并带 stale: true,从没成功过才报错
marketsarray市场列表,取值 sh / sz / bj;缺省为三市

stock_brief个股速览公开读限速

返回快照、近 5 / 20 日涨幅、我的持仓摘要、是否在自选、持有它的基金 Top5;A+H 两地上市另给 ah(对面那只的行情与 A/H 比价)
注意整次只计一次限速
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX

stock_financials个股财报核心指标公开读限速日配额

返回annual 年报(≤8 年)、quarterly 单季(≤12 期)、latest 最新一份累计报告;银行 / 保险 / 券商另给 extras
注意金额单位元,港股为折算人民币;比率与增速单位 %;没有用户数等经营数据
code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700

stock_profile个股简况公开读限速日配额

返回公司资料、主营业务、市盈率 / 市净率 / 股息率、总股本 / 流通股本;A 股另给股东户数 holders
注意静态市盈率只 A 股有,股息率只港股有
code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700

stock_shareholders十大股东公开读限速日配额

返回某报告期的十大股东 top(占总股本 %)与十大流通股东 free(占流通股 %,带股东性质):名次、持股数、较上期增减股数与比例、状态(新进 / 增持 / 减持 / 不变),上期在前十、本期退出的 exited;可选报告期 periods
注意只 A 股;随定期报告披露,滞后一到四个月;股东户数看 stock_profile
code*stringA 股代码,带小写市场前缀:sh600519 / sz000001(港股、美股没有这项数据)
periodstring报告期 YYYY-MM-DD(季末日,须为返回的 periods 之一);省略 = 最新一期

stock_margin个股融资融券公开读限速日配额

返回逐日两融明细 rows(最新在前):融资余额 / 买入额 / 偿还额 / 净买入、融券余额 / 余量 / 卖出量 / 偿还量、融资融券余额、融资余额占流通市值、收盘价与涨跌幅;数据日期 asOf、是否两融标的 marginable、更早还有没有 more
注意只 A 股(沪深北)个股与 ETF,港股 / 美股 / 指数回错误,不是两融标的 marginable: false、rows 为空;数据是上一交易日的,次日上午更新;金额元、量股、比率 %;只给原始数据,不做判断;缓存 1 小时
code*stringA 股(沪 / 深 / 北)个股或 ETF 代码,带小写市场前缀:sz300308 / sh600519 / bj920438 / sh510300(港股、美股、指数没有这项数据)
lmt20 / 60 / 250这一页的交易日数:20 / 60(默认,约 3 个月)/ 250(约一年)
endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一行的前一天;空 = 最新一页

stock_notices个股公告公开读限速日配额

返回发布倒序的公告:公告日 date(盘后发布记次日)、发布时刻 time、标题、类型 type(东财栏目)、原文 url 与 pdf
注意只有标题与链接,不含正文;判断利好利空要看原文。A 股、港股都有(港股类型为繁体、链接即 PDF),指数返回空;缓存 10 分钟
code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700
limitinteger最多返回多少条,1..50,默认 20

stock_news个股资讯公开读限速日配额

返回标题带该股简称的最新资讯:发布时刻 time、标题、媒体 media、导语摘要 summary(文章开头约 120 字)、原文 url;同标题转载只留一条
注意只有标题与摘要,不含正文;按简称匹配标题,可能混入同名报道;指数返回空;缓存 5 分钟
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX
limitinteger最多返回多少条,1..20,默认 10

期货

futures_list期货行情列表公开读限速日配额

返回每行代码、名称、交易所、板块、最新价、涨跌额、涨跌幅、昨结、开高低、成交量、持仓量;sectors / exchanges 两组筛选计数与 asOf
注意主力连续带 mainCode(当前对应的具体合约);一次拿全部主力,不必逐只 futures_quote
sessionmain / night / all时段口径:main = 全部主力(每个品种一只主力连续,缺省)/ night = 夜盘主力(有夜盘的品种)/ all = 全部具体合约
sectorstring板块:金融 / 贵金属 / 有色 / 黑色 / 能源 / 化工 / 农产品 / 其他;空 = 不筛
exchangestring交易所:shfe 上期所 / ine 上期能源 / dce 大商所 / czce 郑商所 / gfex 广期所 / cffex 中金所;空 = 不筛
productstring品种代码(rb / sa / if…):给了就列该品种的主力连续与全部在市合约,忽略 session

futures_quote期货快照公开读限速日配额

返回最新价、涨跌(相对昨结)、开高低、昨结 / 昨收、结算价、均价、成交量、持仓量与日增仓、交易日、marketOpen / session
注意结算价收盘后才有;夜盘时段交易日已是下一个交易日
code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)

futures_tickers期货批量行情公开读限速日配额

返回按规范代码归位的精简行情;坏码或查无(已到期)的进 errors
codes*array期货合约代码列表(1..50 个),格式同 futures_quote 的 code

futures_kline期货日 K公开读限速日配额

返回日 K 一页(120 或 250 根),每根带结算价与持仓量;more 表示更早还有
注意只有日线;原始价不复权;中金所合约上游不给结算价;带 end 往前翻,每页计一次限速与日配额
code*string期货合约代码(格式同 futures_quote)
lmt120 / 250这一页的根数:120(默认,约半年日线)或 250(约一年日线)
endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一根的前一天;空 = 最新一页

my_futures_watchlist我的期货自选本人读限速

返回每个合约最新价 / 涨跌 / 持仓量(批量取价);已到期的标 priceMissing;url
注意与股票自选分开,是网页期货页的同一份

futures_watchlist_add加入期货自选watchlist:write写限速

返回操作前 / 后的期货自选清单与数量
注意先查合约目录确认存在并归一、补名称;已在自选里算成功;最多 200 个
code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)

futures_watchlist_remove移出期货自选watchlist:write写限速

返回操作前 / 后的期货自选清单与数量
注意不在自选里算成功
code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)

my_futures_positions我的期货持仓本人读限速

返回每个合约方向(多空分开):手数、开仓均价、现价、乘数、保证金率、保证金占用、开仓保证金、名义价值、浮动盈亏、逐日盯市当日盈亏、累计平仓盈亏;totals.equity = 开仓保证金 + 浮动盈亏
注意由开平仓记录推导,只记录不下单;金额单位元
include_closedboolean是否另列已平完的合约方向(只有累计平仓盈亏有意义),默认 false

futures_record_list期货开平仓记录本人

返回记录(新的在前):id、合约、方向、日期、价、手数、乘数、保证金率、手续费、所见版本;平仓带 realized
codestring只看某个合约(rb2701;郑商所 SA701 也认);空 = 全部

futures_record_add记一笔期货开平仓portfolio:write写限速

返回这笔记录与该合约操作前 / 后的持仓摘要
注意平仓手数超过当时持仓时报错;乘数、保证金率不给按品种表预填
code*string具体合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认);主力连续 rb0 不能记,先 futures_quote 看 mainCode
side*string方向:open_long 开多 / open_short 开空 / close_long 平多 / close_short 平空
date*string成交日期 YYYY-MM-DD(东八区),不晚于今天
timestring成交时刻 HH:MM(可选)
price*number成交价
lots*integer手数,正整数
multnumber合约乘数(每手多少报价单位,如螺纹 10、沪深300 300);不给按品种表预填
margin_ratenumber保证金率 %(0–100);不给预填(国债 3,其余 12),以自己账户为准
feenumber手续费(元),≥ 0
notestring备注,≤ 40 字

futures_record_delete删一笔期货记录portfolio:write写限速

返回该合约删除前 / 后的持仓摘要
注意软删除;删掉开仓会让后面的平仓超平时拒绝
id*string记录 id(futures_record_list 返回的 records[].id)

基金

search_fund搜索基金公开

返回基金基本信息,规模降序分页
q*string基金名称 / 代码子串
pageinteger页码,从 1 起,默认 1
sizeinteger每页条数,1..50,默认 20

fund_detail基金详情公开

返回基本信息 + 十大持仓;联接基金穿透到目标 ETF(via 给目标代码)
注意季报口径,滞后一到三个月
code*string基金代码(6 位数字)

funds_holding_stock持有某股的基金公开

返回基金列表,占比降序、再规模降序,分页
code*string股票代码:600519 / sh600519 / 00700 / NVDA 均可
pageinteger页码,从 1 起,默认 1
sizeinteger每页条数,1..50,默认 20

fund_holding_changes基金持仓变动公开

返回新进 / 退出 / 加仓 / 减仓(占比按百分点比较);只有一期时 hasPrev=false
注意比的是占净值比例,不是股数;买卖看 fund_stock_analysis
code*string基金代码(6 位数字)
periodstring本期报告期 YYYY-MM-DD(季末日);省略 = 最新期

fund_stock_analysis股票的基金持仓分析公开读限速

返回全部 / 主动两组的持有基金数、合计股数、期末市值、占总股本;增持 / 减持 / 新进 / 退出排行
注意只支持 A 股;增减持金额 = 股数变化 × 本期期末价;final=false 表示季报还在披露
code*stringA 股代码:sh603986 / sz000001 / bj920438,或裸 6 位代码
groupstring排行范围:all(全部基金,默认)/ active(只看主动权益基金);汇总两组都给
periodstring报告期 YYYY-MM-DD(季末日:03-31 / 06-30 / 09-30 / 12-31);省略 = 最近一个已有基金披露的季度

持仓

finance_overview财务全景本人读限速

返回资产(持仓市值合计、股票账户现金 stockCash、股票账户净资产 stockNetAssets;有期货持仓时另给 futures:期货权益 = 开仓保证金 + 浮动盈亏,计入资产,名义价值只看敞口)、负债(消费借款在借余额 + 券商融资本金与已计利息 + 股票账户现金透支,融资单列但计入总负债)、净资产(= 股票账户净资产 + 期货权益 − 借款余额,融资与现金各只算一次)、dailyInterest 每天新增利息、upcoming 未来 60 天应还(按到期日归并,逾期未还的排最前)、有融资时给 estMaintenanceRatioPct;url 为全景页
注意口径同 全景页:港股按港元原值计入、不换汇;维持担保比例按本站数据估算(设过持仓现金则计入现金,现金为负按欠款计入分母;不含未记录持仓),与持仓页、my_positions 同一算法,以券商为准;整次只计一次限速

my_positions我的持仓本人读限速

返回每只持股、均价(移动加权含费用)、现价、市值、浮动盈亏(已扣信用利息)、今日盈亏、累计已实现、占比 weight;合计(totalAssets = 市值 + 现金);持仓现金 cash(设过才有);股票账户五个数 totals:marketValue 持仓市值 / cash 可用资产 / totalAssets 总资产 / liabilities 负债(融资本息 + 现金透支)/ netAssets 净资产;有融资时 maintenance 维持担保比例估算;url
注意合计里元与港元直接相加;今天休市(周末 / 节假日)时今日盈亏为 0,asOf 为行情所属交易日;持仓由买卖记录实时推导,与 portfolio_record_list 同源,两次调用之间在网页改过记录才会前后不一致
include_closedboolean是否另列已清仓的股票(只有累计已实现盈亏有意义),默认 false

portfolio_week本周持仓复盘本人读限速

返回每只持仓与近一周涨跌、本周盈亏变化、近一周逐日收盘;合计
注意与 prompt weekly_position_review 同一套算法

portfolio_record_list持仓记录本人读限速

返回按成交日期倒序,一次一页(默认 200、最多 500 条),total 为总条数,有 nextCursor 就带回取下一页;每条带所见 version,卖出带这笔已实现 realized
注意my_positions 就是由这些记录实时推导的,两边同源、无缓存;整份导出在持仓页点「导出」
codestring只看某只股票,带小写市场前缀:sh600519 / sz000001 / hk00700;空 = 全部
fromstring区间起点 YYYY-MM-DD(含,按成交日期);空 = 不限
statusactive / deleted / all状态:active(生效,默认)/ deleted(已删除)/ all
tostring区间终点 YYYY-MM-DD(含);空 = 不限
limitinteger这一页最多多少条,1..500,默认 200
cursorstring翻页游标:上一页结果的 nextCursor;空 = 第一页

portfolio_pnl盈亏日历本人读限速

返回每格盈亏 pnl、时间加权收益率 rate、已实现、卖出笔数;区间合计;取不到历史收盘价的列在 missing
注意按不复权收盘价,不含信用利息
fromstring区间起点 YYYY-MM-DD(含);from / to 都不给 = 本月(按日)/ 今年(按月)/ 最早一笔记录那年到今年(按年)
groupday / month / year分组:day(按日,默认,区间 ≤ 366 天)/ month(按月,区间 ≤ 120 个月)/ year(按年,区间 ≤ 10 年)
tostring区间终点 YYYY-MM-DD(含)

portfolio_record_add记一笔持仓买卖portfolio:write写限速

返回记录 id,该股操作前后摘要 summary;卖出附这笔已实现
注意只记录,不下单
code*string代码,带小写市场前缀:股票 sh600519 / sz000001 / hk00700(不确定先 search_stock);场外基金 of + 6 位基金代码(of025208,不确定先 search_fund)——基金的 price 填确认净值、qty 填份额、fee 填申购 / 赎回费,不能记信用
date*string成交日期 YYYY-MM-DD(东八区),1990-12-19 至今天
price*number成交价,每股,A 股元、港股港元,> 0
qty*number股数,> 0
side*buy / sell方向:buy(买入)/ sell(卖出)
feenumber这笔的费用合计(佣金 + 印花税 + 过户费),≥ 0,默认 0
idempotency_keystring幂等键(按人保留 30 天):重试同一笔请带同一个键,命中返回首次结果且不再写
marginboolean信用标记:买入 true = 整笔融资买入(给了 margin_qty 就以它为准);卖出 true = 信用卖出(先消耗信用批次);默认 false(普通)
margin_qtynumber买入里融资买的股数(0 < margin_qty ≤ qty):一笔可同时含普通股与信用股,qty − margin_qty 是普通股,年化只对这部分计息;不给而 margin=true = 整笔信用;卖出忽略
notestring备注,≤ 40 字
ratenumber年化 %(仅买入的信用股数有意义,0–36);信用买入不给则取默认信用年化
timestring成交时间 HH:MM(东八区,可选);给了网页分时图上才会标出这笔
unattendedboolean无人值守(Agent 自主、没人在场)= true:一律 needs_confirmation 不记;默认 false = 代人

portfolio_record_update改一笔持仓记录portfolio:write写限速

返回新版本、操作前记录、该股前后摘要
注意股票与方向不可改,删了重记
id*string记录 id(portfolio_record_list 返回的 records[].id)
datestring改成交日期 YYYY-MM-DD;不传不改
feenumber改费用;不传不改
marginboolean改信用标记;不传不改(买入:true = 整笔信用、false = 清掉信用股数,给了 margin_qty 以它为准;买入改成信用且不给 rate 时取默认信用年化)
margin_qtynumber改买入里的信用股数(0 ≤ margin_qty ≤ qty,0 = 整笔普通);不传不改;卖出忽略
notestring改备注;不传不改(传空串 = 清空)
pricenumber改成交价;不传不改
qtynumber改股数;不传不改(原来整笔信用的买入只改 qty,信用股数跟着变)
ratenumber改年化 %(0–36);不传不改
timestring改成交时间 HH:MM;不传不改(传空串 = 清掉时间)
unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人
versioninteger所见版本(portfolio_record_list 返回的 version);过期 → conflict;0 / 不传 = 不比对

portfolio_record_delete删除一笔持仓记录(软删除)portfolio:write写限速

返回状态、该股前后摘要
注意删掉买入导致超卖回 oversold
id*string记录 id(portfolio_record_list 返回的 records[].id)
unattendedboolean无人值守 = true:一律 needs_confirmation 不删;默认 false = 代人
versioninteger所见版本;过期 → conflict;0 / 不传 = 不比对

portfolio_record_restore恢复已删除的持仓记录portfolio:write写限速

返回状态、该股前后摘要
id*string已删除记录的 id(portfolio_record_list status=deleted 返回的 records[].id)
unattendedboolean无人值守 = true:一律 needs_confirmation 不恢复;默认 false = 代人

portfolio_settings_set设默认信用年化portfolio:write写限速

返回操作前后值
注意只影响之后新记的信用买入
margin_rate*number默认信用年化 %(0–36,7.2 = 年化 7.2%);只影响之后新记的信用买入
unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人

portfolio_cash_set设持仓现金portfolio:write写限速

返回现金前后值、这条流水
注意现金 = 设的余额 / 转入转出 + 全部买卖记录的现金流:买入扣成交额与费用(融资部分不扣),卖出加成交额减费用与还掉的融资本息;改删记录自动一致,可为负;港股按港元原值与元直接相加
setnumber设为现金余额(元,≥ 0);与 delta 二选一
deltanumber转入为正、转出为负(不为 0);要先设过余额;与 set 二选一
notestring备注,≤ 40 字
unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人

财务健康

finance_health财务健康对照本人读限速

返回只含用户启用的维度(资产比例 / 负债占资产 / 利息成本 / 集中度 / 月还款占收入 / 应急金):current 现状、target 目标、gap 差额(现状 − 目标)、unit、bound(range / max / min)、beyond(差额超出用户设的阈值);资产比例每类一行 rows,集中度前五项 items;算不出时 missing 说缺什么;没设过目标时 templates 给示例配比与出处;url 为健康页
口径资产 = 本站已记录的持仓市值 + 股票账户现金(持仓页设的,归「现金」类)+ 期货权益(名义价值不计入)+ 手填现金 / 债券 / 其它(手填现金只填股票账户以外的);负债同 finance_overview;基金按基金类型归类,期货按品种(股指 → 股票、国债 → 债券、其余 → 大宗商品)
边界目标由用户自己设;gap 只是差额,不是操作建议;系统不选标的、不给买卖方向、不预测、不评分

finance_health_set设定财务健康目标health:write写限速

返回操作前 / 后配置、新 version、changed(值没变不写)
注意只改用户明说的字段;用户没说目标值就问,不替用户定;带 version 比对,过期回 conflict
templatestring示例配比 key(classic_60_30_10:股票 60 / 债券 30 / 大宗商品 10,公开读物的经典配比示例);填进资产比例目标,仍是用户自己的目标
allocobject资产比例:on、targets(stock / bond / commodity / cash / other 各自 %)、threshold(百分点)、clear
debt · concentration · repayobject负债占资产 / 单一持仓占资产 / 月还款占收入:on、target(上限 %)、threshold;集中度另有 penetrate(基金按十大持仓穿透)
interestobject利息成本:unit pct(年化利息占资产 %)/ cny(元 / 月)、target、threshold
emergencyobject应急金:现金 ÷ 近 3 个月月均支出,target 为下限月数
income · cash · bond · otherobject手填数(元):value / clear;other 可带 note。不是账本,只存一个数与更新时间
notifyOn · notifyInbox · notifyPushboolean偏离提醒(默认关):每周一收盘后对照一次,只发新超出的维度
versioninteger所见版本(config.version);0 = 不比对
unattendedboolean无人值守 = true:一律 needs_confirmation 不改

自选与提醒

my_watchlist我的自选本人读限速

返回每只最新价 / 涨跌(批量取价,不必再逐只 stock_quote);url
注意与 App、网页、浏览器扩展同一份

watchlist_add加入自选watchlist:write写限速

返回操作前 / 后的自选清单与数量
注意已在自选里算成功;裸代码自动补前缀
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA / us.IXIC;裸代码(600519 / 00700)会按 search_stock 同源查找补前缀
namestring股票名(可选);缺省按 search_stock 同源查找补上

watchlist_remove移出自选watchlist:write写限速

返回操作前 / 后的自选清单与数量
注意不在自选里算成功
code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX

alert_list我的股价提醒本人

返回股票、目标价、方向(涨到 / 跌到)、状态(监听中 / 已触发)

alert_set设股价提醒alert:write写限速

返回操作前 / 后的提醒清单,复述最终方向
注意每只股票一条,重设覆盖;到价走站内信 + 推送
code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700
price*number目标价,单位元(港股港元),须 > 0 且不等于现价
directionup / down方向:up = 涨到目标价提醒(目标价须高于现价)/ down = 跌到目标价提醒(须低于现价);缺省按现价自动推

alert_remove撤销股价提醒alert:write写限速

返回操作前 / 后的提醒清单
注意不存在算成功
code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700

负债

my_loans我的借款本人

返回默认每笔精简摘要:余额、年化 / 日利率、每天新增利息、已还期数、下期到期与应还、逾期天数;合计;带 id 或 includeRows 时改回完整记录与逐期计划;url
注意利息按每笔自己的计息方式算(按实际天数:日利率 = 年利率 / 该笔的计息基数 basis,360 或 365;整月按月平摊:年化 / 1200);精简摘要带 rateUnit / basis / version(改条款用);默认不列已结清(settledHidden 为没列的笔数)
idstring只看这一笔(借款 id);给了即带逐期计划,不受 includeSettled 限制
includeDeletedboolean是否包含已软删除的借款,默认 false
includeRowsboolean是否带逐期还款计划与完整记录(rows / marks / prepays 等),默认 false = 每笔只给精简摘要;要标记某期(debt_loan_mark 的 k)或看逐期明细时才开,最好配合 id 只取一笔
includeSettledboolean是否包含已结清的借款,默认 false(只列未结清的;settledHidden 给出没列的笔数)

debt_loan_create新增借款debt:write写限速

返回新借款摘要:余额、下期到期与应还、全程利息、version
注意与网页新增表单同一套校验;basis 不传按用户给这个来源配的默认带出(没配过用 365);unattended=true 一律 needs_confirmation 不写
basis360 / 365计息基数:年化与日息互换时一年按多少天。App 展示的年化按人行 2021 年第 3 号公告一律是日息 × 365,照着抄的年化配 365;合同实际按 360 计息的来源才配 360
firstDue*string首次还款日,格式 YYYY-MM-DD,须晚于 start;之后每月同日(当月无此日取月末)
method*annuity / linear / bullet还款方式:annuity(等额本息)/ linear(等额本金)/ bullet(先息后本)
periods*integer期数(按月),1..600
principal*number本金,单位元,须 > 0
rate*number利率数值,单位是百分比但不带 % 号:rateUnit=year 时为年化 %(7.2 = 年化 7.2%);rateUnit=day 时为日息 %(0.02 = 日息万分之二)
source*string借款来源(机构 / 平台名,如 微粒贷、招行信用卡分期),必填,≤24 字
start*string放款 / 起息日,格式 YYYY-MM-DD
graceinteger先息期数,仅 bullet 有意义:前 grace 期只还息,其后等额还本;0..periods-1,缺省 = periods-1(到期一次还本)
interestModedaily / monthly计息方式:daily(按实际天数,默认)每期利息 = 余额 × 日利率 × 本期实际天数;monthly(整月按月平摊)整一个月的期按 余额 × 年化 / 1200 收息、不看 28 还是 31 天,不足月的首期与提前还款切出的半截仍按天
productstring产品(可选,同一来源下的哪个产品,如 京东白条、京东金条),≤40 字;是名称的一部分,列表显示为「来源 · 产品」
rateUnityear / day利率单位:year(年化,默认)/ day(日息);年化换日息 = 年化 / 计息基数 basis
remarkstring备注(可选,如 优化单),≤100 字;不进名称,只在借款详情里展示
unattendedboolean无人值守(Agent 自主、没人在场)= true:一律 needs_confirmation 不记;默认 false = 代人

debt_loan_update修改借款条款debt:write写限速

返回操作前 / 后摘要(动作句列出改了哪些字段)
注意只传要改的字段,不传的不改;与网页编辑表单同一集合、同一套校验。id 不变,已还标记 / 指定本金 / 提前还款原样保留再按新条款收口(期数缩短后越界的丢、区间外的提前还款去掉)。带 version 比对,这笔刚被别处改过回 conflict 不写。年化录入的借款改 basis 会重算利息,日息录入的只改展示的年化
id*string借款 id(my_loans 返回的 loans[].id)
versioninteger所见版本(my_loans 返回的 version);过期 → 冲突不写;0 / 不传 = 不比对
sourcestring改来源(≤24 字);不传不改
productstring改产品(≤40 字,传空串 = 清空);不传不改
remarkstring改备注(≤100 字,传空串 = 清空);不传不改
principalnumber改本金(元,> 0);不传不改
ratenumber改利率数值(百分比数字,含义看 rateUnit);不传不改
rateUnityear / day改利率单位;不传不改(只改单位不改数值会让利率变意思,两者一起给)
basis360 / 365改计息基数;不传不改
startstring改起息日 YYYY-MM-DD;不传不改
firstDuestring改首次还款日 YYYY-MM-DD(须晚于起息日);不传不改
periodsinteger改期数 1..600;不传不改
methodannuity / linear / bullet改还款方式;不传不改
graceinteger改先息期数(仅 bullet);不传不改——原来是经典的到期一次还本就跟着新期数走
interestModedaily / monthly改计息方式;不传不改
unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人

debt_loan_mark标记某期已还 / 未还debt:write写限速

返回操作前 / 后摘要
注意省略 paid = 清掉手动标记,回到按日期判断
id*string借款 id(my_loans 返回的 loans[].id)
k*integer期号,1..期数(my_loans 带 id 或 includeRows=true 时计划行 rows 里的 k)
paidbooleantrue = 标为已还;false = 标为未还;省略或 null = 清掉手动标记,回到按日期判断(到期日已过即视为已还)

debt_prepay_add记一笔提前还款debt:write写限速

返回操作前 / 后摘要
注意提前还款是已发生的事实,没有「改」:录错了用 debt_prepay_revoke 撤销;unattended=true 一律 needs_confirmation 不写
amount*number提前还款金额,单位元,> 0 且不超过该日在借余额;等于余额即结清
date*string提前还款日期,格式 YYYY-MM-DD:不晚于今天,且在 [起息日, 末次还款日) 之内
id*string借款 id(my_loans 返回的 loans[].id)
unattendedboolean无人值守 = true:一律 needs_confirmation 不记;默认 false = 代人

debt_prepay_revoke撤销一条提前还款debt:write写限速

返回操作前 / 后摘要
注意撤的是记录不是钱——用户真还过的不要撤;撤错了可再 debt_prepay_add 录回(id 会变);unattended=true 一律 needs_confirmation 不写
id*string借款 id(my_loans 返回的 loans[].id)
prepayId*string要撤销的那条提前还款记录 id(my_loans 带 id 时 prepays[].id)
unattendedboolean无人值守 = true:一律 needs_confirmation 不撤;默认 false = 代人

debt_loan_delete删除借款(软删除)debt:write写限速

返回操作前 / 后摘要
id*string借款 id(my_loans 返回的 loans[].id)

debt_loan_restore恢复已删除的借款debt:write写限速

返回操作前 / 后摘要
注意id 用 my_loans(includeDeleted=true) 查
id*string借款 id(my_loans 返回的 loans[].id)

消费

expense_list消费记录列表本人读限速

返回每条状态、来源、所见 version、可否自主处理;meta.total 只计生效
categorystring按分类 code 筛(见 expense_categories),空 = 不筛
fromstring区间起点 YYYY-MM-DD(含),东八区交易日
limitinteger最多返回多少条,缺省取服务端默认上限
monthstring月份 YYYY-MM,取整月;与 from / to 互斥(都不给 = 本月)
sourcestring按来源筛:manual / photo / text / import / mcp / rule,空 = 不筛
statusactive / pending / deleted / all状态:active(生效,默认)/ pending(待确认)/ deleted(已删除)/ all
tostring区间终点 YYYY-MM-DD(含)

expense_get取一笔消费记录本人读限速

返回记录、所见 version、来源 / 行为者、导入批次 batchId 或规则 ruleId
id*string记录 id(expense_list 返回的 rows[].id)

expense_summary消费汇总本人读限速

返回按月 / 分类 / 月×分类的总额与笔数,待确认笔数;含本月时另给 fixed(固定开销待入账)
注意只计生效记录,退款抵消;fixed.total 不计入 total
fromstring区间起点 YYYY-MM-DD(含);from / to 都不给 = 本月
groupmonth / category / month_category分组:month(按月,默认)/ category(按分类)/ month_category(月×分类)
tostring区间终点 YYYY-MM-DD(含)

expense_categories消费分类清单本人

返回十项分类的 code 与显示名
注意清单固定

expense_quota识别配额本人读限速

返回剩余 / 上限与重置时刻
注意按人按日,东八区次日零点重置

expense_import_list导入批次列表本人读限速

返回批次列表,新的在前,含已撤销

expense_recurring_list周期规则列表本人读限速

返回每条状态(manual / auto / paused)、下次触发日、最近生成的记录、连续被删期数
注意开 / 关「自动」只能本人在网页操作

expense_draft识别为草稿OAuth读限速

返回草稿列表:字段置信度、建议分类、疑似重复 similar
注意不落库;消耗识别配额(文本规则抓全不计);个人 API 令牌不能调
image_base64string图片内容 base64(JPEG / PNG / WebP;大小上限由服务端配置,默认 1MB,超限回 payload_too_large 附 limit_bytes;可带 data:image/...;base64, 前缀);与 text 二选一,给了图片走图片模式
mimestring图片类型提示(image/jpeg / image/png / image/webp);服务端以内容嗅探为准,可不填
textstring要识别的文本:支付通知、银行短信、分享账单等原文;金额与时间都抓到即不调模型、不计配额

expense_import_preview账单导入预览OAuth读限速

返回预览 token(30 分钟)、逐行标记 add / skip_hard / merge_similar、统计
注意不写记录;个人 API 令牌不能调
file_base64*string账单文件内容 base64(支付宝交易记录 CSV / 微信支付账单 XLSX;大小上限由服务端配置,默认 2MB,超限回 payload_too_large 附 limit_bytes)
file_name*string原文件名(含扩展名 .csv / .xlsx,用于判来源)
sourcealipay / wechat显式来源:alipay(支付宝)/ wechat(微信);空 = 按扩展名与内容自动判

expense_add记一笔消费expense:write写限速

返回记录 id、状态 active / pending、本月合计前后
注意交易号命中 → duplicate,不可绕过;疑似重复附 candidates,核对后带 ignore_similar=true 重调;unattended=true 一律落待确认
amount*number金额,单位元,最多两位小数;支出为正、退款为负,不能为 0
category*string分类 code,须在 expense_categories 清单内(food / transport / shopping / housing / utilities / entertainment / medical / education / social / other)
merchant*string商户 / 收款方(≤ 60 字)
time*string交易时间:RFC3339(如 2026-10-28T12:30:00+08:00)或 YYYY-MM-DD HH:MM(按东八区解);只给 YYYY-MM-DD 则记当天 00:00
channelstring支付渠道(微信 / 支付宝 / 银行卡…,自由文本 ≤ 24 字)
ext_refstring交易号 / 订单号(硬去重键:同号已存在即 duplicate 不可绕过)
idempotency_keystring幂等键(按人唯一,保留 30 天):重试同一笔请带同一个键,命中返回首次结果且不再写
ignore_similarbooleantrue = 已核对过疑似重复(duplicate 软命中)确认不是同一笔,放行落库
locobject可选地点(经纬度落库取 3 位小数)
notestring备注(≤ 40 字,如商品 / 项目摘要)
unattendedboolean无人值守(Agent 自主、没人在场)= true:这笔一律落为待确认,由人之后在网页 / App 里放行;默认 false = 代人记账

expense_update改一笔消费expense:write写限速

返回新版本与前后摘要
注意交易号 / 状态 / 来源不可改;unattended=true 一律 needs_confirmation
id*string记录 id
amountnumber改金额,单位元(退款为负);不传不改
categorystring改分类 code;不传不改
channelstring改支付渠道;不传不改
clear_locbooleantrue = 清掉地点(优先于 loc)
locobject改地点;不传不改
merchantstring改商户;不传不改
notestring改备注;不传不改(传空串 = 清空)
timestring改交易时间,RFC3339 或 YYYY-MM-DD HH:MM;不传不改
unattendedboolean无人值守 = true:自主姿态不改记录,会回 needs_confirmation;默认 false
versioninteger所见版本(expense_get / expense_list 返回的 version);过期 → conflict 附当前记录;0 / 不传 = 不比对,最后写入为准

expense_delete删除一笔消费(软删除)expense:write写限速

返回前后摘要
注意无人值守只能删本连接产生的待确认记录
id*string记录 id
unattendedboolean无人值守 = true(自主姿态只能删自己产生的待确认记录);默认 false
versioninteger所见版本;过期 → conflict;0 / 不传 = 不比对

expense_restore恢复已删除的消费记录expense:write写限速

返回前后摘要
id*string记录 id
unattendedboolean无人值守 = true(自主姿态只能删自己产生的待确认记录);默认 false
versioninteger所见版本;过期 → conflict;0 / 不传 = 不比对

expense_import_commit提交账单导入expense:write写限速

返回批次摘要(新增 / 跳过 / 合并)与涉及月份合计前后
注意同一 token 只能提交一次;unattended=true → needs_confirmation
token*stringexpense_import_preview 返回的预览 token(有效 30 分钟,只能提交一次)
decisionsobject每行的决定,键为预览行 index(字串),值为 add / skip / merge:<记录 id>;缺省行取预览的 suggested;skip_hard 行不能改为 add
unattendedboolean无人值守 = true 会回 needs_confirmation(提交导入须人看过预览);默认 false

expense_import_revoke撤销一次账单导入expense:write写限速

返回撤销的行数
注意新增行软删并清交易号;合并行只撤补上的字段
batch_id*string导入批次 id(expense_import_commit 返回的 batch.id,或 expense_import_list 里的 id)

expense_recurring_set登记 / 修改周期规则expense:write写限速

返回规则 id、状态、下次触发日
注意新登记一律手动触发,到期只生成待确认;登记时本期到期日已过当场补一笔待确认;开「自动」没有工具
amount*number每期金额,单位元,> 0(固定开销只有支出)
category*string分类 code,须在 expense_categories 清单内
period_day*integermonthly 时为每月几号 1..31(当月无此日取月末);weekly 时为周几 1..7(周一 = 1)
period_kind*monthly / weekly周期:monthly(每月)/ weekly(每周)
idstring要修改的规则 id(expense_recurring_list 返回的 rules[].id);不传 = 新登记一条(状态一律 manual 手动触发)
merchantstring商户 / 收款方(≤ 60 字),如 房东、网易云音乐;到期时同金额、商户相似的生效记录已存在则该期跳过
notestring备注(≤ 40 字),生成的每笔记录都带
unattendedboolean无人值守 = true:自主姿态不能登记 / 改规则,会回 needs_confirmation;默认 false
versioninteger修改时的所见版本(rules[].version);过期 → conflict;0 / 不传 = 不比对

expense_recurring_pause暂停 / 恢复周期规则expense:write写限速

返回状态
注意恢复回到暂停前状态
id*string规则 id(expense_recurring_list 返回的 rules[].id)
pause*booleantrue = 暂停(到期不再生成,记下暂停前状态);false = 恢复(回到暂停前的状态,不会借机开自动)

反馈

feedback_list我的意见反馈本人

返回类型、标题、状态(普通 / 已完结)、最近活动、未读处理方消息数、所见 version
注意默认只列普通(还没完结)的;不改未读
statusopen / done / all状态筛选:open(默认,普通 = 还没完结)/ done(已完结)/ all(全部)
unread_onlybooleantrue = 只看有未读处理方消息的

feedback_get一条反馈的往来本人

返回正文、环境、附图句柄、消息与状态事件 items、允许的下一步 actions(普通:reply / close;已完结只剩 create_new)、所见 version
注意不改未读
id*integer反馈 id(feedback_list 返回的 feedbacks[].id)

feedback_image取一张反馈附图本人读限速

返回图片(content 里是 image,structuredContent.data_base64)
name*string图片句柄(feedback_get 返回的 images / items[].images 里的一项,32 位十六进制 + .jpg / .png)

feedback_create提交意见反馈feedback:write写限速

返回反馈 id、状态、站内 url、摘要
注意同人 10 分钟内同标题 → duplicate;每人每日 10 条
content*string正文:现象、复现步骤、期望,≤2000 字
title*string标题,一句话说清现象或建议,≤60 字
type*bug / suggestion类型:bug(问题反馈)/ suggestion(优化建议)
envobject可选环境信息(Agent 能拿到就附):如 host(宿主)/ page(页面地址)/ platform / version;≤16 项,值 ≤200 字;系统不校验真伪
idempotency_keystring幂等键(按人保留 30 天;如对话片段指纹):重试同一条请带同一个键,命中返回首次结果且不再新建
imagesarray附图,内联 base64(可带 data:image/png;base64, 前缀),≤3 张,解码后单张 ≤1MB,仅 jpg / png
unattendedboolean无人值守(Agent 自主、没人在场)= true:照常生效、计入 Agent 写额度,来源记为 Agent 自主;默认 false = 代人

feedback_reply在反馈里追加消息feedback:write写限速

返回消息 id、新状态、前后摘要
注意只能追加到普通(还没完结)的反馈;已完结的回 state_invalid,要说别的就 feedback_create 新提一条并在正文引用旧 id
id*integer反馈 id
bodystring消息正文,≤1000 字;正文与附图至少其一
idempotency_keystring幂等键:重试同一条消息请带同一个键,命中返回首次结果
imagesarray附图,内联 base64,≤3 张,解码后单张 ≤1MB,仅 jpg / png
unattendedboolean无人值守 = true:照常生效、计入 Agent 写额度,来源记为 Agent 自主;答不了的问题留给人,别硬答;默认 false

feedback_reply_retract撤回自己的一条消息feedback:write写限速

返回消息状态「已撤回」
注意通知收不回
message_id*integer要撤回的消息 id(feedback_get 的 items 里 kind=message、side=user 的 id)

feedback_close结束自己的反馈feedback:write写限速

返回状态「已完结」
注意关了就不能再追加、也不能重开,要说别的新提一条;unattended=true → needs_confirmation
id*integer反馈 id
version*integer所见版本(feedback_get / feedback_list 返回的 version);过期 → conflict 附当前头
notestring可选附言(落为一条你这边的消息),≤1000 字
unattendedboolean无人值守 = true 一律 needs_confirmation(解没解决、要不要了只有人知道);默认 false

feedback_mark_read把反馈标为已读feedback:write写限速

返回未读数归零
注意人看过之后才标
id*integer反馈 id(feedback_list 返回的 feedbacks[].id)

分析笔记

是什么你的定时 Agent 把每个时段的分析写成一份报告,挂在主题(一只股票,或「市场」这类无代码主题)下面,另把你的态度、风格、规则这类背景记成记忆;chanshu 只存储与展示,并按你的设置把报告同步到你自己的通知源(企业微信 / 飞书 / 钉钉 / Slack 群机器人)
内容由你连接的 Agent 写入、只对本人可见;chanshu 不生成、不过滤、不改写,校验只有长度与格式,超限回 invalid / quota_exceeded,内容不会被截断
报告格式七段,顺序固定,空的段页面不画:instruction 指令(必填)→ summary 摘要 → levels 价位 → signals 信号 → steps 步骤 → snapshot 关键数字 → body 正文。格式只规定结构,每段里叫什么、有几条、写什么由你的 Agent 定。每份报告自带一整套:没给的段就是这份报告没有这一段,不沿用上一份
顺序analysis_state_get(拿全局记忆、各主题与最近一份报告 latest_report)→ 用行情工具取数 → 在 latest_report 上改,整份交给 analysis_report_add(带 idempotency_key);格式不对回 invalid 并指明哪一段哪个字段,改了重交
记忆每条是「名字 + 一句话」,只留当前值:全局的(与具体股票无关,style 约定为投资风格)与每个主题的。由 Agent 用 analysis_memory_set 写;页面上只看、不改
无人值守五个写工具 unattended=true 照常生效,只记来源
同步通知源与同步设置只能本人在 账号设置 里改,没有工具;同步没成不是错误,看结果里的 push

analysis_state_get分析笔记状态本人读限速

返回全局记忆 memory;每个主题的 key / type / title / enabled / sort / params / version、该主题的记忆 memory、报告份数 report_count、最近一份报告 latest_report(没有为 null):报告格式的同一形状,只是不带 body;url
注意定时任务每次运行的第一步;只查库,不计行情日配额
topicstring只看这一个主题(股票代码或自定义短键,不论启用与否);空 = 全部启用的主题

analysis_report_list翻历史报告本人读限速

返回报告头 reports(只有指令与摘要,不含价位、信号、步骤与 body)、next_cursor、url
注意交易日倒序、同日按写入时刻倒序;一页 ≤50 条(缺省 20),有 next_cursor 就带回 cursor 取下一页
topicstring只看这个主题的报告
slotstring只看这个时段的报告(如 a_close)
from · tostring交易日区间 YYYY-MM-DD,含两端
statusactive / deleted / all缺省 active(未删除)
limitinteger这一页最多几条,1..50,缺省 20
cursorstring上一页结果的 next_cursor

analysis_report_get读一份报告本人读限速

返回全部字段(报告格式的七段)、同步记录 sync_log(每个通知源一条:source_name / kind auto 或 resend / status / reason)、url
注意已删除的也能读(deleted_at 非 0)
id*string报告 id(analysis_report_list 的 reports[].id,或 analysis_report_add 的 report_id)

analysis_topic_set建或改分析主题analysis:write写限速

返回操作前 / 后、created、changed(值没变不写、版本不动)
注意已存在的主题必须带所见 version,过期或不带回 conflict 附 current;主题只是容器,价位、信号、步骤随每份报告写(analysis_report_add);股票 / 期货 / 基金不给 title 则取行情里的名称;每人默认最多 50 个主题
key*string主题键(带类型):股票用行情工具的代码写法,不带前缀(sz300308 / hk00700 / usNVDA,裸代码自动补市场前缀);期货 futures/<合约>(futures/rb2701,主力连续 futures/rb0);基金 fund/<6 位代码>(fund/025208);其它用自定义短键 [a-z0-9_]{1,24}(如 market)。返回里的 type(stock / futures / fund / custom)由键推出
titlestring显示名 ≤24 字
enabled · sortboolean · integer启用(缺省 true;关掉的不在全景卡出现,数据保留)与页面顺序
paramsobject你自用的键值(≤2KB),原样存取、页面不画;整份替换,{} 清空
versioninteger所见版本(analysis_state_get 返回);新建不带
unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 false

analysis_memory_set更新分析记忆analysis:write写限速

返回这一组记忆的操作前 / 后、实际删掉的 removed
注意记的是背景(态度、风格、规则),不是行情也不是持仓;只留当前值;同值不写;每组(全局一组、每个主题一组)最多 12 条,超了整次不写;与写主题共用每日次数
topicstring记在哪个主题下(须已存在);空 = 全局记忆
itemsarray每条 key [a-z0-9_]{1,32}、text 一句话 ≤200 字必给;label ≤12 字首次必给、之后不传不改。全局里 style 约定为投资风格,页面排第一
removearray要删的记忆 key
unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 false

analysis_report_add记分析报告analysis:write写限速

返回report_id、url、replayed、同步结果 push:status sent / partial / failed / skipped、reason、code、items(每个源一条)
格式入参就是报告格式的定义;没给的段 = 这份报告没有这一段。格式不对回 invalid,reason 指明哪一段哪个字段(如 signals[2].as_of),内容不会被截断或改写
幂等同一 idempotency_key 30 天内重放返回首次结果,不写第二份、不再投递
skippedsync_disabled 没开「收到报告时同步」/ no_sources 没勾选通知源 / push_false / quota_exhausted 当日投递次数用完 / notify_unavailable;前两种照 suggested_actions 请用户去账号设置
额度每个 OAuth 连接每日默认 100000 份;每人默认最多 100000 份(未删除计)
idempotency_key*string幂等键,≤128 字
slot*string时段标签 [a-z0-9_]{1,16}(如 a_close / hk_close / us_premarket / us_close / manual)
instruction*string① 指令:一句 ≤80 字(页面上最醒目的一句,同步消息里加粗)
topicstring挂在哪个主题下(须已存在);空 = 不挂主题
slot_labelstring时段显示名 ≤12 字
trade_datestring交易日 YYYY-MM-DD;空 = 东八区今天
summarystring② 摘要 ≤300 字
levelsarray③ 价位(≤6 条):label ≤12 字、price > 0、note ≤40 字;页面画成价位条
signalsarray④ 信号(≤12 条):label ≤12 字、state green / yellow / red(页面画成实心 / 半心 / 空心圆)、evidence 一句依据 ≤120 字、as_of YYYY-MM-DD 必给;state_label ≤8 字;key [a-z0-9_]{1,32} 可空(你自己跨报告对齐用)
stepsarray⑤ 步骤(≤8 条):label ≤12 字、text ≤120 字、status ≤8 字(显示给人的状态文字)、mark waiting(缺省)/ triggered / entered / failed / locked(决定圆点画法)
snapshotarray⑥ 关键数字 {k, v, ref},≤40 行、≤8KB,页面画成三列表
bodystring⑦ 正文:Markdown ≤20000 字,只在报告全文页展开
modelstring署名:写这份报告的模型或 Agent 名(如 Claude Fable 5.2),≤40 字;页面在报告底部灰字显示
pushboolean缺省 / true 跟随用户的「收到报告时同步」(不能越过用户关着的开关);false = 本次不同步
unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 false

analysis_report_delete删除分析报告analysis:write写限速

返回changed(已删除再删为 false)与报告头
注意软删除,可用 analysis_report_restore 恢复
id*string报告 id
unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 false

analysis_report_restore恢复分析报告analysis:write写限速

返回changed(未删除再恢复为 false)与报告头
注意恢复后超过报告总数上限回 quota_exceeded
id*string报告 id
unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 false

Prompts

weekly_position_review—拉取我的持仓(按股汇总,由买卖记录推导)与每只近一周的日 K,列出持仓明细、今日与本周涨跌、盈亏变化,请模型做周度复盘。
next_month_repayment—拉取我的借款,列出下个自然月每笔到期日、应还金额、利息 / 本金拆分与合计,请模型评估还款压力并给建议。
fund_overlapcode*给定基金代码,拉取它的十大持仓与我的持仓,列出重合股票与权重,请模型分析集中度。
health_review—拉取我自己设的财务健康目标与本站现状的对照,请模型按维度只复述 现状 / 目标 / 差额,不加任何建议
record_positiontext把一笔股票买卖记进我的持仓(只记录,不下单):整理成交事实(股票、买 / 卖、日期、价、量、费用、是否信用及信用股数)并复述确认 → portfolio_record_add。可选参数 text 为成交原文。
expense_recordtext看截图 / 读支付通知原文 → 读出金额、时间、商户、分类等字段并复述确认 → expense_add 记入;疑似重复先 expense_get 核对。可选参数 text 为要记的原文。
expense_review_pending—拉取我全部待确认(status=pending)的消费记录列成表,请模型归类、点出异常与疑似重复并给每笔建议;确认 / 拒绝只能由本人在网页 / App 里做,Agent 不替人确认。
feedback_reporttext把刚才碰到的问题或建议反馈给 chanshu:整理类型、标题、现象与环境信息 → 对照我未完结的反馈查重(同一问题改 feedback_reply 追加)→ 复述确认后 feedback_create。可选参数 text 为现象原文。

限速与额度

档额度超限
读限速默认每令牌 60 次 / 分钟结果 isError,structuredContent = {error, retry_after_seconds}
写限速默认每令牌 10 次 / 分钟,全部写工具共用持仓与分析笔记写同上;其余写工具回文本「写操作过于频繁,请稍后再试」
不限速—基金查库、my_loans、alert_list、expense_categories、feedback_list、feedback_get
额度上限超出
行情原料 · 日配额默认每人每日合计 300 次(东八区零点重置),标「日配额」的十八只工具(股票十二只、期货六只)共用;本人数据、基金与 stock_brief 不计quota_exceeded 附 reset_at、limit,当天别再重试
单次返回stock_kline / futures_kline 一页 120 / 250 根;stock_margin 一页 20 / 60 / 250 个交易日;portfolio_record_list 一页最多 500 条按 end / cursor 翻页;整份数据在网页上点「导出」
消费识别默认每人每日 50 次,网页与 OAuth 连接共用;expense_quota 查quota_exceeded 附 reset_at
消费 · Agent每日写默认 100 笔、单笔 50000 元落为待确认
消费 · 待确认积压 300 笔needs_confirmation
反馈 · AgentOAuth 连接每日创建 5 条、消息 30 条needs_confirmation
反馈 · 每人每日创建 10 条quota_exceeded
持仓 · Agent默认每人每日写 100 次needs_confirmation
分析笔记 · Agent每个 OAuth 连接每日写报告默认 100000 份、写主题与记忆合计默认 100000 次quota_exceeded 附 reset_at
分析笔记 · 每人默认主题 50 个、报告 100000 份(未删除计)quota_exceeded,删掉不需要的再写
内联载荷消费图片 1MB、账单文件 2MB;反馈附图 ≤3 张、单张 1MBpayload_too_large 附 limit_bytes

错误码

形状工具错误一律是 isError=true 的结果,不是协议错误。消费、反馈、持仓、分析笔记四组带 structuredContent.error = {code, reason, suggested_actions} 与载荷(candidates / current / reset_at / limit_bytes …);负债、自选、提醒三组只有文本
code出现在怎么办
invalid消费 / 反馈 / 持仓 / 分析笔记按 reason 改参数
not_found消费 / 反馈 / 持仓 / 分析笔记id 不对或不属于本人,重新列表找
conflict消费 / 反馈 / 持仓 / 分析笔记所见 version 过期:重读,以 current.version 为准再决定
duplicate消费 / 反馈消费:hard=true 不可绕过,疑似重复核对 candidates 后带 ignore_similar=true;反馈:改 feedback_reply 追加到 existing_id
needs_confirmation消费 / 反馈 / 持仓无人值守被拦或 Agent 额度用完:等人在场以代人姿态重调
scope_missing持仓 / 分析笔记重新授权并勾上「管理我的持仓」或「记录分析笔记」
token_not_allowed消费 / 反馈个人 API 令牌不能调,改用 OAuth 连接
quota_exceeded行情原料 / 消费 / 反馈 / 分析笔记看 reset_at;行情类当天别再重试,识别可改为自己读图或文本模式
payload_too_large消费 / 反馈按 limit_bytes 压缩或拆小
limit消费 / 持仓记录数到上限,清理后再写
already_imported消费同一账单已导过:expense_import_list 看批次,要重导先撤销
preview_expired消费预览过期或已提交,重新预览
recognize_failed消费识别不可用,自己读出字段直接 expense_add
state_invalid反馈按 allowed 换动作;已完结的不能追加,新提一条并在正文引用旧 id
oversold持仓某笔卖出超过当时持股:补记买入或改日期
unknown_stock持仓search_stock 拿带前缀的代码
deleted持仓已删除的记录先 restore 再改
not_deleted持仓没删,不用恢复

数据口径

代码股票带小写市场前缀:sh600519 / sz000001 / hk00700 / usNVDA,指数同此(美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX);基金 6 位数字;期货为品种 + 四位年月(rb2701,郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0)
行情A 股最新快照;港股、美股延迟;K 线前复权,只有日 / 周 / 月;美股只有行情、自选与资讯(无财报 / 简况 / 公告,不能记持仓、设提醒)
期货原始价不复权;涨跌相对昨结算价;成交量、持仓量单位手;结算价收盘后才有;期货自选与股票自选分开;期货持仓单独由开平仓记录推导(多空分开、按乘数与保证金率算),不进股票持仓,不能设提醒
基金十大持仓来自季报,滞后一到三个月
金额单位元(港股港元);持仓合计元与港元直接相加,不换汇;消费退款为负
休市今天不是该市场交易日(周末 / 节假日)时,持仓的今日盈亏为 0,asOf 给出行情所属交易日
利息负债按每笔的计息方式(按实际天数:日利率 = 年利率 / 该笔的计息基数 360 或 365;整月按月平摊:年化 / 1200);持仓信用批次 = 本金 × 年化 × 自然日 / 360,已扣进浮动盈亏
时间东八区;日期 YYYY-MM-DD
声明仅供参考,不构成投资建议

Skill

Claude Code
mkdir -p ~/.claude/skills/chanshu && curl -fsSL https://chanshu.top/docs/skill/SKILL.md -o ~/.claude/skills/chanshu/SKILL.md
原文/docs/skill/SKILL.md(text/markdown)
内容代码格式、查询顺序、各场景流程、写前复述 / 写后回摘要、失败分支;口径与数据在服务端

llms.txt

地址/llms.txt(text/plain)
内容MCP 地址、本页、skill、账号设置的入口,外加站内各页面地址与一句话说明

开发者 / 脚本调用

个人 API 令牌cs_ 开头,请求头 Authorization: Bearer cs_…;给脚本、curl 或不支持 OAuth 的客户端用
权限只读:调不了写工具,也调不了 expense_draft / expense_import_preview(回 token_not_allowed)
生成账号设置 · 开发者 · API 令牌,明文只显示一次
有效期30 / 90 / 180 / 365 天或不过期,默认 90 天;过期后鉴权拒收,列表标「已过期」,要手动吊销
数量每人最多 10 枚,过期的也占名额
Claude Code
claude mcp add --transport http -s user chanshu https://chanshu.top/api/mcp --header "Authorization: Bearer <令牌>"
Codex
[mcp_servers.chanshu]
url = "https://chanshu.top/api/mcp"
http_headers = { Authorization = "Bearer <令牌>" }
Cursor
{
  "mcpServers": {
    "chanshu": {
      "url": "https://chanshu.top/api/mcp",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}
curl · MCP
curl https://chanshu.top/api/mcp \
  -H "Authorization: Bearer <令牌>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl · REST
curl -H "Authorization: Bearer <令牌>" https://chanshu.top/api/debt/loans
写方法令牌对 REST 的 POST / PUT / DELETE 回 403