Skip to main content
Wallet Analytics add-on. Portfolio-level analytics for any Cardano stake address: current holdings, value over time, and realized/unrealized profit-and-loss computed on a FIFO (first-in, first-out) cost basis.
Endpoints on this page require the Wallet Analytics add-on. Without it they return HTTP 402 with "addon": "walletAnalytics".
Base URL: https://nexus.gerowallet.io · Auth: X-Api-Key: nexus_…

Endpoints

MethodPathDescription
GET/api/wallet/{stakeAddress}/holdingsCurrent wallet holdings (all assets + ADA)
GET/api/wallet/{stakeAddress}/historyWallet value over time
GET/api/wallet/{stakeAddress}/pnlSingle-wallet realized/unrealized gains & losses
POST/api/wallet/pnlMulti-wallet P&L (FIFO) in one request

Example

# Single-wallet P&L
curl "https://nexus.gerowallet.io/api/wallet/stake1u9.../pnl" \
  -H "X-Api-Key: nexus_your_api_key_here"

# Multi-wallet P&L
curl -X POST "https://nexus.gerowallet.io/api/wallet/pnl" \
  -H "X-Api-Key: nexus_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "stakeAddresses": ["stake1u9...", "stake1uy..."] }'
P&L is computed FIFO: each disposal is matched against the earliest acquisitions to derive cost basis and realized gains. Holdings still held are marked to current market price for unrealized P&L.
Full request/response schemas are in the API Reference.