April 2026
v1.0 — Initial public API release
The Yoshi consumer API is now publicly available. This release includes: Core data endpoints:GET /accounts— List linked financial accounts with balancesGET /accounts/{id}/balances— Historical daily balance seriesGET /transactions— List transactions with cursor-based paginationGET /scores— Financial health scores (Yoshi, Recovery, Capacity, Baseline)GET /goals— Financial goals and progressGET /recurring— Recurring streams (subscriptions, bills, income)GET /investments— Investment holdings grouped by asset classGET /income— Income analysis and distributionGET /me— User profileGET /me/summary— Comprehensive financial overview
GET /benefits/summary— Active card benefit periods with usageGET /benefits/expiring— Benefits expiring within a configurable window
POST /paper-trading/accounts— Create virtual trading accountsGET /paper-trading/accounts— List paper trading accountsPOST /paper-trading/accounts/{id}/trades— Place simulated tradesGET /paper-trading/accounts/{id}/holdings— Current positionsGET /paper-trading/accounts/{id}/trades— Trade history
POST /actions— Create action proposalsGET /actions— List actionsGET /actions/{id}— Retrieve single actionGET /approvals/{threadId}— Check approval status
- Real-time event delivery for transaction, balance, account, investment, score, income, and recurring changes
- HMAC-SHA256 signature verification
- Self-service portal for endpoint management
- TypeScript (
@yoshi-ai/sdk) - Python (
yoshi-sdk) - Go (
github.com/yoshi-ai-dev/yoshi-go)
yoshiCLI via Homebrew or Go install
- Unkey-based API key authentication with
yoshi_prefix - Cursor-based pagination
- RFC 9457-inspired error envelope
- 100 requests/minute rate limiting per key
Idempotency-Keysupport on mutating endpoints
Future updates will be listed here in reverse chronological order. Breaking changes will include migration guidance.