用途:只读查看某钱包在 DFlow Kalshi 预测市场的活动,包括持仓、按市值计价、已实现盈亏、成交历史与可赎回头寸。
前置条件:DFlow 文档 MCP(https://pond.dflow.net/mcp),按仓库 README 安装;dflow CLI 可选,用于快速持仓视图。
主要能力与用法:没有 /positions 端点,组合需由链上钱包余额加元数据拼接而成。快速路径用 CLI 命令 dflow positions,输出单个 JSON 信封,含 spot 与 outcome 两类持仓及余额、市场标签;仅限当前活动 vault 钱包,无 --wallet 参数,且不含标记价格、redemptionStatus 与成交历史。完整路径为自建 API 流水线:用 Solana RPC 的 getParsedTokenAccountsByOwner(wallet, { programId: TOKEN_2022_PROGRAM_ID }) 读取余额(结果代币为 Token-2022,稳定币另查经典 SPL 程序);POST /api/v1/filter_outcome_mints 过滤出预测市场结果 mint;POST /api/v1/markets/batch 获取市场元数据;再按 accounts.yesMint / noMint 匹配判断 YES 或 NO。未实现按市值计价用买价:Long YES 用 yesBid,Long NO 用 noBid。已实现活动用 GET /api/v1/onchain-trades?wallet=<pubkey>&sortBy=createdAt&sortOrder=desc&limit=N。可赎回需同时满足市场状态为 determined 或 finalized、redemptionStatus 为 open、持有的是获胜方。赎回交由 dflow-kalshi-trading。
限制与注意:需向用户询问视图类型、钱包公钥(仅 API)、DFlow API key 与 RPC URL;不要询问结算 mint、滑点、费用、签名。无 key 用开发主机 https://dev-prediction-markets-api.dflow.net(限流),有 key 用 https://prediction-markets-api.dflow.net 加 x-api-key。成交后余额可能延迟;完全卖出或赎回后结果代币账户可能关闭;同一市场 USDC 与 CASH 两条轨道为独立持仓。未覆盖细节请查文档 MCP,勿猜测。