技能名称: orderly-positions-tpsl
详细描述:

Orderly Network：仓位与止盈止损

本技能涵盖仓位管理、盈亏追踪、杠杆设置，以及配置止盈（TP）和止损（SL）订单以进行风险管理。

使用场景

• - 构建仓位管理界面
• 使用止盈止损实现风险管理
• 追踪未实现盈亏
• 调整杠杆设置

前置条件

• - 在 Orderly 上持有未平仓仓位
• 了解永续合约
• 具有 read 和 trading 权限的 API 密钥

仓位数据结构

typescript
interface Position {
symbol: string; // 例如 PERPETHUSDC
position_qty: number; // 正数 = 多头，负数 = 空头
averageopenprice: number; // 开仓均价
mark_price: number; // 当前标记价格
unrealized_pnl: number; // 未实现盈亏
unrealizedpnlroi: number; // 收益率百分比
mmr: number; // 维持保证金率
imr: number; // 初始保证金率
notional: number; // 仓位价值
leverage: number; // 当前杠杆
estliqprice: number; // 预估强平价
cost_position: number; // 仓位成本
settle_price: number; // 结算价格
unsettled_pnl: number; // 未结算盈亏
}

获取仓位（REST API）

typescript
// 获取所有仓位
GET /v1/positions

// 获取特定交易对的仓位
GET /v1/position/{symbol}

// 示例响应
{
success: true,
data: {
rows: [
{
symbol: PERPETHUSDC,
position_qty: 0.5,
averageopenprice: 3000,
mark_price: 3100,
unrealized_pnl: 50,
unrealizedpnlroi: 0.0333,
mmr: 0.01,
imr: 0.02,
notional: 1550,
leverage: 10,
estliqprice: 2700
}
]
}
}

React SDK：usePositionStream

实时流式传输仓位，并自动更新盈亏：

typescript
import { usePositionStream } from @orderly.network/hooks;

function PositionsTable() {
const {
rows,
aggregated,
totalUnrealizedROI,
isLoading
} = usePositionStream();

if (isLoading) return

return (

平仓

部分平仓

typescript
import { usePositionClose } from @orderly.network/hooks;

function ClosePositionButton({ symbol, positionQty }: { symbol: string; positionQty: number }) {
const { closePosition, isClosing } = usePositionClose();

const handleClose = async (percentage: number) => {
const quantity = Math.abs(positionQty) * (percentage / 100);
await closePosition({
symbol,
qty: quantity,
side: positionQty > 0 ? SELL : BUY,
});
};

return (

市价平仓（REST API）

typescript
// 以市价平掉整个仓位
POST /v1/order
Body: {
symbol: PERPETHUSDC,
side: positionQty > 0 ? SELL : BUY,
order_type: MARKET,
order_quantity: Math.abs(positionQty).toString(),
reduce_only: true,
}

杠杆管理

获取当前杠杆

typescript
GET /v1/client/leverage?symbol={symbol}

// 响应
{
success: true,
data: {
leverage: 10,
max_leverage: 25
}
}

设置杠杆

typescript
POST /v1/client/leverage
Body: {
symbol: PERPETHUSDC,
leverage: 15, // 新的杠杆值
}

// React SDK
import { useLeverage } from @orderly.network/hooks;

function LeverageSlider({ symbol }: { symbol: string }) {
const { leverage, maxLeverage, setLeverage, isLoading } = useLeverage(symbol);

const handleChange = async (newLeverage: number) => {
try {
await setLeverage(newLeverage);
} catch (error) {
console.error(设置杠杆失败：, error);
}
};

return (

止盈/止损订单

止盈止损订单类型

使用 useTPSLOrder Hook

typescript
import { useTPSLOrder } from @orderly.network/hooks;

function TPSSettings({ position }: { position: Position }) {
const [computed, { setValue, submit, validate, reset }] = useTPSLOrder(position);

const handleSubmit = async () => {
try {
await validate();
await submit();
console.log(止盈止损订单已下达);
} catch (error) {
console.error(止盈止损失败：, error);
}
};

return (