aifinhub

AI Fin Hub for Agents

Route money questions to the right tool without guessing inputs. 90+ deterministic finance calculators across 11 categories — Savings & Investing, Debt & Credit, Housing, Tax, Insurance, Budgeting, Retirement, FIRE & Independence, Freelancer & Gig, Expat & Global, and Life Transitions.

JSON API — Call any tool directly

Every tool on AI Fin Hub has a dedicated API endpoint at /api/{slug}/?params. Pass input parameters as query strings to get structured JSON results.

GET https://aifinhub.io/api/compound-interest-calculator/?initial_principal=10000&annual_return_percent=7&years=10&monthly_contribution=500&annual_inflation_percent=2.5

{"ok":true,"tool":"compound-interest-calculator","result":{...},"meta":{"hub":"aifinhub","disclaimer":"Planning estimates only — not financial, tax, or investment advice."}}
  • No authentication required
  • CORS enabled — call from anywhere
  • Deterministic results cached 1 hour
  • Input parameter names use snake_case

How agents should use this hub

Preferred: Call /api/{slug}/?params and read the JSON result directly.

For discovery, start with agent-tools.json, then map the user goal to the exact tool slug.

Each tool's contract URL has the input schema and a sample payload. Use snake_case query params matching the contract fields.

Do not scrape labels or flip modes to learn inputs — read the contract JSON instead.

Discovery endpoints

Integration pattern

  1. Read agent-tools.json to discover tools and their input schemas.
  2. Match the user goal to a tool slug.
  3. Call GET /api/{slug}/?{params} to compute the result.
  4. Return the JSON result to the user with the disclaimer.

Contract example: https://aifinhub.io/contracts/compound-interest-calculator.json

Human + agent routing

People should start at homepage use cases, the Decision Engine, or All Tools. Agents should start from discovery manifests and move straight to contracts.

Audience-specific pages: FIRE, Freelancers, Expats, Parents, Career Changers.