Portfólio
O namespace portfolio de @getenginex/sdk-predictions mostra as posições e o resumo do jogador. Todos os métodos exigem login: sem sessão, rejeitam com UNAUTHENTICATED antes de qualquer request. Valores monetários em centavos.
Posições
const positions = await predictions.portfolio.listPositions()
// [{ id, marketId, side: 'yes', quantity: 4, avgPrice: 60, unrealizedPnl: 8, status: 'open', ... }]Devolve um array (não uma Page): o gateway ignora paginação e devolve sempre a primeira página de 100. Cada Position traz o lado (side), quantity, avgPrice, totalCost, realizedPnl, unrealizedPnl, currentValue, currentPrice, status (open, closed ou settled), os dados do mercado e do evento (marketStatus, eventId, eventStatus) e, quando existirem, settledAt, marketResolution e trades (as execuções que compõem a posição).
Posição em um mercado
const { yesQuantity, noQuantity, yesAvgPrice, noAvgPrice } = await predictions.portfolio.getPosition({
marketId: 'mkt-1',
})Soma a posição do jogador por lado. Sem posição não é erro: os quatro números vêm 0. O gateway soma só a primeira página de 10 posições do mercado. Um marketId vazio, com espaço no início ou no fim, com /, . ou .. rejeita com CONFIGURATION_ERROR antes do request.
Resumo
const { totalInvested, totalValue, totalUnrealizedPnl, pendingCollateral, openPositions, openOrders } =
await predictions.portfolio.get()Traz os totais (totalInvested, totalValue, totalRealizedPnl, totalUnrealizedPnl), o colateral preso em ordens abertas (pendingCollateral), as contagens (openPositionsCount, openOrdersCount, settledPositionsCount) e as listas openPositions e openOrders. Para ordens que acabaram de mudar (por exemplo, depois de orders.place), consulte de novo: é uma foto do momento.
Testes
No mock (withPredictionsRoutes()), o portfólio nasce vazio e acompanha as ordens: uma ordem limitada aberta entra em openOrders e no pendingCollateral; uma ordem a mercado vira posição (listPositions, getPosition e get concordam) e cancelar uma ordem libera o colateral. As rotas respondem 401 sem token.