Introduction

The IndepAI API provides comprehensive tools for building financial independence (FIRE) applications. Whether you’re creating a personal finance app, a FIRE calculator, or a geo-arbitrage planning tool, our API has you covered.

What You Can Build

Financial Independence

FI Score - Calculate your financial independence score and timeline
AI Coach - Get personalized AI-powered financial guidance
Portfolio Health - Get a 0-1000 health score for any investment portfolio
Notifications - Stay informed about portfolio changes and milestones

Geo-Arbitrage

Public Cities - Browse and compare cost of living across 100+ cities worldwide
City Recommendations - AI-powered city suggestions based on your preferences

API Design Principles

The IndepAI API is built with these principles in mind:

Simplicity - Clean, intuitive endpoints that do one thing well
Consistency - Predictable patterns across all endpoints
Security - JWT authentication, rate limiting, and input validation
Documentation - OpenAPI spec and interactive docs for every endpoint
Performance - Fast response times with intelligent caching

Base URL

All API requests are made to:

https://indepai.app/api/v1/

For development:

http://localhost:3000/api/v1/

Response Format

All responses follow a consistent format:

Success Response

{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "1.0"
  }
}

Error Response

{
  "success": false,
  "error": "Validation error",
  "code": "VALIDATION_ERROR",
  "details": [
    {
      "path": "currentAge",
      "message": "Must be between 18 and 100"
    }
  ]
}