/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": 499,
      "limit": 500,
      "resetAt": "2026-02-05T00:00:00.000Z"
    }
  }
}

Rate Limits

Plan	Daily Calls	RAG Queries	Price
Free	500	50	$0
Pro	Unlimited	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	—	No Authorization header. Body is `{"message":"Unauthorized"}`
403	—	Key invalid, revoked or expired. Body is `{"message":"Forbidden"}`
404	—	Unknown route. Body is `{"message":"Not Found"}`
429	RATE_LIMIT_EXCEEDED	Daily limit reached
500	—	Server error

Agent API Reference

Authentication

Quick Example

Rate Limits

Error Format

Transactions

Spending

Accounts

Budgets

Subscriptions

Cash Flow

Receipts

Intelligence

Insights

Portfolio

Key Management