Developer & Agent Portal

链研社 Agent 与 API 文档

这里是人类开发者和自动化客户端的统一入口。先判断数据是否适合任务，再选择接口；引用结果时请同时保留来源路径、响应中的更新时间和适用范围。

公开读取接口当前免费；x402 聚合商品已启用

公开页面与读取 API 无需注册或 API Key。GET /api/v1 是可选的 0.01 USDC 一次请求聚合服务，不会把原有免费内容改成付费内容。运营写入、刷新和内部管理接口仍不对第三方开放。

机器发现入口

/docs/api/openapi.json完整 OpenAPI 3.1 契约、参数、响应结构和错误码。 /.well-known/api-catalog站点级 API 目录与主要服务入口。 /llms.txt内容范围、适用任务、禁用场景和引用规则。 /auth.md公开读取、运营凭据、错误处理和撤销边界。 /api/x402当前真实付费商品、x402 版本、网络与付款入口。 /.well-known/ucpUCP 服务、内容购买能力、交付端点与 x402 支付处理器。 /mcpMCP Streamable HTTP 端点；适合支持 MCP 的客户端。 /.well-known/mcp/server-card.jsonMCP 服务卡片、能力清单与连接地址。

UCP + x402 Agent 聚合商品

GET /api/v1 通过 x402 v2 在 Base 主网收取 0.01 USDC，并在一次 JSON 响应中交付市场看板与 AI 周期快照。未付款请求返回 402 和 PAYMENT-REQUIRED；客户端完成其中一个付款要求后，使用 PAYMENT-SIGNATURE 重试同一 URL。

Agent 可先读取 /.well-known/ucp，获取协议版本、服务、com.lianyanshe.content.purchase 能力、精确交付 URL 和 com.lianyanshe.x402 支付处理器。该发现文档不会宣称尚未实现的购物车、订单或付费研报能力。

这是为需要减少往返次数的 Agent 提供的便利商品。/api/dashboard/snapshot 与 /api/ai-cycle/snapshot 仍可分别免费读取，全部研报也继续免费。

公开读取接口

市场数据看板

GET /api/dashboard/snapshot
GET /api/dashboard/options
GET /api/dashboard/health

AI 周期雷达

GET /api/ai-cycle/snapshot

个股分析

GET /api/stockanalysis/live?ticker=NVDA
GET /api/stockanalysis/search?q=NVDA
GET /api/stockanalysis/kline?ticker=NVDA
GET /api/stockanalysis/events?ticker=NVDA

机构持仓

GET /api/holdings/kline?asset=BTC

最短请求示例

请求 API 索引确认当前访问状态，再读取需要的数据。公开 GET 请求不应携带私密凭据。

curl -sS https://lianyanshe.com/api
curl -sS https://lianyanshe.com/api/dashboard/snapshot
curl -sS "https://lianyanshe.com/api/stockanalysis/search?q=NVDA"

反馈与合作提交

联系页通过 POST /api/feedback 提交有限长度的建议或合作意向，消息进入 D1 队列，再由本地 Hermes 增量提醒运营者。提交接口不接收密码、令牌、私钥或其他秘密；受保护的收件箱不对第三方开放。

普通读者应直接使用反馈表单或合作表单。自动化客户端若确需提交，必须遵守 OpenAPI 中的来源、频率与字段限制。

数据时效与正确使用

优先读取响应中的 updatedAt、sourceAt、asOf 或同类时间字段；不要把抓取时间当作市场事件发生时间。
健康接口反映数据管线状态，不等于交易所、公司或监管机构的官方状态。
快照可能使用缓存或静态冷备。高时效决策应回到响应标注的原始来源复核。
本站是研究与教育资料，不提供个性化投资建议，也不适合作为自动下单的唯一信号。

状态码与鉴权边界

200 表示请求成功；402 仅表示已列出的 x402 商品需要付款；400 通常是参数缺失或格式错误；404 表示路径或资源不存在；429 表示请求过快；5xx 表示暂时无法完成。运营接口返回 401 或 403 时，不应尝试猜测凭据或绕过限制。

完整字段和错误结构以 OpenAPI 契约为准。发现文档与实际响应冲突时，请以 HTTP 状态和响应内容为现场证据，并通过联系页报告。