查询链上市场绑定

GET/api/v1/markets/{marketId}/chain-binding公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

签 OrderV1 用的链上 Market 对象 id 唯一读取路径。只有 200 可以签名下单；404(chain_binding_not_found)/409（chain_binding_not_active, status 给原态）/503（chain_binding_source_unavailable）四种响应刻意分开，任何失败都不返回占位值。客户端可缓存 200（绑定 ACTIVE 后不可变），不要缓存 404/409。packageId 是建市场的合约包地址，不是签名域里的 package_id（那个取自链上 ProtocolConfig）;account_epoch 不在这里，由前端直接读链。

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

响应

200绑定 ACTIVE

marketIdstring
链下市场 id
示例"mkt-0001"
onchainMarketIdstring
链上 Market 对象 id（签 OrderV1 用的 market_id）
示例"onchainMarket_01K5H2M3N7"
packageIdstring
建市场的合约包地址；签名域 package_id 取自链上 ProtocolConfig，两者会不同
示例"0x2b7f…a903"
statusACTIVE | PENDING | FAILED
只有 ACTIVE 可以签名下单
示例"ACTIVE"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/chain-binding"

响应

绑定 ACTIVE

{
  "marketId": "mkt-0001",
  "onchainMarketId": "onchainMarket_01K5H2M3N7",
  "packageId": "0x2b7f…a903",
  "status": "ACTIVE"
}