The official AI agent skill for FYN — personal finance with bank syncing, receipt AI, and spending intelligence.
This is a ClawHub skill package that lets any AI agent (OpenClaw, Clank, or any agent with HTTP tools) access your personal financial data through FYN.
Your agent can:
- Query bank transactions and spending patterns
- Check account balances and net worth
- Monitor budgets and subscriptions
- Get daily briefings, alerts, and financial health scores
- Ask natural language questions about your finances
- Search receipts with AI (Pro)
- Check affordability of purchases (Pro)
- Get price insights, find better deals, and product recommendations (Pro)
clawhub install fyn-financeOr manually: copy SKILL.md into your agent's skill directory.
- Sign up at fyn.fyi (free)
- Connect your bank accounts via Plaid
- Generate an API key at Settings > Agent Access
- Set
FYN_API_KEYin your agent's environment
export FYN_API_KEY=fyn_ak_your_key_here- Ask your agent about your finances:
"How much did I spend on groceries this month?" "What's my net worth?" "Am I over budget on anything?"
All endpoints use https://api.fyn.fyi/v1/agent as the base URL.
| Endpoint | Method | Description |
|---|---|---|
/transactions/recent |
GET | Recent transactions |
/transactions/sum |
POST | Total spending for a period |
/spending/breakdown |
POST | Spending by category/merchant |
/spending/compare |
POST | Compare two time periods |
/spending/discretionary |
POST | Discretionary vs. essential |
/accounts/balances |
GET | All account balances |
/accounts/balance |
GET | Single account balance |
/accounts/net-worth |
GET | Net worth |
/budget/status |
GET | Budget status |
/budget/over |
GET | Over-budget categories |
/subscriptions |
GET | Detected subscriptions |
/subscriptions/total |
GET | Total subscription cost |
/cashflow |
GET | Cash flow summary |
/cashflow/savings-rate |
GET | Savings rate |
/portfolio |
GET | Portfolio summary |
/holdings |
GET | Individual holdings |
/insights/daily |
GET | Daily financial briefing |
/insights/alerts |
GET | Active anomalies & warnings |
/insights/opportunities |
GET | Money-saving suggestions |
/insights/weekly |
GET | Weekly financial recap |
/insights/health |
GET | Financial health score (0-100) |
/insights/ask |
POST | Natural language insight query |
/recommendations |
GET | Product recommendations with savings |
| Endpoint | Method | Description |
|---|---|---|
/receipts/search |
POST | Search receipt line items |
/receipts/rag |
POST | Chat with receipts (RAG) |
/receipts/insights |
POST | Price insights |
/receipts/deals |
GET | Find better deals |
/affordability |
POST | Affordability check |
| Plan | Daily Calls | Receipt RAG Queries |
|---|---|---|
| Free | 50 | 10 |
| Pro | 2,000 | 500 |
See the examples/ directory:
- basic-query.md — Transactions, spending breakdown, balances
- receipt-search.md — Receipt AI search, RAG, price insights
- budget-check.md — Budgets, affordability, subscriptions
All requests require an API key:
Authorization: Bearer fyn_ak_your_key_here
Generate keys at fyn.fyi/settings/agent-access.
- FYN Homepage
- Agent Landing Page
- API Documentation
- SKILL.md — Full skill definition
MIT