Build a personal finance dashboard with the Yoshi API

Build a dashboard that shows a user’s linked accounts, recent transactions, financial health scores, and recurring bills — all from a single API key.

Fetch the overview

Start with GET /me/summary to get accounts, scores, and goals in one call:

import Yoshi from "@yoshi-ai/sdk";

const yoshi = new Yoshi();

const summary = await yoshi.me.summary();

console.log("Accounts:", summary.accounts.total);
console.log("Yoshi Score:", summary.scores?.yoshi);
console.log("Active Goals:", summary.goals.length);

from yoshi import Yoshi

yoshi = Yoshi()

summary = yoshi.me.summary()

print(f"Accounts: {summary.accounts.total}")
print(f"Yoshi Score: {summary.scores.yoshi if summary.scores else 'N/A'}")
print(f"Active Goals: {len(summary.goals)}")

This single call replaces three separate requests to /accounts, /scores, and /goals.

List recent transactions

Fetch the latest transactions across all accounts:

const page = await yoshi.transactions.list({ limit: 20 });

for (const tx of page.data) {
  const direction = tx.cash_flow_direction === "outflow" ? "-" : "+";
  console.log(`${direction}$${tx.amount_absolute} ${tx.counterparty_name}`);
}

page = yoshi.transactions.list(limit=20)

for tx in page.data:
    direction = "-" if tx.cash_flow_direction == "outflow" else "+"
    print(f"{direction}${tx.amount_absolute} {tx.counterparty_name}")

Filter by account to show transactions for a specific card or bank account:

curl "https://api.yoshi.ai/transactions?account_id=acc_abc123&limit=10" \
  -H "Authorization: Bearer yoshi_YOUR_KEY"

Show balance history

Plot account balances over time with the balance series endpoint:

const balances = await yoshi.accounts.balanceSeries.list("acc_abc123", {
  days: 30,
});

for (const point of balances.points) {
  console.log(`${point.date}: $${point.balance}`);
}

balances = yoshi.accounts.balance_series.list("acc_abc123", days=30)

for point in balances.points:
    print(f"{point.date}: ${point.balance}")

Add recurring streams

Show subscriptions, bills, and income streams:

const recurring = await yoshi.recurring.list();

const bills = recurring.streams.filter(
  (s) => s.direction === "outflow" && s.is_active
);
const income = recurring.streams.filter(
  (s) => s.direction === "inflow" && s.is_active
);

console.log(`${bills.length} active bills, ${income.length} income streams`);

recurring = yoshi.recurring.list()

bills = [s for s in recurring.streams if s.direction == "outflow" and s.is_active]
income = [s for s in recurring.streams if s.direction == "inflow" and s.is_active]

print(f"{len(bills)} active bills, {len(income)} income streams")

Caching strategy

Not all data changes at the same rate:

Resource	Cache duration	Why
Accounts metadata	5–15 minutes	Names and types rarely change
Balances	Do not cache	Changes with every sync
Transactions	1–5 minutes	New transactions arrive periodically
Scores	1 hour	Recalculated daily
Recurring streams	1 hour	Updated infrequently

Use webhooks instead of polling. Subscribe to transaction.created and balance.updated events to refresh your dashboard in real time.

Polling vs webhooks

For a simple dashboard, poll on a timer:

setInterval(async () => {
  const summary = await yoshi.me.summary();
  updateUI(summary);
}, 60_000); // every 60 seconds

For real-time updates, register a webhook endpoint and listen for events:

app.post("/webhooks/yoshi", async (req, res) => {
  const event = req.body;

  if (event.type === "transaction.created") {
    await refreshTransactions(event.data.account_id);
  } else if (event.type === "balance.updated") {
    await refreshBalances(event.data.account_id);
  }

  res.sendStatus(200);
});

Handle pending transactions

Transactions can arrive in a pending state before they post:

const page = await yoshi.transactions.list({ limit: 50 });

const posted = page.data.filter((tx) => !tx.pending);
const pending = page.data.filter((tx) => tx.pending);

Pending transactions may change amount, date, or even disappear before posting. Always use the transaction id for deduplication — don’t rely on amount or description matching.

Getting Started

Reference

SDKs

Concepts

Webhooks

Use Cases

Tools

Resources

Build a personal finance dashboard with the Yoshi API

Fetch the overview

List recent transactions

Show balance history

Add recurring streams

Caching strategy

Polling vs webhooks

Handle pending transactions

What’s next

Webhooks

Data freshness

​Fetch the overview

​List recent transactions

​Show balance history

​Add recurring streams

​Caching strategy

​Polling vs webhooks

​Handle pending transactions

​What’s next

Webhooks

Data freshness

Fetch the overview

List recent transactions

Show balance history

Add recurring streams

Caching strategy

Polling vs webhooks

Handle pending transactions

What’s next