Portfolio NAV

The report endpoints in this section answer “what goes on the investor statement”. This page answers a smaller question an automated consumer asks every cycle: what is this portfolio worth right now. It is the endpoint to build against when a vault platform, attestation service, or internal job needs to pull NAV on a schedule and publish it somewhere else, on-chain or otherwise. The figure comes from the same portfolio ledger that drives the dashboard, the Report Studio, and /computed, one source of truth, several read paths.

Endpoint

NAV is served per portfolio by the portfolio-management service:

GET /portfolio-management/metrics/ledger/by-portfolio/summary

curl -H "X-API-Key: $API_KEY" \
  "https://api.renesis.fi/portfolio-management/metrics/ledger/by-portfolio/summary?portfolio_id=$PORTFOLIO_ID&vs_currency=usd"

Note the prefix: this service sits behind /portfolio-management, not /lp-report-studio, so a key with a path allowlist needs that prefix too. Access is scoped to the portfolios the key’s account owns.

Parameter	Required	Description
`portfolio_id`	Yes	The portfolio to read (see Finding the portfolio ID).
`vs_currency`	No	Currency for the monetary fields. Default `usd`. Supported: `usd`, `eur`, `jpy`, `chf`, `gbp`, `cad`, `aud`, `nzd`, `inr`, `aed`, `btc`, `eth`, `sol`, `bnb`, `xrp`, `hype`.

Response

{
  "portfolio_id": "665f1c2ab3d94e0012ab34cd",
  "vs_currency": "usd",
  "is_recalculating": false,
  "last_updated_at": "2026-09-03T06:00:12.481000",
  "publish_hold": false,
  "publish_hold_accounts": [],
  "nav": {
    "raw": 12456789.42,
    "gross": 10893211.87,
    "nav_breakdown": { "...": "by category and protocol, always USD" }
  },
  "summary": {
    "current_nav_raw": 12456789.42,
    "current_nav_gross": 10893211.87,
    "realized_pnl_total": 1204334.11,
    "realized_pnl_spot": 981220.45,
    "realized_pnl_perp": 223113.66,
    "unrealized_pnl_total": 359244.18,
    "total_pnl": 1563578.29,
    "asset_count": 42,
    "errors": []
  },
  "total_fees": 48211.03,
  "total_debt": 0.0,
  "total_funding_payments": 12030.55
}

Which number is “the NAV”?

nav.raw. It is the account’s real current value, net equity: spot balances plus protocol positions valued net of debt. This is the figure to attest or publish as vault NAV. nav.gross is NAV neutralized for deposits and withdrawals, pure trading performance. It can be negative, and it is not what a vault is worth. Publishing it as NAV is the classic integration mistake; don’t.

Freshness and publish guards

An automated publisher must never push a stale or flagged figure. Three fields exist for exactly that:

last_updated_at: when the ledger behind this response was last recalculated. Reject the response if it is older than your staleness tolerance.
is_recalculating: true while a ledger rebuild is in flight. Retry after a few minutes, or treat the value as not-yet-final.
publish_hold: a manual do-not-publish gate. true means an operator has flagged this portfolio’s numbers as wrong or not-yet-verified (via the hold button in the account view) and it must not be published until cleared, regardless of last_updated_at. publish_hold_accounts lists which member accounts are held; a portfolio is held if any of them is. This is the hard stop for “hold publishing until manual inspection” — honor it fail-closed: if you cannot read the flag, do not publish.

And one behavior: if no conversion rate is available for the requested vs_currency, the endpoint returns 503 with no figures rather than silently falling back to USD. An empty response instead of a wrong one; what to do with a missed cycle (skip, retry, reuse last published) is your workflow’s decision, made explicitly.

Currency conversion

All flat monetary scalars (nav.raw, nav.gross, the PnL fields, fees, debt, funding) are converted to vs_currency at the current rate.
nav_breakdown and fields explicitly suffixed _usd always stay USD-denominated; the breakdown mixes token amounts with USD values and does not convert cleanly.
Fiat rates use USDC as a USD proxy; crypto denominations divide by the coin’s current USD price. Same sources as the historical chart conversion below, so the series and the scalar agree.

Finding the portfolio ID

curl -H "X-API-Key: $API_KEY" \
  "https://api.renesis.fi/portfolio-management/portfolio/list?owner=you@fund.com"

Returns the portfolios the account owns; use data[i]._id as the portfolio_id. For the recommended one-account-per-vault setup this list has exactly one entry, which also keeps each downstream workflow isolated: a failure or key rotation on one vault never touches the others.

Historical NAV series

For backfills or cross-checking a published series, the daily history is available in the same currencies:

GET /portfolio-management/metrics/ledger/portfolio/{portfolio_id}/chart

curl -H "X-API-Key: $API_KEY" \
  "https://api.renesis.fi/portfolio-management/metrics/ledger/portfolio/$PORTFOLIO_ID/chart?chart_type=nav_raw_history_1d&vs_currency=eur"

Parameter	Required	Description
`chart_type`	Yes	`nav_raw_history_1d`, `nav_gross_history_1d`, `realized_pnl_history`, or `unrealized_pnl_history`.
`vs_currency`	No	Same options as above, default `usd`.

{
  "nav": {
    "raw_history_1d": {
      "1756684800000": 11384211.20,
      "1756771200000": 11402876.55
    }
  },
  "meta": { "vs_currency": "eur", "chart_type": "nav_raw_history_1d", "data_points": 245 }
}

Keys are millisecond timestamps, one point per day; the latest point is the most recent end-of-day NAV.

Errors

Status	Meaning
`400`	Missing `portfolio_id`, or invalid `vs_currency` (the response lists valid options).
`401`	Missing or invalid API key (gateway envelope, see Introduction).
`400/403`	The key’s account has no access to this portfolio.
`404`	No ledger exists for this portfolio yet.
`503`	No conversion rate available for the requested `vs_currency`. No figures returned.

Publishing checklist

Pull a few hours ahead of your publish time, so a data issue can be flagged and resolved before the deadline rather than discovered at it.
Never publish when publish_hold is true. It is the manual hold an operator sets when a figure looks wrong; treat it as a hard stop, skip the cycle, and surface publish_hold_accounts (with reasons) to whoever is on call. Fail closed: if the flag cannot be read, do not publish.
Reject on is_recalculating when the value materially moved, and on last_updated_at older than your tolerance.
Publish nav.raw, never nav.gross.

Getting Started

Methodology

API Reference

Portfolio NAV

Portfolio NAV

Endpoint

Response

Which number is “the NAV”?

Freshness and publish guards

Currency conversion

Finding the portfolio ID

Historical NAV series

Errors

Publishing checklist

​Portfolio NAV

​Endpoint

​Response

​Which number is “the NAV”?

​Freshness and publish guards

​Currency conversion

​Finding the portfolio ID

​Historical NAV series

​Errors

​Publishing checklist

Portfolio NAV

Endpoint

Response

Which number is “the NAV”?

Freshness and publish guards

Currency conversion

Finding the portfolio ID

Historical NAV series

Errors

Publishing checklist