Agent Financial Advisor

Agent 财务顾问

为进行交易和提供建议的 AI Agent 提供合规官、风险经理、税务顾问和绩效审计员服务。 Agent 在采取行动前会调用它；它会提供有来源依据且确定性的检查，每次调用收取少量费用。

工具

工具	价格	功能
rules_digest	免费	当前美国交易／保证金／结算／税务规则及生效日期和来源
pre_trade_check	$0.005	购买力、现金账户违规、日内保证金（PDT 规则调整后）、Reg SHO、洗售、集中度、止损风险、流动性、价差、手滑错误、杠杆、市场开放时间
position_size	$0.005	带上限的固定比例、波动率目标或分数凯利仓位计算
tax_lot_plan	$0.02	FIFO／LIFO／HIFO／最低税额批次选择、短期／长期拆分、洗售、亏损收割扫描
portfolio_review	$0.05	权重、HHI、行业／资产类别敞口、再平衡交易、夏普／索提诺比率／回撤／VaR／贝塔
strategy_audit	$0.10	交易统计、t 统计量、概率夏普比率和去膨胀夏普比率、过拟合风险信号
suitability_check	$0.03	Reg BI／受托人适当性审查，并生成经过哈希处理的审计备忘录
options_risk_check	$0.01	备兑／现金担保／价差／裸头寸分类、FINRA 4210 保证金、现金账户限制、审批等级、股息导致的提前指派、钉住风险、自动行权、最大亏损、净希腊值

可直接使用的代码（Alpaca 订单守卫、MCP 客户端配置、使用 x402 付款的客户端）：examples/。

本地运行（Node 20+，无依赖项）

npm test
npm start         # http://localhost:8787  (payments off until PAY_TO is set)

试试看：

curl localhost:8787/llms.txt
curl -X POST localhost:8787/v1/tools/position_size -H "content-type: application/json" \
  -d '{"equity":50000,"entry_price":100,"stop_price":95,"method":"fixed_fractional"}'

MCP 客户端：将可流式传输的 HTTP MCP 连接指向 http://localhost:8787/mcp。 如需使用带密钥的免费层和额度，请发送 Authorization: Bearer <key>，使用 /mcp?key=<key>，或让 Agent 调用免费工具 get_api_key，将新密钥绑定到 MCP 会话。为任意 URL 添加 ?src=<name>，即可在 /stats 中归因使用量。

端点

方法	路径
GET	/, /llms.txt	面向 Agent 的可读概览
GET	/v1/tools, /openapi.json, /pricing, /.well-known/x402	发现
POST	/v1/tools/{name}	运行工具
POST	/mcp	MCP JSON-RPC
POST	/v1/keys	免费 API 密钥
GET	/v1/keys/me	密钥余额
POST	/v1/credits?pack=5|20|100	使用 x402 购买额度
GET	/v1/audit	防篡改审计日志：每次使用密钥的付费调用均有记录，并通过哈希链接和服务端签名（?since_seq=）
POST	/v1/audit/verify	验证审计条目的哈希、签名和链
GET	/stats	公开汇总使用数据：调用次数、付费调用次数、已发放密钥数、收入（无身份信息；缓存 10 分钟）
GET	/admin/revenue	收入和使用数据（ADMIN_TOKEN）

配置（环境变量）

变量	默认值
PAY_TO	未设置	接收 USDC 的地址。未设置 = 免费预览，不收款
X402_NETWORK	base-sepolia	使用真实资金时设为 base
CDP_API_KEY_JSON	未设置	密钥：下载的 CDP 密钥文件。设置后，付款会通过 Coinbase CDP facilitator 处理（主网所需）。也可使用 CDP_API_KEY_ID + CDP_API_KEY_SECRET
FACILITATOR_URL	如果设置了密钥则为 CDP，否则为 https://x402.org/facilitator	覆盖 facilitator
FACILITATOR_AUTH	未设置	用于非 CDP facilitator 的静态 Authorization 标头
X402_MIN_USD	0.01	x402 按次付费的最低价格（使用额度时按标价扣费）
FREE_DAILY_CALLS / FREE_DAILY_ANON	25 / 5	免费层
ADMIN_TOKEN	未设置	用于 /admin/revenue
DATA_DIR	./data	Node 存储和账本
PUBLIC_URL	请求主机	用于付款要求

部署（免费）

Cloudflare Workers：运行 npx wrangler kv namespace create AFA_KV，将 ID 填入 wrangler.toml，然后运行 npx wrangler deploy。

使用真实 USDC：运行 npx wrangler secret put CDP_API_KEY_JSON < secrets/cdp_api_key.json，在 wrangler.toml 中设置 X402_NETWORK = "base"，然后部署。

支付（x402）

支持 x402 v2：402 响应携带 base64 编码的 PAYMENT-REQUIRED 标头（CAIP-2 网络，例如 eip155:8453），客户端使用 PAYMENT-SIGNATURE 付款，结算结果则通过 PAYMENT-RESPONSE 返回。v1 客户端（X-PAYMENT、请求体中的 accepts）仍可使用。

在测试网络上运行端到端测试：npm i --no-save viem && node scripts/e2e-payment.mjs <server url> --fund。

目录结构

src/app.js            fetch-style router: REST, MCP, billing hooks
src/server.js         Node entry
src/worker.js         Cloudflare Workers entry (KV store)
src/billing/          free tier, API keys, credits, x402, ledger
src/tools/            the advisory tools
src/lib/regs.js       rule table with sources (reviewed weekly)
src/lib/calendar.js   NYSE calendar
test/                 node --test suites