# 流形 API [Manifold]() 是一个预测市场平台，用户可以根据有关现实世界事件的问题进行创建和交易。它结合了游戏币 (mana) 和奖金，以及自动做市商 (CPMM) 和用于编程访问的丰富 API。请经常_检查此技能和[官方文档]()以获取更新。该 API 仍处于 alpha 阶段，可能会发生更改，恕不另行通知。 > **社区：** 加入 [Manifold Discord]() 提出问题、错误报告并分享您构建的内容。 > **源代码：** Manifold 是开源的。类型定义位于 [common/src/api/schema.ts]()。 ** ** ## 关键概念（术语表）术语 |定义 ---|--- **市场**（合约）|一个可交易的问题。在代码库中称为“合约”，在 API 中称为“市场”。具有结果类型（BINARY、MULTIPLE_CHOICE、PSEUDO_NUMERIC、BOUNTIED_QUESTION、POLL）。 **法力 (M$)** |用于大多数市场的虚拟货币。无法提取真钱。 **现金奖（现金）** |指定市场上提供的真实货币。可以撤回。在市场上由“代币：“CASH””标识。 **兄弟合同** |市场的法力或奖金。通过 `siblingContractId` 在它们之间切换。 **主题（小组）** |应用于市场进行分类的标签。在代码库和 API 中称为“组”。 **CPMM** |恒定产品做市商。用于二元（“cpmm-1”）和多答案（“cpmm-multi-1”）市场的自动做市商。 **副总裁** |动态派利分成市场 — 用于较早的自由响应市场的遗留机制（“dpm-2”）。 **概率** | 0 到 1 之间的数字，代表市场当前隐含的 YES 概率。 **泳池** |支持做市商的股票流动性池。对于 CPMM 市场，显示 YES 和 NO 份额计数。 **流动性** |法力存入 AMM 池中。更多的流动性意味着每笔交易的价格影响更小。 **投注** |市场上的交易。可以是市价单或限价单（当指定“limitProb”时）。 **限价订单** |仅以指定概率价格或更好价格执行的投注。保持开放状态，直至填满、取消或过期。 **股份** |职位的单位。获胜 YES 股票每股可获 1 马币奖励；损失股份支付 0 M$。 **分辨率** |市场的最终结果：是、否、MKT（概率）或取消。 **答案** | MULTIPLE_CHOICE 或 FREE_RESPONSE 市场中可能的结果。每个答案都有其自己的概率。 **赏金** | BOUNTIED_QUESTION 市场，创建者将法力奖励分配给最佳评论/答案。 **投票** |一种非交易市场类型，用户只需对期权进行投票即可。 ** ** ## 基本 URL 环境 |休息 API | WebSocket ---|---|--- **生产** | `https://api.manifold.markets` | `wss://api.manifold.markets/ws` **开发** | `https://api.dev.manifold.markets` | `wss://api.dev.manifold.markets/ws` > **重要提示：** API 最近从“https://manifold.markets/api”移至“https://api.manifold.markets”。旧域名将来将会被删除。始终使用新域。所有 REST 端点都以“/v0/”为前缀。 ** ** ## 文档和参考资料资源 |网址 ---|--- API 文档 | 平台| 源代码 (GitHub) | API 类型定义 | 不和谐社区 | 服务条款 | 数据下载和许可| ** ** ## 身份验证一些端点是公共的（不需要身份验证）。写入端点和特定于用户的读取需要通过 API 密钥进行身份验证。 ### 生成 API 密钥 1. 登录[Manifold]()。 2. 转到您的用户个人资料并单击“编辑”。 3. 滚动到底部的 API 密钥字段。 4. 单击“刷新”按钮生成新密钥。 5. 安全地复制并存储密钥。再次点击刷新将使旧密钥失效并生成新密钥。 ### 使用 API 密钥将密钥包含在“Authorization”标头中：授权：密钥 {your_api_key} 或者，API 通过“授权：承载 {jwt}”接受 Firebase JWT，但这适用于 Web 客户端，不建议第三方使用。 ### 经过身份验证的请求示例卷曲“https://api.manifold.markets/v0/me”\ -H“授权：密钥 YOUR_API_KEY” ** ** ## 速率限制速率限制为 **每个 IP 地址每分钟 500 个请求**。请勿使用多个 IP 地址来规避此限制。对 HTTP 429 响应实施指数退避。 ** ** ## 费用 * **通过 API 发表评论** 需支付 1 M$1 交易费。 * **市场创建**需要法力（请参阅市场创建端点以了解每种类型的当前成本）。 ** ** ## 许可 * **允许：** 机器人、自动交易、算法工具、集成。 * **禁止：** 通过API以外的方式进行抓取；规避速率限制。 * **AI训练数据：** 未经数据许可不得用于商业用途。允许学术和个人/非商业用途。请联系“api@manifold.markets”以获得商业许可。 ** ** ## REST API 端点概述所有端点都相对于“https://api.manifold.markets/v0”。 ### 用户端点 |方法|授权 |描述 ---|---|---|--- `/用户/[用户名]` |获取 |没有 |通过用户名获取用户。返回“用户”。 `/user/[用户名]/lite` |获取 |没有 |通过用户名获取基本显示信息。返回“显示用户”。 `/user/by-id/[id]` |获取 |没有 |通过唯一ID获取用户。返回“用户”。 `/user/by-id/[id]/lite` |获取 |没有 |通过ID获取显示信息。返回“显示用户”。 `/我` |获取 |是的 |获取经过身份验证的用户。返回“用户”。 `/用户` |获取 |没有 |列出所有用户，按创建日期降序排序。参数：“limit”（最大 1000，默认 500）、“before”（分页的用户 ID）。 #### 用户类型用户{ id: 字符串创建时间：数字 name: string // 显示名称 username: string // 在 URL 中使用网址：字符串 avatarUrl?: 字符串生物？：字符串横幅网址？：字符串网站？：字符串 twitterHandle?: 字符串 DiscordHandle？：字符串 isBot?: 布尔值 isAdmin?: 布尔值 isTrustworthy?: boolean // 主持人 isBannedFromPosting?: 布尔值用户已删除？：布尔值余额：数量总存款：数量最后下注时间？：数字 currentBettingStreak?: 数字 } #### 显示用户类型显示用户{ id: 字符串名称：字符串用户名：字符串 avatarUrl?: 字符串 } ### 投资组合端点 |方法|授权 |描述 ---|---|---|--- `/获取用户组合` |获取 |没有 |获取用户的实时投资组合指标。参数：`userId`。 `/获取用户投资组合历史记录` |获取 |没有 |获取一段时间内的投资组合历史记录。参数：“userId”、“period”（“daily”、“weekly”、“monthly”、“allTime”）。 `/get-user-contract-metrics-with-contracts` |获取 |否* |获取用户的仓位及其合约。参数：“userId”（必填）、“limit”（必填）、“offset”、“order”（“lastBetTime”或“profit”）、“perAnswer”。 *经过身份验证后，可能包括您可见的私人市场指标。 #### 投资组合指标类型投资组合指标{ 投资价值：数量现金投资价值：数量余额：数量现金余额：数量香料余额：数量总存款：数量现金存款总额：数量贷款总数：笔时间戳：数字利润？：数量用户 ID: 字符串 } LivePortfolioMetrics = PortfolioMetrics & { 每日利润：数量 } ### 市场 — 发现和上市端点 |方法|授权 |描述 ---|---|---|--- `/市场` |获取 |没有 |按创建日期描述列出市场。参数：“limit”（最大 1000，默认 500）、“sort”（“created-time”、“updated-time”、“last-bet-time”、“last-comment-time”）、“order”（“asc”/“desc”）、“before”（光标分页的市场 ID）、“userId”、“groupId”。返回“LiteMarket[]”。 `/market/[marketId]` |获取 |没有 |通过 ID 获取单一市场。返回“FullMarket”（包括答案，但不包括投注/评论）。 `/slug/[marketSlug]` |获取 |没有 |通过 slug（用户名后的 URL 路径）获取市场。返回“FullMarket”。 `/搜索市场` |获取 |没有 |搜索/过滤市场（类似于浏览页面）。返回“LiteMarket[]”。请参阅下面的参数。 #### 搜索市场参数参数|描述 ---|--- `术语` |搜索查询字符串。可以为空。 `排序` | `most-popular`（默认）、`newest`、`score`、`daily-score`、`freshness-score`、`24-hour-vol`、`liquidity`、`subsidy`、`last-updated`、`close-date`、`start-time`、`resolve-date`、`random`、`bounty-amount`、`prob-descending`、`prob-ascending`。 `过滤器` | “全部”（默认）、“开放”、“已关闭”、“已解决”、“新闻”、“截止 90 天”、“截止周”、“截止月”、“截止日”。 `合约类型` | `ALL`（默认）、`BINARY`、`MULTIPLE_CHOICE`、`DEPENDENT_MULTIPLE_CHOICE`、`INDEPENDENT_MULTIPLE_CHOICE`、`BOUNTY`、`POLL`。 `topicSlug` |仅标有此主题的市场。 `creatorId` |仅此创作者的市场。 `限制` | 0–1000（默认 100）。 `偏移` |要跳过的数字（当 `sort=newest` 时最多 1000）。 `之前` |毫秒时间戳游标，可使用“sort=newest”进行高效分页。传递最后结果的“createdTime”。 `流动性` |每个合约/答案的最低流动性。 ### 市场 — 概率端点 |方法|授权 |描述 ---|---|---|--- `/market/[marketId]/prob` |获取 |没有 |获取当前概率（最大1s缓存）。对于二进制返回“{ prob }”，对于多重返回“{answerProbs: {answerId: prob } }”。 `/市场问题` |获取 |没有 |多个市场的批量概率（最大 1 秒缓存）。参数：`ids`（数组，最多 100 个）。返回 `{ marketId: { prob } ### 市场 — 头寸端点 |方法|授权 |描述 ---|---|---|--- `/market/[marketId]/positions` |获取 |没有 |获取市场的位置数据。参数：`order`（`shares`/`profit`，默认`profit`），`top`，`bottom`，`userId`，`answerId`。返回“ContractMetric[]”。 #### ContractMetric 类型合同指标{ 合约ID：字符串来自：{ [period: string]: { // 日、周、月利润：数量利润百分比：数量投资：数量上一个值：数字值：数字 } } |未定义 hasNoShares: 布尔值 hasShares: 布尔值 hasYesShares: 布尔值投资：数量贷款：数量 maxSharesOutcome: 字符串 |空支付金额：数量利润：数量利润百分比：数量总股数：{ [结果：字符串]：数字 } 用户 ID: 字符串 user用户名：字符串用户名：字符串用户头像Url：字符串最后下注时间：数字 } ### 市场 — 创建与管理端点 |方法|授权 |描述 ---|---|---|--- `/市场` |发布 |是的 |创造新市场。返回“LiteMarket”。请参阅下面的参数。 `/market/[marketId]/answer` |发布 |是的 |添加 MULTIPLE_CHOICE 市场的答案。参数：`文本`。 `/market/[marketId]/add-liquidity` |发布 |是的 |将法力添加到流动性池中（不增加）。参数：`金额`。 `/market/[marketId]/add-bounty` |发布 |是的 |将法力添加到赏金问题的奖励中。参数：`金额`。 `/market/[marketId]/奖励赏金` |发布 |是的 |发放悬赏奖励。参数：`金额`，`commentId`。 `/market/[marketId]/close` |发布 |是的 |设置关闭时间。参数：`closeTime`（自纪元以来的毫秒数；省略立即关闭）。 `/market/[marketId]/group` |发布 |是的 |添加/删除主题标签。参数：“groupId”、“remove”（可选，“true”表示取消标记）。 `/market/[marketId]/resolve` |发布 |是的 |解决一个市场。请参阅下面的分辨率格式。 #### 市场创建参数 **通用参数（所有市场类型）：** 参数|必填|描述 ---|---|--- `结果类型` |是的 | “BINARY”、“MULTIPLE_CHOICE”、“PSEUDO_NUMERIC”、“POLL”、“BOUNTIED_QUESTION”。 `问题` |是的 |标题问题。 `描述` |没有 |纯文本描述。或者使用“descriptionHtml”、“descriptionMarkdown”或“descriptionJson”（字符串化的 TipTap JSON）。 `关闭时间` |没有 |市场收盘时（自纪元以来的毫秒数）。默认为从现在起 7 天。 `可见性` |没有 | “公开”（默认）或“不公开”。 `groupIds` |没有 |要标记的主题 ID 数组。 `额外流动性` |没有 |需要添加额外的流动性。 **按类型列出的附加参数：** 类型 |额外参数 ---|--- 二进制| `initialProb`（1-99，必需） PSEUDO_NUMERIC | `min`、`max`、`isLogScale`、`initialValue` （全部必需）多项选择 | `answers`（字符串[]，必需），`addAnswersMode`（`DISABLED`/`ONLY_CREATOR`/`ANYONE`，默认`DISABLED`），`shouldAnswersSumToOne`（布尔值） BOUNTIED_QUESTION | 悬赏问题`总赏金`（必填）投票 | `answers`（字符串[]，必需） **创作成本：** 类型 |成本 ---|--- 二进制| 50 马币 PSEUDO_NUMERIC | 250 马币多项选择 |每个答案 25 马币，无预设答案则 25 马币 #### 分辨率格式 **二元市场：** *“结果”：“是”、“否”、“MKT”或“取消”。 * `probabilityInt`：可选，在解析为`MKT`时使用。 **多项选择（shouldAnswersSumToOne = true）：** { “结果”：“MKT”， “决议”：[ { "answer": <索引>, "pct": <权重> } ] } 权重总和必须为 100。或者使用“结果”作为单个答案索引的数字，或“取消”。 **多项选择（shouldAnswersSumToOne = false）：**通过单独的请求独立解决每个答案： { “结果”：“是”，//或“否” "answerId": "" } **数字市场：** * `outcome`：`CANCEL` 或数字存储桶 ID。 * `value`: 分辨率值。 * `probabilityInt`：如果提供了 `value`，则为必填项。 ### 交易端点 |方法|授权 |描述 ---|---|---|--- `/打赌` |发布 |是的 |下注或限价单。返回“下注”。 `/多重投注` |发布 |是的 |在一比一的多项选择市场上下多个“是”赌注，目标是每个答案均等份额。返回“下注[]”。 `/bet/cancel/[id]` |发布 |是的 |取消未结限价订单。 `/market/[marketId]/sell` |发布 |是的 |出售股票。参数：`outcome`（`YES`/`NO`，默认为持有），`shares`（可选，默认为全部），`answerId`（多选时必需）。 #### 投注参数参数|必填|描述 ---|---|--- `金额` |是的 |费用前的投注法力金额。 `contractId` |是的 |市场 ID。 `结果` |没有 | “是”（默认）或“否”。 `限制概率` |没有 |使其成为限价订单。 0.01 到 0.99 之间的数字（仅整数百分点，例如 0.01 = 1%）。 `过期时间` |没有 |限价单自动取消时的时间戳（毫秒）。 `expiresMillisAfter` |没有 |创建后毫秒自动取消。 `干运行` |没有 |如果为“true”，则模拟而不放置。 #### 多重投注参数参数|必填|描述 ---|---|--- `contractId` |是的 |市场 ID。必须是“cpmm-multi-1”且“shouldAnswersSumToOne=true”。 `answerIds` |是的 |答案 ID 数组（最少 2 个）。 `金额` |是的 |在所选答案上花费的总法力。 `限制概率` |没有 |每边限价（0.01-0.99，小数点后两位）。 `过期时间` |没有 |自动取消未填充部分的时间戳（毫秒）。 ### 评论端点 |方法|授权 |描述 ---|---|---|--- `/评论` |发布 |是的 |创建市场的顶级评论。参数：“contractId”，加上“content”（TipTap JSON）、“html”或“markdown”之一。费用：1马币。 `/评论` |获取 |没有 |列出市场或用户的评论。参数：`contractId`、`contractSlug`、`limit`（最多 1000）、`page`、`userId`、`order`（`likes`/`newest`/`oldest`）。 ### 投注端点 |方法|授权 |描述 ---|---|---|--- `/投注` |获取 |没有 |列出赌注。参数：`userId`、`username`、`contractId`（可以是多个）、`contractSlug`、`limit`（最大 1000）、`before`/`after`（赌注 ID 游标）、`beforeTime`/`afterTime`（时间戳）、`kinds`（`open-limit`）、`order`（`asc`/`desc`）。 #### 投注类型下注{ id: 字符串合约ID：字符串用户 ID: 字符串 amount: number // 消耗的法力（填充部分用于限制） orderAmount: number // 原始订单金额股份：数量结果：“是” | “不” 之前的概率：数字问题之后：数字创建时间：数字费用：{ 创建者费用：数字平台费用：数量流动性费用：数量 } 已填充：布尔值已取消：布尔值贷款金额：数量 limitProb?: number // 限价订单存在填充：填充[] answerId?: string // 用于多选市场 } 填充{ matchedBetId: 字符串 |空金额：数量股份：数量时间戳：数字费用：{ 创建者费用：数字；平台费用：数量；流动性费用：数字 } } ### 主题（组）端点 |方法|授权 |描述 ---|---|---|--- `/组` |获取 |没有 |列出公共主题，一次 500 个，最新的在前。参数：`beforeTime`、`availableToUserId`。 `/group/[slug]` |获取 |没有 |通过 slug 获取一个主题。 `/group/by-id/[id]` |获取 |没有 |通过ID获取主题。 ### 法力转移端点 |方法|授权 |描述 ---|---|---|--- `/managram` |发布 |是的 |将法力发送给其他用户。参数：`toIds`（用户 ID 数组）、`amount`（>= 10，发送给每个）、`message`（可选）。 ### 交易端点 |方法|授权 |描述 ---|---|---|--- `/txns` |获取 |没有 |列出交易，最新的在前。参数：“token”（“CASH”/“MANA”）、“offset”、“limit”（最多 100）、“before”/“after”（时间戳）、“toId”、“fromId”、“category”。 ### 联赛端点 |方法|授权 |描述 ---|---|---|--- `/联赛` |获取 |没有 |获取联赛积分榜。参数：`userId`、`season`（数字）、`cohort`（字符串）。 ** ** ## 市场类型 `结果类型` | `机制` |描述 ---|---|--- `二进制` | `cpmm-1` |是/否市场，具有单一概率 (0–1)。最常见的类型。 `多项选择` | `cpmm-multi-1` |多个答案，每个答案都有自己的概率。可以是依赖的（总和为 100%）或独立的。 `免费响应` | `dpm-2` |遗产。任何人都可以添加答案。采用DPM机制。 `伪数字` | `cpmm-1` |将概率映射到数值范围 [min, max]。可以是线性或对数刻度。 `BOUNTIED_QUESTION` | — |没有交易。创建者向最佳评论分发奖金。 `民意调查` | — |没有交易。用户对选项进行投票。 ** ** ## Lite市场类型莱特市场{ id: 字符串创建者ID：字符串创建者用户名：字符串创建者名称：字符串 CreatorAvatarUrl?: 字符串创建时间：数字关闭时间？：数字问题：字符串 url: string //总是指向manifold.markets 结果类型：字符串机制：字符串概率：数字池：{ [结果：字符串]：数字 } p?: number // CPMM 概率常数 totalLiquidity?: number // 仅限 CPMM value?: number // 仅 PSEUDO_NUMERIC min?: number // 仅 PSEUDO_NUMERIC max?: number // 仅 PSEUDO_NUMERIC isLogScale?: boolean // 仅 PSEUDO_NUMERIC 体积：数量卷24小时：数量已解决：布尔值解决时间？：数字分辨率？：字符串 resolutionProbability?: number // 用于 MKT 分辨率 uniqueBettorCount：数量最后更新时间？：数字最后下注时间？：数字令牌？：“MANA”| “现金” siblingContractId?: string // 在法力/现金版本之间切换 } ## 全市场类型 FullMarket = LiteMarket & { answers?: Answer[] // 仅限多市场 shouldAnswersSumToOne?: boolean // 仅限多市场 addAnswersMode？：“任何人” | “ONLY_CREATOR”| “已禁用” 选项？：{ 文本：字符串； votes: number }[] // 仅投票 TotalBounty?: number // 仅赏金 bountyLeft?: number // 仅限赏金描述：JSONContent // TipTap 富文本 textDescription: string // 纯文本 coverImageUrl？：字符串 groupSlugs?: string[] // 主题标签 } ** ** ## WebSocket API Manifold 提供实时 WebSocket 服务器用于订阅实时更新。 ### 连接 wss://api.manifold.markets/ws（生产） wss://api.dev.manifold.markets/ws (dev) 连接不需要身份验证。身份验证是可选的（对于特定于用户的主题）。 ### 消息格式所有消息都是 JSON。客户端消息必须包括： * `type`：`identify`、`subscribe`、`unsubscribe` 或 `ping`。 * `txid`：标识消息的唯一编号。服务器确认每条消息： { “类型”：“ack”，“txid”：123，“成功”：true } ### 订阅主题发送订阅消息： { “类型”：“订阅”， “txid”：1， "topics": ["global/new-bet", "contract/[marketId]"] } ### 可用主题 #### 全球话题主题 |描述 ---|--- `全球/新赌注` |所有市场的所有新投注。 `全球/新合约` |所有新市场都在创建中。 `全局/新评论` |所有市场的所有新评论。 `全球/新补贴` |所有新的流动性补贴。 `全局/更新合约` |任何公共市场的更新。 #### 每个市场主题（将 `[marketId]` 替换为实际 ID）主题 |描述 ---|--- `合约/[marketId]` |一般市场更新。 `contract/[marketId]/new-bet` |这个市场上的新赌注。 `contract/[marketId]/new-comment` |关于这个市场的新评论。 `contract/[marketId]/new-subsidy` |新的流动性补贴。 `contract/[marketId]/new-answer` |添加了新答案（多项选择）。 `contract/[marketId]/updated-answers` |对现有答案的更新。 `合约/[marketId]/订单` |限制订单更新。 `合约/[marketId]/图表注释` |图表注释。 `contract/[marketId]/user-metrics/[userId]` |该市场的用户位置更新。 #### 其他主题主题 |描述 ---|--- `用户/[用户 ID]` |更新用户的公共信息。 `answer/[answerId]/update` |更新具体答案。 `电视时间表` |电视节目表更新。 ### 保持活力定期发送 ping（每 30-60 秒）以保持连接处于活动状态。如果 60 秒内未收到 ping，服务器将终止连接。 {“类型”：“ping”，“txid”：42} ### 广播消息服务器以广播消息的形式发送更新： { “类型”：“广播”， "topic": "全局/新投注", “数据”：{...} } ** ** ## 常见模式 ### 列出最近的市场卷曲-s“https://api.manifold.markets/v0/markets?limit=5”| jq '.[].问题' ### 通过 ID 获取单一市场卷曲-s“https://api.manifold.markets/v0/market/3zspH9sSzMlbFQLn9GKR”| jq '{问题，概率，数量，已解决}' ### 通过 Slug 获得市场卷曲-s“https://api.manifold.markets/v0/slug/will-carrick-flynn-win-the-general”| jq '{问题，概率}' ### 搜索开放的二元市场卷曲-s“https://api.manifold.markets/v0/search-markets?term=AI&sort=liquidity&filter=open&contractType=BINARY&limit=10”| jq '.[].问题' ### 获取当前概率卷曲-s“https://api.manifold.markets/v0/market/9t61v9e7x4/prob”| jq '.' ### 获取批次概率卷曲-s“https://api.manifold.markets/v0/market-probs?ids=9t61v9e7x4&ids=ZNlNdzz690”| jq '.' ### 下注“是” 卷曲-X POST“https://api.manifold.markets/v0/bet”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d '{"金额": 10, "contractId": "MARKET_ID", "结果": "YES"}' ### 下限价单卷曲-X POST“https://api.manifold.markets/v0/bet”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d'{ “金额”：100， "contractId": "MARKET_ID", “结果”：“是”， “极限概率”：0.40， “过期MillisAfter”：86400000 }' ### 出售市场上的所有股票卷曲-X POST“https://api.manifold.markets/v0/market/MARKET_ID/sell”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d '{“结果”：“是”}' ### 取消限价订单卷曲-X POST“https://api.manifold.markets/v0/bet/cancel/BET_ID”\ -H“授权：密钥 YOUR_API_KEY” ### 创建二元市场卷曲-X POST“https://api.manifold.markets/v0/market”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d'{ “结果类型”：“二进制”， "question": "明天旧金山会下雨吗？", "descriptionMarkdown": "如果 SFO 气象站记录到可测量的降雨量，则解析为 YES。", “初始概率”：30， “关闭时间”：1735689600000 }' ### 创建一个多重选择市场卷曲-X POST“https://api.manifold.markets/v0/market”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d'{ "outcomeType": "MULTIPLE_CHOICE", "question": "谁将获奖？", “答案”：[“爱丽丝”，“鲍勃”，“查理”]， “shouldAnswersSumToOne”：正确， “addAnswersMode”：“ONLY_CREATOR” }' ### 解决二元市场问题卷曲-X POST“https://api.manifold.markets/v0/market/MARKET_ID/resolve”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d '{“结果”：“是”}' ### 获取你的作品集卷曲-s“https://api.manifold.markets/v0/get-user-portfolio?userId=YOUR_USER_ID”| jq '.' ### 获得市场领先地位卷曲-s“https://api.manifold.markets/v0/market/MARKET_ID/positions?top=5&order=profit”| jq '.[].用户名' ### 对所有市场进行分页（按最新） # 第 1 页卷曲-s“https://api.manifold.markets/v0/search-markets?sort=newest&limit=100”> page1.json # 第2页：使用最后结果的createdTime BEFORE_TIME=$(jq '.[-1].createdTime' page1.json) curl -s "https://api.manifold.markets/v0/search-markets?sort=newest&limit=100&beforeTime=$BEFORE_TIME" > page2.json ### 通过投注分页 # 第一页卷曲-s“https://api.manifold.markets/v0/bets?contractId=MARKET_ID&limit=100”>bets1.json # 下一页：使用上次投注的ID BEFORE=$(jq -r '.[-1].id' bets1.json) 卷曲-s“https://api.manifold.markets/v0/bets?contractId=MARKET_ID&limit=100&before=$BEFORE”>bets2.json ### 向用户发送法力卷曲-X POST“https://api.manifold.markets/v0/managram”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d '{"toIds": ["USER_ID_1", "USER_ID_2"], "金额": 100, "message": "谢谢！"}' ### 发表评论卷曲-X POST“https://api.manifold.markets/v0/comment”\ -H“授权：密钥 YOUR_API_KEY”\ -H“内容类型：application/json”\ -d '{"contractId": "MARKET_ID", "markdown": "好问题！我认为 YES 被低估了。"}' ### WebSocket 订阅 (Node.js) const ws = new WebSocket("wss://api.manifold.markets/ws"); 让txid = 0; ws.onopen = () => { ws.send(JSON.stringify({ 类型：“订阅”，交易ID：交易ID++，主题：[“全球/新赌注”] })); }; ws.onmessage = (事件) => { const msg = JSON.parse(event.data); if (msg.type === "广播") { console.log("新投注：", msg.data); } }; // 每 30 秒保持一次 ping 活动设置间隔（（）=> { ws.send(JSON.stringify({ type: "ping", txid: txid++ })); }, 30000); ** ** ## 使用提示 * **所有时间戳均为 UNIX 毫秒**（JavaScript `Date.now()` 样式），而不是秒。 * **切勿对 API 密钥进行硬编码** — 使用环境变量或安全密钥存储。 * **市场 URL** 始终指向 `https://manifold.markets`，无论您使用哪个 API 实例。 URL 路径中的用户名不需要正确（例如，“manifold.markets/anyone/market-slug”即可）。 * **GET 参数** 进入查询字符串。 **POST/PUT 参数** 位于 JSON 正文中。 * **限价订单** 与当前市场价格交叉的 `limitProb` 将立即部分成交。任何未履行的剩余订单将保留为剩余限价订单。 * **`limitProb` 精度**：仅整数百分比（两位小数，例如，`0.01`、`0.50`、`0.99`）。 * **多项选择市场** 有两种类型：相关（`shouldAnswersSumToOne=true`，概率总和为 100%）和独立（每个答案实际上都是一个单独的二元市场）。 * **结合 REST + WebSocket** 以获得最佳结果：使用 REST 作为初始状态，使用 WebSocket 作为实时增量。 * **负责任地分页** ：对于带有 `sort=newest` 的 `/search-markets`，请使用 `beforeTime` 进行高效的深度分页。对于“/bets”和“/markets”，请使用基于游标的分页和“before”/“after”。 * **市场代币类型**很重要：检查“代币”字段（“MANA”或“CASH”）以了解市场是否使用虚拟货币或奖金。 * **空跑** 通过传递 `dryRun: true` 进行模拟而不下注。 * **描述格式** ：您可以以纯文本 (`description`)、HTML (`descriptionHtml`)、Markdown (`descriptionMarkdown`) 或 TipTap JSON (`descriptionJson`) 形式提供市场描述。只提供一份。 ** ** ## 错误处理 API 响应为 JSON。成功的请求将返回 HTTP 200 和 JSON 结果。错误响应 (4xx/5xx) 返回带有错误消息的 JSON 对象。状态 |含义 ---|--- 200 | 200成功 400 |错误的请求（无效的参数） 401 | 401未经授权（API 密钥缺失或无效） 403 | 403禁止（权限不足） 404 | 404未找到 429 | 429速率限制（超过 500 请求/分钟） 5xx |服务器错误对 429 和 5xx 响应实施指数退避重试。 ** ** ## 内部API Manifold 有一些内部端点，不属于官方 API 的一部分。这些内容没有记录，如有更改，恕不另行通知。端点 |方法|授权 |描述 ---|---|---|--- `/未解决` |发布 |是的 |解决市场问题。参数：`contractId`。注意：内部端点**不**带有“/v0”前缀。 ** ** ## 版本控制当前的 API 版本是 `/v0/` 下的 **v0**。该 API 仍处于 alpha 阶段。监控[官方文档]()和[Discord]()是否有重大更改。

歧管

包含技能