Fathom

API 接口

模拟平台公开 REST/WebSocket 接口。Base URL：http://127.0.0.1:3100。金额与时间戳一律十进制字符串（金额为 e6 定点）；带「Bearer」标记的 端点需先经 /v1/auth/* 换取 JWT。行情镜像自 Polymarket，仅供模拟交易，不构成投资建议。

市场发现

  • GET/v1/px/events事件列表：tag/sub/q/sort/status/limit/offset
  • GET/v1/px/events/:slugOrId事件详情（含全部市场与标签）
  • GET/v1/px/tags分类标签；?within=<slug> 返回该大类的细分
  • GET/v1/px/markets/:idOrSlug市场详情
  • GET/v1/px/markets/:id/orderbook盘口（?outcome=A|B；镜像自 Polymarket）
  • GET/v1/px/markets/:id/history概率历史（interval=1h|6h|1d|1w|1m|max）
  • GET/v1/px/markets/:id/trades近期成交
  • GET/v1/px/updown5 分钟涨跌视图（?series=btc-up-or-down-5m）
  • GET/v1/px/crypto/:coin/history现货价窗口回放（Chainlink 同源）

认证

  • POST/v1/auth/challenge{address} → 一次性签名 challenge
  • POST/v1/auth/verify钱包 personal message 签名 → access/refresh JWT（支持 zkLogin）

模拟交易（Bearer JWT）

  • GET/v1/px/account模拟账户（现金/权益）Bearer
  • POST/v1/px/faucet领取模拟资金（有冷却）Bearer
  • POST/v1/px/orders下单（市价/限价，金额 e6 字符串）Bearer
  • POST/v1/px/orders/:orderId撤单Bearer
  • GET/v1/px/positions持仓Bearer
  • POST/v1/px/positions/close市价平仓Bearer
  • GET/v1/px/fills成交记录Bearer
  • GET/v1/px/ledger资金流水Bearer
  • POST/v1/px/borrow杠杆借款Bearer
  • POST/v1/px/repay还款Bearer
  • POST/v1/px/lend出借存入Bearer
  • POST/v1/px/lend/withdraw出借取回Bearer
  • GET/v1/px/credit信用/保证金状态Bearer
  • GET/v1/px/position-history已平仓历史Bearer
  • GET/v1/px/liquidations清算记录Bearer

AI 与实时

  • GET/v1/px/ai/picksAI 热度精选（未配置 key 时 enabled=false）
  • POST/v1/px/ai/ask自然语言找市场 / 对冲建议
  • WS/v1/stream订阅主题：px.market.<id>、px.crypto.<coin> 等