Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 2 additions & 37 deletions cli/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ import {
fetchOptionMarks,
fetchQuotes,
computePortfolioPnl,
readBuyingPower,
computeDividends,
computeTradeReview,
addTradeNote,
Expand Down Expand Up @@ -4318,43 +4319,7 @@ program
accts = [String(opts.account)];
}

const results: any[] = [];
for (const acct of accts) {
try {
const bp = await brokerageGetJson(
"https://api.robinhood.com/accounts/{num}/buying_power_breakdown",
{ num: acct },
);
const p = await brokerageGetJson("https://api.robinhood.com/portfolios/{num}/", {
num: acct,
});
const n = (v: unknown) => Number(v);
const equity = n(p.equity);
const marketVal = n(p.market_value);
const marginHealth = marketVal > 0 ? (equity / marketVal) * 100 : Number.NaN;
results.push({
accountNumber: acct,
buyingPower: n(bp.buying_power),
unleveragedBuyingPower: n(bp.unleveraged_buying_power),
intradayBuyingPower: n(bp.intraday_buying_power),
cash: n(bp.cash ?? bp.breakdown?.find((x: any) => x.category === "Cash")?.value ?? 0),
leverageEnabled: bp.leverage_enabled ?? false,
marginTotal:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin total"))
?.value ?? null,
marginUsed:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin used"))?.value ??
null,
excessMaintenance: n(p.excess_maintenance),
excessMargin: n(p.excess_margin),
equity,
marketValue: marketVal,
marginHealthPct: marginHealth,
});
} catch (e) {
results.push({ accountNumber: acct, error: (e as Error).message });
}
}
const results = await readBuyingPower({ accountNumber: opts.account });

if (opts.json) {
printJson(results);
Expand Down
63 changes: 63 additions & 0 deletions cli/src/lib.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3178,6 +3178,69 @@ export interface PortfolioPnlOptions {
top?: number;
}

/**
* Read the broker's regular equity buying-power breakdown and portfolio context.
* These are distinct broker surfaces and not an atomic snapshot: cash is a broker
* cash balance, while buyingPower is the regular equity-order limit. Preserve the
* client receipt time for each surface so a consumer cannot silently compare values
* from different reads or substitute cash for buying power.
*/
export async function readBuyingPower(
opts: { accountNumber?: string } = {},
deps: { getJson?: typeof brokerageGetJson; now?: () => Date } = {},
): Promise<any[]> {
const getJson = deps.getJson ?? brokerageGetJson;
const now = deps.now ?? (() => new Date());
const graph = await getJson("https://bonfire.robinhood.com/transfer/accounts/");
const rows: any[] = Array.isArray(graph?.results)
? graph.results
: Array.isArray(graph)
? graph
: [];
let accounts = rows
.filter((a: any) => (a?.type === "rhs" || a?.type === "ira_roth") && a?.account_number)
.map((a: any) => String(a.account_number));
if (opts.accountNumber) {
if (!accounts.includes(String(opts.accountNumber))) throw new Error(`Account ${opts.accountNumber} not found.`);
accounts = [String(opts.accountNumber)];
}
const n = (v: unknown) => Number(v);
const results: any[] = [];
for (const accountNumber of accounts) {
try {
const bp = await getJson("https://api.robinhood.com/accounts/{num}/buying_power_breakdown", {
num: accountNumber,
});
const buyingPowerAsOf = now().toISOString();
const p = await getJson("https://api.robinhood.com/portfolios/{num}/", { num: accountNumber });
const portfolioAsOf = now().toISOString();
const equity = n(p.equity);
const marketValue = n(p.market_value);
results.push({
accountNumber,
buyingPower: n(bp.buying_power),
unleveragedBuyingPower: n(bp.unleveraged_buying_power),
intradayBuyingPower: n(bp.intraday_buying_power),
cash: n(bp.cash ?? bp.breakdown?.find((x: any) => x.category === "Cash")?.value),
leverageEnabled: bp.leverage_enabled ?? false,
marginTotal:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin total"))?.value ?? null,
marginUsed:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin used"))?.value ?? null,
excessMaintenance: n(p.excess_maintenance),
excessMargin: n(p.excess_margin),
equity,
marketValue,
marginHealthPct: marketValue > 0 ? (equity / marketValue) * 100 : Number.NaN,
asOf: { buyingPowerBreakdown: buyingPowerAsOf, portfolio: portfolioAsOf },
});
} catch (e) {
results.push({ accountNumber, error: (e as Error).message });
}
}
return results;
}

/**
* Composed portfolio P&L across all owned accounts — the SHARED engine for the CLI `portfolio`
* command and the MCP `robinhood_portfolio` tool (single source per the alignment invariant; the CLI
Expand Down
57 changes: 57 additions & 0 deletions cli/test/buying-power-read.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
import { describe, expect, it } from "vitest";
import { readBuyingPower } from "../src/lib.js";

describe("readBuyingPower", () => {
it("keeps broker cash distinct from regular buying power and records each endpoint as-of", async () => {
const instants = [
new Date("2026-09-11T13:04:00.000Z"),
new Date("2026-09-11T13:04:00.125Z"),
];
let i = 0;
const getJson = async (url: string, params: Record<string, string> = {}) => {
if (url.includes("transfer/accounts")) {
return { results: [{ type: "ira_roth", account_number: "11112222" }] };
}
if (url.includes("buying_power_breakdown")) {
expect(params.num).toBe("11112222");
return {
buying_power: "101.25",
unleveraged_buying_power: "101.25",
intraday_buying_power: "0",
cash: "102.50",
leverage_enabled: false,
};
}
if (url.includes("portfolios/")) {
expect(params.num).toBe("11112222");
return {
equity: "10000.50",
market_value: "10000.50",
excess_maintenance: "0",
excess_margin: "0",
};
}
throw new Error(`unexpected URL ${url}`);
};

const result = await readBuyingPower(
{ accountNumber: "11112222" },
{ getJson, now: () => instants[i++] },
);

expect(result).toHaveLength(1);
expect(result[0]).toMatchObject({
accountNumber: "11112222",
buyingPower: 101.25,
unleveragedBuyingPower: 101.25,
intradayBuyingPower: 0,
cash: 102.5,
equity: 10000.5,
asOf: {
buyingPowerBreakdown: "2026-09-11T13:04:00.000Z",
portfolio: "2026-09-11T13:04:00.125Z",
},
});
expect(result[0].cash).not.toBe(result[0].buyingPower);
});
});
60 changes: 3 additions & 57 deletions mcp/src/server.ts
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@ import {
computeOptionExposureAnalytics,
calendarDaysUntil,
computePortfolioPnl,
readBuyingPower,
getUnifiedHistory,
computeDividends,
computeTradeReview,
Expand Down Expand Up @@ -1343,63 +1344,8 @@ server.registerTool(
}),
annotations: toolAnnotations(true, "sensitive-read"),
},
async ({ account_number }) => {
const graph = await brokerageGetJson("https://bonfire.robinhood.com/transfer/accounts/");
const rows: any[] = Array.isArray(graph?.results)
? graph.results
: Array.isArray(graph)
? graph
: [];
let accts: string[] = [];
for (const a of rows) {
if (a?.type !== "rhs" && a?.type !== "ira_roth") continue;
if (!a.account_number) continue;
accts.push(String(a.account_number));
}
if (account_number) {
if (!accts.includes(String(account_number)))
throw new Error(`Account ${account_number} not found.`);
accts = [String(account_number)];
}
const results: any[] = [];
for (const acct of accts) {
try {
const bp = await brokerageGetJson(
"https://api.robinhood.com/accounts/{num}/buying_power_breakdown",
{ num: acct },
);
const p = await brokerageGetJson("https://api.robinhood.com/portfolios/{num}/", {
num: acct,
});
const n = (v: unknown) => Number(v);
const equity = n(p.equity);
const marketVal = n(p.market_value);
const marginHealth = marketVal > 0 ? (equity / marketVal) * 100 : Number.NaN;
results.push({
accountNumber: acct,
buyingPower: n(bp.buying_power),
unleveragedBuyingPower: n(bp.unleveraged_buying_power),
intradayBuyingPower: n(bp.intraday_buying_power),
cash: n(bp.cash ?? bp.breakdown?.find((x: any) => x.category === "Cash")?.value ?? 0),
leverageEnabled: bp.leverage_enabled ?? false,
marginTotal:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin total"))
?.value ?? null,
marginUsed:
bp.breakdown?.find((x: any) => x.title?.toLowerCase().includes("margin used"))?.value ??
null,
excessMaintenance: n(p.excess_maintenance),
excessMargin: n(p.excess_margin),
equity,
marketValue: marketVal,
marginHealthPct: marginHealth,
});
} catch (e) {
results.push({ accountNumber: acct, error: (e as Error).message });
}
}
return jsonResponse(results);
},
async ({ account_number }) =>
jsonResponse(await readBuyingPower({ accountNumber: account_number })),
);

// ── robinhood_buy: simple market/limit order — matching the CLI `buy` command ──
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
"@types/node": "^20.19.43",
"@typescript-eslint/eslint-plugin": "^8.64.0",
"@typescript-eslint/parser": "^8.64.0",
"@vitest/coverage-v8": "^4.1.10",
"@vitest/coverage-v8": "^4.1.11",
"eslint": "^10.7.0",
"knip": "^6.26.0",
"prettier": "^3.9.5",
Expand Down
Loading
Loading