Portafolio
El namespace portfolio de @getenginex/sdk-predictions muestra las posiciones y el resumen del jugador. Todos los métodos exigen login: sin sesión, rechazan con UNAUTHENTICATED antes de cualquier request. Los valores monetarios van en centavos.
Posiciones
const positions = await predictions.portfolio.listPositions()
// [{ id, marketId, side: 'yes', quantity: 4, avgPrice: 60, unrealizedPnl: 8, status: 'open', ... }]Devuelve un array (no una Page): el gateway ignora la paginación y devuelve siempre la primera página de 100. Cada Position trae el lado (side), quantity, avgPrice, totalCost, realizedPnl, unrealizedPnl, currentValue, currentPrice, status (open, closed o settled), los datos del mercado y del evento (marketStatus, eventId, eventStatus) y, cuando existan, settledAt, marketResolution y trades (las ejecuciones que componen la posición).
Posición en un mercado
const { yesQuantity, noQuantity, yesAvgPrice, noAvgPrice } = await predictions.portfolio.getPosition({
marketId: 'mkt-1',
})Suma la posición del jugador por lado. No tener posición no es un error: los cuatro números vienen en 0. El gateway suma solo la primera página de 10 posiciones del mercado. Un marketId vacío, con espacio al inicio o al final, o con /, . o .. rechaza con CONFIGURATION_ERROR antes del request.
Resumen
const { totalInvested, totalValue, totalUnrealizedPnl, pendingCollateral, openPositions, openOrders } =
await predictions.portfolio.get()Trae los totales (totalInvested, totalValue, totalRealizedPnl, totalUnrealizedPnl), el colateral retenido en órdenes abiertas (pendingCollateral), los conteos (openPositionsCount, openOrdersCount, settledPositionsCount) y las listas openPositions y openOrders. Para órdenes que acaban de cambiar (por ejemplo, después de orders.place), consulta de nuevo: es una instantánea del momento.
Pruebas
En el mock (withPredictionsRoutes()), el portafolio nace vacío y acompaña a las órdenes: una orden límite abierta entra en openOrders y en pendingCollateral; una orden a mercado se convierte en posición (listPositions, getPosition y get coinciden) y cancelar una orden libera el colateral. Las rutas responden 401 sin token.