Cardano Wallet Analytics API: Holdings, History, and FIFO P&L for Any Stake Address
Cardano Wallet Analytics API: Holdings, History, and FIFO P&L for Any Stake Address
Raw chain data tells you what a wallet did. It does not tell you what the wallet is worth, how that value has moved, or whether the owner is up or down on any given token. That second layer, holdings valuation, value history, and profit-and-loss, is derived data, and deriving it is real work: you have to reconstruct positions over time, match every disposal against prior acquisitions, and mark remaining holdings to current market prices.
Portfolio trackers, tax tools, and institutional reporting products all need this layer, and most end up building it in-house on top of a raw chain API. The Nexus Wallet Analytics add-on provides it as an endpoint.
What you can query
Everything keys off a Cardano stake address:
Current holdings, every asset a wallet holds, including ADA, with USD valuation.
Value history, the wallet's total value over time, ready to chart.
Single-wallet P&L, realized and unrealized gains and losses per token.
Multi-wallet P&L, FIFO profit-and-loss for a batch of stake addresses in one POST request, for products tracking many wallets at once.
How the P&L is computed
The accounting model matters, so it is worth stating precisely: P&L is computed FIFO (first-in, first-out). Each disposal is matched against the earliest acquisitions to derive cost basis and realized gains; holdings still in the wallet are marked to current market price for unrealized P&L. FIFO is the cost-basis convention most tax regimes and reporting standards expect, which is exactly why it is the wrong thing to improvise in-house.
How it works
# Single-wallet P&L
curl "https://nexus.gerowallet.io/api/wallet/stake1u9.../pnl" \
-H "X-Api-Key: nxs_your_api_key_here"
# Multi-wallet P&L in one request
curl -X POST "https://nexus.gerowallet.io/api/wallet/pnl" \
-H "X-Api-Key: nxs_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{ "stakeAddresses": ["stake1u9...", "stake1uy..."] }'
Plain REST, the same X-Api-Key header as every other Nexus endpoint, full schemas in the API reference. Valuations lean on the same market data layer that indexes all 11 Cardano DEXes, so prices reflect real aggregate liquidity rather than a single pool.
What teams build with it
Portfolio trackers render holdings, value charts, and per-token P&L without building a position engine.
Tax and accounting tools get FIFO cost-basis numbers aligned with what reporting standards expect.
Wallets add a "your performance" view that most Cardano wallets simply do not have.
Funds and institutional desks monitor fleets of addresses through the multi-wallet endpoint instead of iterating one by one.
Pricing
Wallet Analytics is a $15/month add-on on Builder ($29), Growth ($79), and Scale ($199), included in Enterprise ($499), sharing your tier's unified request pool. Nexus is the only Cardano data API that offers wallet P&L as an endpoint today.
Point it at a real wallet
The most direct evaluation is to run your own stake address through it. The 7-day Builder trial includes the full API surface: get your key at nexus.gerowallet.io and see what your wallet's FIFO P&L actually looks like.