error 字段的 JSON 对象：
全局错误
以下错误可能出现在任何需要身份验证的端点上。Unauthorized/Invalid api key — API key 缺失、过期或无效。确保你发送了所有必需的身份验证 header。Trading is currently disabled. Check polymarket.com for updates — 交易所暂时停止运行。不接受任何订单（包括取消）。Trading is currently cancel-only. New orders are not accepted, but cancels are allowed. — 交易所处于仅允许取消模式。你可以取消现有订单，但不能下新单。订单簿
订单簿端点的错误。GET book
Invalid token id — token_id 查询参数缺失或不是有效的 token ID。No orderbook exists for the requested token idPOST books
Invalid payload — 请求体格式错误或缺少必填字段。Payload exceeds the limit — 单次请求中的 token ID 数量过多，请减少批量大小。价格查询
价格、中间价和价差端点的错误。GET price
Invalid token id — token_id 参数缺失或无效。Invalid side — side 参数必须为 BUY 或 SELL。No orderbook exists for the requested token idPOST prices
Invalid payload — 请求体格式错误或缺少必填字段。Invalid side — side 字段必须为 BUY 或 SELL。Payload exceeds the limit — 单次请求中的 token ID 数量过多。GET midpoint
Invalid token id — token_id 参数缺失或无效。No orderbook exists for the requested token idPOST midpoints
Invalid payload — 请求体格式错误或缺少必填字段。Payload exceeds the limit — 单次请求中的 token ID 数量过多。GET spread
Invalid token id — token_id 参数缺失或无效。No orderbook exists for the requested token idPOST spreads
Invalid payload — 请求体格式错误或缺少必填字段。Payload exceeds the limit — 单次请求中的 token ID 数量过多。下单
下单端点的错误。POST order
Invalid order payload — 请求体格式错误、缺少必填字段或包含无效值。the order owner has to be the owner of the API KEY — 订单中的 maker 地址与你的 API key 关联的地址不匹配。the order signer address has to be the address of the API KEY'{address}' address banned — 该地址已被禁止交易。'{address}' address in closed only modePOST orders
包含POST /order 的所有错误，以及：
Too many orders in payload: {N}, max allowed: {M} — 批量请求中的订单数量超过了每次请求的最大允许数量。200 响应数组中返回，每个失败的订单都有独立的错误信息。
订单处理错误
当订单通过初始验证但在处理过程中失败时，会返回这些错误。它们出现在POST /order 和 POST /orders 的响应体中。
invalid post-only order: order crosses book — Post-only（maker）订单会立即成交。请调整价格使其挂在订单簿上。order {id} is invalid. Price ({price}) breaks minimum tick size rule: {tick} — 订单价格不符合市场的最小价格精度。使用 GET /tick-size 查看有效的价格精度。order {id} is invalid. Size ({size}) lower than the minimum: {min} — 订单数量低于市场最小值。order {id} is invalid. Duplicated.order {id} crosses the booknot enough balance / allowance — USDC.e 余额不足或代币授权额度不够。使用 GET /balance-allowance 检查余额，并在需要时授权 exchange 合约。invalid nonce — 订单 nonce 已被使用或无效。invalid expiration — 订单过期时间已过或无效。order canceled in the CTF exchange contractorder match delayed due to market conditionsorder couldn't be fully filled. FOK orders are fully filled or killed. — Fill-or-Kill 订单无法被现有流动性完全填充，整个订单被拒绝。no orders found to match with FAK order. FAK orders are partially filled or killed if no match is found. — Fill-and-Kill 订单未找到任何匹配订单。至少需要一个匹配。the market is not yet ready to process new orders撮合引擎错误
订单执行过程中可能出现的内部撮合引擎错误。there are no matching ordersFOK orders are filled or killed — Fill-or-Kill 订单无法被完全满足。the trade contains rounding issuesthe price of the taker's order has a discrepancy greater than allowed with the worst maker order取消订单
取消订单端点的错误。DELETE order
Invalid order payload — 请求体格式错误。Invalid orderID — 提供的订单 ID 格式无效。DELETE orders
Invalid order payload — 请求体格式错误。Too many orders in payload, max allowed: {N} — 单次取消请求中的订单 ID 数量过多。Invalid orderID — 一个或多个订单 ID 无效。DELETE cancel-market-orders
Invalid order payload — 请求体格式错误或包含无效的筛选参数。查询订单
查询订单端点的错误。GET order by ID
Invalid orderID — URL 路径中的订单 ID 无效。Internal server error — 获取订单时发生意外错误。GET orders
invalid order params payload — 查询参数格式错误或包含无效值。Internal server error — 获取订单时发生意外错误。交易记录
GET trades
Invalid trade params payload — 查询参数格式错误或包含无效值。Internal server error — 获取交易记录时发生意外错误。GET last-trade-price
Invalid token id — token_id 参数缺失或无效。Internal server error — 获取最近成交价时发生意外错误。POST last-trades-prices
Invalid payload — 请求体格式错误或缺少必填字段。Payload exceeds the limit — 单次请求中的 token ID 数量过多。市场信息
GET market by condition ID
Invalid market — condition ID 格式无效。market not found — 不存在该 condition ID 对应的市场。GET tick-size
Invalid token id — token ID 无效。market not found — 未找到该 token ID 对应的市场。GET neg-risk
Invalid token id — token ID 无效。market not found — 未找到该 token ID 对应的市场。价格历史
GET prices-history
筛选条件验证错误 — 一个或多个查询参数（
market、startTs、endTs、fidelity）无效。GET ohlc
startTs is required — 缺少 startTs 查询参数。asset_id is required — 缺少 asset_id 查询参数。invalid fidelity: {val} — fidelity 参数必须为以下值之一：1m、5m、15m、30m、1h、4h、1d、1w。limit cannot exceed 1000 — 请将 limit 参数减少到 1000 或以下。GET orderbook-history
startTs is required — 缺少 startTs 查询参数。either market or asset_id must be provided — 你必须指定 market（condition ID）或 asset_id（token ID）其中之一。limit cannot exceed 1000 — 请将 limit 参数减少到 1000 或以下。身份验证和 API Key
POST auth api-key
Invalid L1 Request headers — L1 身份验证 header 缺失或无效。Could not create api keyGET auth api-keys
Could not retrieve API keys — 获取 API key 时发生意外错误。DELETE auth api-key
Could not delete API key — 删除 API key 时发生意外错误。GET auth derive-api-key
Invalid L1 Request headers — L1 身份验证 header 缺失或无效。Could not derive api key!Builder API Key
POST auth builder-api-key
could not create builder api key — Builder API key 创建失败。GET auth builder-api-key
could not get builder api keys — 获取 Builder API key 时发生意外错误。DELETE auth builder-api-key
invalid revoke builder api key body — 请求体格式错误。invalid revoke builder api key headers — 缺少必要的身份验证 header。could not revoke the builder api key: {key} — 撤销 key 时发生意外错误。Builder 交易记录
GET builder trades
invalid builder trade params — 查询参数格式错误或包含无效值。could not fetch builder trades — 获取 Builder 交易记录时发生意外错误。余额和授权
GET balance-allowance
Invalid asset type — asset_type 参数不是可识别的资产类型。Invalid signature_type — signature_type 参数必须为 EOA、POLY_PROXY 或 GNOSIS_SAFE。状态码速查
| 状态码 | 含义 | 常见原因 |
|---|---|---|
400 | Bad Request | 无效参数、格式错误的请求体、业务逻辑违规 |
401 | Unauthorized | API key 缺失或无效、HMAC 签名错误、时间戳过期 |
404 | Not Found | 市场不存在、订单未找到、token ID 无法识别 |
429 | Too Many Requests | 超过速率限制——请实施指数退避策略 |
500 | Internal Server Error | 服务器意外错误——请使用退避策略重试 |
503 | Service Unavailable | 交易所暂停或处于仅允许取消模式 |
CLOB API 内部存在状态码覆盖机制：任何包含
"not found" 的错误信息会返回 404，包含 "unauthorized" 的会返回 401，包含 "context canceled" 的会返回 400，无论原始状态码是什么。