GET /v1/portfolio/pnl/:walletAddress

Return a wallet's portfolio value change over the last 24 hours — the USD value of its holdings now versus 24 hours ago, plus a per-asset breakdown. Useful for portfolio dashboards and "you're up/down today" tiles.

This is a value change, not trading PnL: deposits and withdrawals move the number too (a deposit reads as an increase, a withdrawal as a decrease). It answers "is my wallet worth more than yesterday?", not "how much did I make trading?". Cost-basis / realized-vs-unrealized accounting is not included.

Holdings are valued with live DEX prices (the same source as /v1/prices); the 24h-ago value reconstructs each asset's balance from the wallet's transaction activity in the window and prices it with the 24h-ago price. Only tracked mints (those returned by /v1/balances) are valued.

Request

GET /v1/portfolio/pnl/:walletAddress
x-api-key: YOUR_API_KEY

Path parameters

Field	Type	Description
walletAddress	string	Base58 wallet pubkey (32-44 chars)

Example

curl https://api.venum.dev/v1/portfolio/pnl/Fgz6qLgeibJPNkNdALqvrYQ9FauLanTKs15miEsAiHqh \
  -H 'x-api-key: YOUR_API_KEY'

Response

200 OK

{
  "wallet": "Fgz6qLgeibJPNkNdALqvrYQ9FauLanTKs15miEsAiHqh",
  "valueNowUsd": 12500.5,
  "value24hAgoUsd": 12000.25,
  "changeUsd": 500.25,
  "changePct": 4.17,
  "assets": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "decimals": 9,
      "balanceNow": 100.5,
      "balance24hAgo": 100.0,
      "priceNow": 80.31,
      "price24hAgo": 78.5,
      "valueNowUsd": 8071.31,
      "value24hAgoUsd": 7850.0,
      "changeUsd": 221.31
    }
  ],
  "stats": {
    "windowHours": 24,
    "rpcPosts": 12,
    "signaturesScanned": 42,
    "txHydrated": 42,
    "truncated": false,
    "elapsedMs": 3250
  },
  "fetchedAt": 1733587200000
}

Top-level fields

Field	Type	Description
wallet	string	The queried wallet
valueNowUsd	number	Total USD value of current holdings
value24hAgoUsd	number	Total USD value of holdings as they stood 24 h ago
changeUsd	number	valueNowUsd − value24hAgoUsd (signed)
changePct	number | null	Percent change vs 24 h ago; null when the 24h-ago value was zero
assets	array	Per-asset breakdown, sorted by valueNowUsd descending
fetchedAt	number	UNIX millisecond timestamp the computation started

Asset object

Field	Type	Description
mint	string	Base58 mint address
symbol	string	Tracked symbol (e.g. "SOL", "USDC")
decimals	number	Token decimals
balanceNow	number	Current balance (human-readable)
balance24hAgo	number	Reconstructed balance 24 h ago (balanceNow − net flow)
priceNow	number | null	Current USD price; null if the asset can't be priced
price24hAgo	number | null	USD price 24 h ago; falls back to priceNow when no 24h % data
valueNowUsd	number	balanceNow × priceNow
value24hAgoUsd	number	balance24hAgo × price24hAgo
changeUsd	number	valueNowUsd − value24hAgoUsd

Stats object

Field	Type	Description
windowHours	number	The lookback window (24)
rpcPosts	number	RPC requests issued for the transaction scan
signaturesScanned	number	Signatures examined inside the window
txHydrated	number	Transactions fully fetched to compute balance deltas
truncated	boolean	true if the wallet had more window activity than the scan cap — the 24h-ago figure is then a partial reconstruction
elapsedMs	number	Server compute time

Notes:

• An asset held 24 h ago but fully sold during the window (zero balance now) still appears, contributing to value24hAgoUsd.
• Assets with no priceable market are included with priceNow: null and contribute 0 to the USD totals.
• When an asset has no 24h price-change data, its price24hAgo falls back to the current price, so its contribution reflects only the change in quantity, not a fabricated price move.
• A truncated: true result means a very active wallet exceeded the scan cap; treat value24hAgoUsd / changeUsd as approximate.

Errors

Status	Description
400	Invalid wallet address (not a valid pubkey)
401	Missing or invalid API key
429	Rate limit exceeded
503	Temporarily unavailable (upstream RPC); retry after the Retry-After header

Auth

Requires API key.

Rate Limit

Dedicated limits (per minute) — lower than /v1/balances because the 24h transaction-history scan makes this endpoint significantly heavier:

Tier	Limit
anonymous	0
free	5
starter	30
growth	75
pro	150