# SOS A股 Agent Gateway

> 免注册、免密钥的 A 股当日盘面查询与事实核验接口。查（GET /v1/market）与验（POST /v1/verify）返回真实数据、出处 URL 与抓取时间；发（POST /v1/publish）只把内容登记成任务，不执行发布。数据源不可用时返回错误，绝不编造、绝不回退旧值。

- Base URL: https://sos-a-share-gateway.pages.dev
- Auth: none（无需注册、无需 API Key；可选 X-Agent-Source 请求头仅用于来源统计）
- 数据覆盖: 最近一个交易日（北京时间）；非交易日或上游未更新时 `data_stale=true`
- 响应格式: JSON (UTF-8)，`Cache-Control: no-store`
- 错误格式: `{"ok":false,"error":{"code","message","details?"}}`
- 费用: 查/验免费；发只登记任务，人工确认报价后线下结算，无自动扣款

## API

- [GET /v1/market](https://sos-a-share-gateway.pages.dev/v1/market): 今日真实盘面：涨停/跌停/连板家数、连板梯队、情绪温度与阶段、封板率、炸板率、晋级率、主线题材及家数、成交额、指数
- [POST /v1/verify](https://sos-a-share-gateway.pages.dev/v1/verify): 提交一句话，逐条判定其中数字/个股/题材是否与当日真实数据一致，返回命中或矛盾的原始依据；也支持 GET /v1/verify?text=...
- [POST /v1/publish](https://sos-a-share-gateway.pages.dev/v1/publish): 登记一条发布任务到中文平台（weibo/zhihu/toutiao/taoguba/xueqiu），只入队不执行
- [GET /v1/stats](https://sos-a-share-gateway.pages.dev/v1/stats): 真实调用计数：总量、外部/内部、按来源次数与首次调用时间
- [GET /tasks](https://sos-a-share-gateway.pages.dev/tasks): 任务列表（内置能力任务 + 已登记发布请求）
- [GET /tasks/:id](https://sos-a-share-gateway.pages.dev/tasks/:id): 单个任务详情
- [POST /tasks](https://sos-a-share-gateway.pages.dev/tasks): 与 /v1/publish 等价的提交入口

## 机器可读文档

- [OpenAPI 3.1](https://sos-a-share-gateway.pages.dev/openapi.json): 完整接口定义，含参数、响应结构、错误码
- [Agent Card](https://sos-a-share-gateway.pages.dev/agent-card.json): 能力清单与接入约定（a2a_compatible=false，不是标准 A2A 服务器）
- [能力清单 manifest](https://sos-a-share-gateway.pages.dev/manifest.json): 能力、验证状态、定价、结算、限制
- [完整说明 llms-full.txt](https://sos-a-share-gateway.pages.dev/llms-full.txt): 字段级说明、错误码表、真实响应示例
- [人类可读首页](https://sos-a-share-gateway.pages.dev/): 接口表与实时计数

## 官方口径

- 数据不新鲜必须看 `data_stale`；为 true 时不要把它当作今日数据使用。
- 拿不到数据时接口返回 502 `upstream_unavailable`，不会返回空壳或旧值。
- 发布不在公网执行：真实发布依赖运营方本机已登录的浏览器，本机关机就无法执行。
- 没有任何外部 Agent 已接入的既成事实；唯一验证指标是 /v1/stats 的 `external_calls` 与 `first_external_call_at`。
- 本服务不构成投资建议，不提供交易、下单、行情推送能力。