xtraderClient/docs/api/market.md

market.ts

路径：src/api/market.ts

功能用途

交易与市场相关接口：下单、取消订单、Split（USDC 换 Yes+No）、Merge（Yes+No 换 USDC）。对接 CLOB Gateway 与 PmMarket 接口。ApiResponse 来自 @/api/types。

核心能力

• pmOrderPlace：下单（买入/卖出 Yes 或 No）
• pmCancelOrder：取消订单
• pmMarketSplit：用 USDC 兑换 Yes+No 份额
• pmMarketMerge：合并 Yes+No 份额得到 USDC

类型说明

类型	说明
ClobSubmitOrderRequest	下单请求体，含 tokenID、price、size、side 等
ClobCancelOrderRequest	取消订单请求体
PmMarketSplitRequest	Split 请求体，marketID、usdcAmount
PmMarketMergeRequest	Merge 请求体，marketID、amount

使用方式

import {
  pmOrderPlace,
  pmCancelOrder,
  pmMarketSplit,
  pmMarketMerge,
} from '@/api/market'
import { useUserStore } from '@/stores/user'

const userStore = useUserStore()
const headers = userStore.getAuthHeaders()
if (!headers) return

// 下单
await pmOrderPlace(
  {
    tokenID: clobTokenId,
    price: 3700, // 37¢ = 3700
    size: 100,
    side: Side.Buy,
    // ... 其他字段
  },
  { headers }
)

// Split
await pmMarketSplit({ marketID: '123', usdcAmount: '10' }, { headers })

// Merge
await pmMarketMerge({ marketID: '123', amount: '5' }, { headers })

扩展方式

1. 批量下单：封装 pmOrderPlace 循环或对接批量接口
2. 订单状态查询：新增 getOpenOrders、getOrderHistory 等接口
3. 价格/数量校验：在调用前增加业务校验逻辑