API 文档

SNSUC 开放 API 接口文档 —— 行情数据、新闻研报、询价、仓单查询与存证验证。

Base URL:https://snsuc-mvp-api-cgrcfiwmui.cn-shanghai.fcapp.run

接口列表

GET/api/market公开

获取全部行情

返回 8 大品类实时行情数据，每 1 分钟实时更新

GET/api/market/:id公开

获取单品类行情

按 ID 返回特定品类的行情数据

GET/api/news公开

获取新闻列表

返回最新新闻动态

GET/api/research公开

获取研报列表

返回最新市场研报

POST/api/submit-inquiry需认证

提交询价

登录后提交询价单，触发邮件+企微通知

POST/api/cooperation公开

商务合作

提交商务合作意向，触发邮件+企微通知

GET/api/receipt/:receiptNo公开

查询仓单

公开查询数字仓单信息（持有人脱敏）

GET/api/verify-anchor?hash=:hash公开

验证存证

通过 SHA-256 哈希验证链上存证

使用说明

  • · 公开接口无需认证，调用频率限制 60 次/分钟
  • · 认证接口需在 Header 中携带 Bearer Token（JWT）
  • · 所有响应格式为 JSON
  • · 错误码：400 参数错误 / 401 未认证 / 403 无权限 / 404 不存在 / 429 频率超限 / 500 服务器错误