{"uid":"cap_bSiNdLrMu9Ed1Bypxwaz_","slug":"wealthpulse-snapshot-financial-health-score-action-plan-8d56b0e8","name":"WealthPulse Snapshot — Financial Health Score & Action Plan","description":"How healthy are my finances right now, and what should I fix first? Financial-health snapshot with a plain-English assessment, estimated net worth, savings rate, debt-to-income, and emergency-fund months, plus the highest-leverage next actions ranked by effort vs. impact. For personal-finance and wealth agents.","url":"https://wealthpulse-phi.vercel.app/api/wealth/snapshot","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"age":{"type":"string","description":"required"},"debt":{"type":"string","description":"28000 (total non-mortgage debt USD)"},"lang":{"type":"string","description":"en | es | fr | de | pt | zh | ar"},"income":{"type":"string","description":"85000 (annual income USD, required)"},"savings":{"type":"string","description":"45000 (total savings/investments USD)"},"expenses":{"type":"string","description":"4200 (monthly expenses USD)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"summary":"Solid savings rate but debt and a thin emergency fund are holding back real progress.","concerns":["Emergency fund covers only 2.6 months","Debt-to-income at 33% limits flexibility"],"strengths":["27% savings rate","no high-interest revolving balances growing"],"disclaimer":"For informational purposes only. Not financial, tax, or legal advice. Consult a licensed financial advisor for personalized guidance.","key_ratios":{"savings_rate":"27%","debt_to_income":"0.33","emergency_fund_months":"2.6"},"amazon_link":"https://www.amazon.com/s?k=personal+finance+fundamentals&tag=pulsenetwork7-20","health_score":"okay","rate_context":"Current savings rates favor keeping the emergency fund in a HYSA rather than idle cash","amazon_search":"personal finance fundamentals","net_worth_estimate":"$17,000","highest_leverage_moves":[{"why":"Removes the risk of high-interest debt during an income gap","rank":1,"action":"Build emergency fund to 6 months","effort":"medium","impact":"high"},{"why":"Frees up cash flow and stops compounding interest","rank":2,"action":"Eliminate the highest-rate debt first","effort":"medium","impact":"high"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Poj563Tmkt9gCN9jAo0KU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a user's overall financial position to produce a personalized health score and highest-leverage action plan","exampleAgentPrompt":"Can you give me a WealthPulse snapshot of my finances — I earn $95,000 a year, have $42,000 in a 401k, $8,000 in savings, $18,000 in student loans, and $4,200 in credit card debt — what's my financial health score and what's the single highest-leverage thing I should do first?","exampleUseCases":[{"title":"Quick financial health checkup before big purchase","prompt":"I'm thinking about buying a car and want to make sure my finances are in good shape first. Can you analyze my situation? I make $75,000 yearly, have $25,000 saved, $120,000 in home equity, $8,000 in car loans, and $3,000 credit card debt. What does my financial health look like and what should I prioritize before this purchase?"},{"title":"New freelancer assessing overall money situation","prompt":"I just started freelancing and my income is now variable instead of a salary. My annual take-home is around $65,000 some years, I have $15,000 in savings, $50,000 in retirement accounts, no debt, but I'm worried about my financial stability. Can you give me a complete financial health check and tell me what matters most right now?"},{"title":"Parent planning financial strategy for family","prompt":"My partner and I want to get our finances in order before we have kids. Together we make $140,000 a year, have $35,000 in savings, $180,000 in home equity, $22,000 in student loans, and $5,000 in car debt. What's our overall financial health and what should we tackle first to be in better shape for a growing family?"}],"resultDescription":"Returns a personalized financial health score and a prioritized, highest-leverage action plan based on the user's income, assets, debts, and financial position — highlighting the most impactful steps to improve overall financial wellness.","failureModes":["Missing required financial inputs (income, assets, or debts) — returns 400 with validation error","Payment not received or x402 payment header invalid — returns 402 Payment Required","Rate limit exceeded — returns 429 Too Many Requests","Malformed or out-of-range numeric values — returns 400 with field-level error","Service temporarily unavailable on Vercel — returns 503"],"whenToPreferThis":"Choose this endpoint when a user wants a holistic, top-level view of their financial health rather than a deep-dive into a specific topic (e.g. debt payoff, retirement, or mortgage). It is the ideal starting point before drilling into specialized WealthPulse endpoints, as it surfaces which area deserves the most attention first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:12.637Z","isFirstParty":false}