/Agent API Docs

Agent API Reference

Base URL: https://api.fyn.fyi/v1/agent

Authentication

All agent data endpoints require an API key sent as a Bearer token:

Authorization: Bearer fyn_ak_your_key_here

Generate keys at Settings > Agent Access. Key management endpoints (generate, list, revoke, rotate) use FYN JWT auth instead.

Quick Example

curl -s https://api.fyn.fyi/v1/agent/transactions/recent?limit=5 \
  -H "Authorization: Bearer $FYN_API_KEY"

{
  "success": true,
  "data": {
    "transactions": [...]
  },
  "meta": {
    "plan": "free",
    "rateLimit": {
      "remaining": 49,
      "limit": 50,
      "resetAt": "2026-02-05T00:00:00.000Z"
    }
  }
}

Rate Limits

Plan	Daily Calls	RAG Queries	Price
Free	50	10	$0
Pro	2,000	500	$9.99/mo

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. Exceeding the limit returns a 429 with an upgrade URL.

Error Format

{
  "success": false,
  "error": {
    "message": "Daily API limit reached.",
    "code": "RATE_LIMIT_EXCEEDED",
    "upgrade_url": "https://fyn.fyi/upgrade"
  }
}

Status	Code	Description
401	UNAUTHORIZED	Missing or invalid API key
403	FORBIDDEN	Feature not on current plan
404	NOT_FOUND	Resource not found
429	RATE_LIMIT_EXCEEDED	Daily limit reached
500	INTERNAL_ERROR	Server error

Agent API Reference

Authentication

Quick Example

Rate Limits

Error Format

Transactions

Spending

Accounts

Budgets

Subscriptions

Cash Flow

Receipts

Intelligence

Insights

Recommendations

Portfolio

Key Management