FYNFYN
Built for AI Agents

Your Agent's
Financial Brain

28 endpoints. One API key. Give your AI agent real-time access to bank transactions, receipts, budgets, and spending intelligence.

Get Your API Key — FreeView API Docs
user:How much did I spend on food this month?
POST /v1/agent/spending/breakdown {"group_by":"category","start_date":"2026-03-01"}
agent:You've spent $529.68 on food — $342.18 on groceries and $187.50 on dining out. Dining is up 23% from last month.
user:What's my financial health score?
GET /v1/agent/insights/health
agent:Your financial health score is 72/100 (B). Savings rate is solid at 12%, but subscription costs are high at $127/mo. Top recommendation: cancel unused streaming services to boost your score.

Set Up in 3 Minutes

Install the skill in your agent, connect your bank, and start asking questions.

1

Install the Skill

ClawHubRecommended
clawhub install fyn-finance

Works with OpenClaw and compatible agents

Claude Code
mkdir -p ~/.claude/skills/fyn-finance
curl -sL https://raw.githubusercontent.com/
fynfyi/agent-skill/main/SKILL.md \
-o ~/.claude/skills/fyn-finance/SKILL.md

Or use as a project skill in .claude/skills/

Manual / GitHub
git clone https://github.com/
fynfyi/agent-skill.git

Copy SKILL.md into any agent's skill directory. Works with Agent Skills compatible tools.

2

Connect Your Accounts

  1. a.Sign up at fyn.fyi (free tier available)
  2. b.Connect your bank accounts via Plaid (read-only access)
  3. c.Wait for transactions to sync (usually under 60 seconds)
3

Generate Your API Key

  1. a.Go to Settings > Agent Access
  2. b.Click New Key and copy the key (shown once)
  3. c.Set it in your environment:
export FYN_API_KEY=fyn_ak_your_key_here

What You Can Ask

Your agent understands natural language. Here are some examples.

Spending
“How much did I spend on groceries this month?”
“Show my spending breakdown by category”
“Compare this month vs last month”
Accounts & Budgets
“What's my checking balance?”
“What's my net worth?”
“Am I over budget on anything?”
Insights & Health
“Give me my daily financial briefing”
“What's my financial health score?”
“Where can I save money?”
Receipts & Intelligence
“Search my receipts for "laptop"”
“Can I afford a $500 purchase?”
“Any cheaper alternatives for things I buy?”

28 Endpoints. One API Key.

Free tier gets you started. Pro unlocks receipt AI and affordability checks.

Transactions

Query, filter by merchant/category, spending totals

2 endpoints
Spending

Breakdown by category, compare periods, discretionary analysis

3 endpoints
Accounts

Balances, individual accounts, net worth

3 endpoints
Budgets

Status across categories, over-budget alerts

2 endpoints
Subscriptions

Recurring charges, monthly subscription cost

2 endpoints
Cash Flow

Income vs expenses, savings rate

2 endpoints
Insights

Daily briefing, alerts, health score, weekly recap, natural language Q&A

6 endpoints
Portfolio

Holdings, total value, allocation breakdown

2 endpoints
ReceiptsPro

AI-powered search, RAG chat, price insights, deals

4 endpoints
IntelligencePro

Affordability checks, product recommendations

2 endpoints
Full API documentation with request/response examples

Quick Test

Verify your key works with a single curl command.

curl -s https://api.fyn.fyi/v1/agent/accounts/net-worth \
  -H "Authorization: Bearer $FYN_API_KEY" | jq .
{
  "success": true,
  "data": {
    "net_worth": 47250.83,
    "assets": 52100.00,
    "liabilities": 4849.17,
    "accounts": 4
  },
  "meta": {
    "plan": "free",
    "rateLimit": { "remaining": 49, "limit": 50 }
  }
}

Rate Limits

PlanDaily CallsRAG Queries
Free5010
Pro $9.99/mo2,000500

Security

API keys hashed at rest (SHA-256) — plaintext shown once
Read-only bank access via Plaid — FYN never moves money
All data scoped to your account — agents see only your finances
Keys instantly revocable from Settings
All traffic encrypted over HTTPS

Works Everywhere

FYN follows the open Agent Skills standard. Use it with any compatible tool.

OpenClawOpenClawClaude CodeCursorGemini CLI
Goose
Roo Code
Any HTTP Client
View on GitHub

Ready to Connect Your Agent?

Free tier includes 50 API calls/day. No credit card required.

Get Started FreeAPI Documentation