Agent API

StockKit 的每一个端点都为智能体友好而设计：基于 HTTPS 的纯 JSON、开放 CORS、测试期间无需认证，以及稳定的机器可读结构。

发现

GET https://api.stockkit.dev/ 返回所有端点的机器可读索引。智能体可以由此：

• 发现：GET /v1/assets 枚举每一个可交易的代币化资产及其链上地址
• 定价：GET /v1/prices/:symbol 返回实时报价，含成交量、当日区间和停牌 状态
• 研究：GET /v1/research/:symbol 返回代币背后在 SEC 注册的公司及其 申报基本面
• 报价：GET /v1/quote 返回可执行的 DEX 报价
• 准备交易：POST /v1/trade/build 返回未签名的交易，由智能体自己的钱包 签名
• 管理资金：GET /v1/portfolio/:address 以美元估值任意钱包的持仓
• 绘图：GET /v1/history/:symbol 返回链上 DEX 价格的 OHLC K 线； GET /v1/stats/:symbol 返回供应量、池流动性，以及 DEX 相对股票报价的溢价
• 盯盘：POST /v1/alerts 注册一次性价格提醒，触发时推送到代理的 Webhook

按次付费

如果智能体更愿意在协议内付费，而不是使用开放的测试端点，可以在 /v1/x402/* 下调用相同的能力，按次以 Robinhood Chain 上的 USDG 或 Base 上的 USDC 计价。参见 x402 API。

设计上即非托管

智能体持有自己的私钥。StockKit 只负责准备 calldata；由智能体用自己的钱包 基础设施签名并提交，资金始终完全由其掌控。

错误

所有错误都采用同一种结构，方便智能体可靠地分支处理：

{ "error": { "code": "no_liquidity", "message": "No executable route for XYZ" } }

错误码：bad_request、not_found、no_liquidity、upstream_error、 internal_error。

MCP 服务器

StockKit 同时也是一个托管的 MCP 服务器，地址为 https://api.stockkit.dev/mcp，因此 Cursor、Claude Code 以及任何 MCP 客户端 都可以把这些能力当作原生工具使用。它提供 Cursor 一键安装 （stockkit-labs/cursor）和 Codex 插件（stockkit-labs/openai）。 参见在 Cursor 和 Claude Code 中使用。