Назад към всички

nova-net-worth

// Query your Nova Net Worth financial data — net worth, accounts, holdings, goals, spending, transactions, AI insights, and health score. Use when the user asks about their finances, money, net worth, account balances, investment holdings, portfolio, stocks, financial goals, spending habits, budget, s

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namenova-net-worth
descriptionQuery your Nova Net Worth financial data — net worth, accounts, holdings, goals, spending, transactions, AI insights, and health score. Use when the user asks about their finances, money, net worth, account balances, investment holdings, portfolio, stocks, financial goals, spending habits, budget, savings, investments, debt, transactions, or financial health. Requires NOVA_API_KEY environment variable (API key from app.novanetworth.com → Settings → Integrations).
metadata[object Object]

Nova Net Worth API Skill

Query your complete financial picture from Nova Net Worth via the Agent API v1.

Setup

Set the NOVA_API_KEY environment variable with your Nova API key:

export NOVA_API_KEY=nova_your_key_here

Generate your API key at: app.novanetworth.com → Settings → Integrations Requires SuperNova ($19.99/mo) or Galaxy (enterprise) subscription.

Quick Start

For any "how are my finances?" or daily briefing question, use the composite endpoint:

node scripts/nova-api.js briefing --pretty

Available Commands

Run scripts/nova-api.js with a subcommand:

# Full financial briefing (RECOMMENDED — one call gets everything)
node scripts/nova-api.js briefing
node scripts/nova-api.js briefing --pretty    # Human-readable format

# Net worth summary
node scripts/nova-api.js summary

# All accounts with balances, grouped by type
node scripts/nova-api.js accounts

# Recent transactions with filtering
node scripts/nova-api.js transactions
node scripts/nova-api.js transactions --days 7 --limit 20
node scripts/nova-api.js transactions --category FOOD_AND_DRINK
node scripts/nova-api.js transactions --account acct_123
node scripts/nova-api.js transactions --since 2026-02-20T00:00:00Z  # Delta polling

# Financial goals with progress
node scripts/nova-api.js goals

# Monthly spending by category
node scripts/nova-api.js spending
node scripts/nova-api.js spending --months 3

# AI-generated financial insights
node scripts/nova-api.js insights

# Net worth trend over time
node scripts/nova-api.js history
node scripts/nova-api.js history --days 90

# Financial health score breakdown
node scripts/nova-api.js health

# Investment holdings and positions
node scripts/nova-api.js holdings                    # All holdings
node scripts/nova-api.js holdings --pretty           # Human-readable with gain/loss
node scripts/nova-api.js holdings --account acct_123 # Filter by account
node scripts/nova-api.js holdings --summary          # Aggregate by ticker across accounts

All commands support --pretty for human-readable output or --json (default) for raw JSON.

When to Use Which Endpoint

User QuestionCommandWhy
"How are my finances?" / "Financial update"briefingEverything in one call
"What's my net worth?"summaryQuick headline number
"Show my accounts" / "How much in savings?"accountsAll accounts with balances
"What did I spend on food?" / "Recent purchases"transactions --category FOOD_AND_DRINKFilterable transaction list
"Monthly spending breakdown"spendingCategories with comparison
"Am I on track for my goals?"goalsProgress tracking
"Any financial insights?"insightsAI recommendations
"Net worth trend this year"history --days 365Historical snapshots
"How's my financial health?"healthScore with recommendations
"What stocks do I own?" / "Show my portfolio"holdings --prettyPositions with gain/loss
"Total exposure by ticker"holdings --summaryAggregated across accounts

Response Format

All responses: { success: true, data: {...}, meta: { requestId, timestamp } }

Money values are in cents (integer) with a currency field. Divide by 100 for display. Example: 45840017 = $458,400.17

Transaction Categories (Plaid)

Common categories for filtering: FOOD_AND_DRINK, RENT_AND_UTILITIES, TRANSPORTATION, GENERAL_MERCHANDISE, TRANSFER_OUT, TRANSFER_IN, LOAN_PAYMENTS, ENTERTAINMENT, PERSONAL_CARE, MEDICAL, TRAVEL, INCOME, UNCATEGORIZED

Rate Limits

  • SuperNova: 100 requests/hour
  • Galaxy: 1,000 requests/hour
  • Headers: X-RateLimit-Remaining shows remaining calls

Delta Polling

For efficient monitoring, use --since with the timestamp of your last request:

node scripts/nova-api.js transactions --since 2026-02-25T12:00:00Z

This returns only new transactions since that time, minimizing data transfer.

Environment

  • NOVA_API_KEY (required) — Your Nova API key starting with nova_. Generate at app.novanetworth.com → Settings → Integrations.
  • NOVA_API_URL (optional) — API base URL, defaults to https://api.novanetworth.com

API Documentation