# TaxMaxi

## Docs

- [Log in to your account — TaxMaxi Auth API](https://docs.taxmaxi.com/api/auth/login.md): Authenticate with TaxMaxi using email and password or an OAuth code. Receive a session token to use on all protected API endpoints.
- [OAuth authentication flow — TaxMaxi Auth API](https://docs.taxmaxi.com/api/auth/oauth.md): Connect a Coinbase account or other OAuth provider to TaxMaxi using the browser redirect flow or a polling flow for CLI and non-browser environments.
- [Authentication API: register, login, OAuth, sessions](https://docs.taxmaxi.com/api/auth/overview.md): Learn how TaxMaxi authentication works: register an account, log in with email/password or OAuth, and manage your session using bearer tokens.
- [Register a new account — TaxMaxi Auth API](https://docs.taxmaxi.com/api/auth/register.md): Create a local TaxMaxi account with email and password, verify your address with a code, and resend verification if the code expires.
- [Session management — TaxMaxi Auth API](https://docs.taxmaxi.com/api/auth/session.md): Retrieve your user profile, refresh your session token before it expires, update your display name, change your password, and log out of TaxMaxi.
- [Legal References API: German crypto tax citations](https://docs.taxmaxi.com/api/legal/overview.md): Retrieve clause-level German crypto tax citations by transaction type or natural language question. Designed for product explainability and AI grounding.
- [Question references — TaxMaxi Legal API](https://docs.taxmaxi.com/api/legal/question.md): Ask a natural language German tax question and receive ranked statutory clause citations. Use for AI grounding or surfacing legal basis in your product.
- [Transaction type references — TaxMaxi Legal API](https://docs.taxmaxi.com/api/legal/transaction-type.md): Retrieve the legal rules and statutory citations that govern a specific crypto transaction type under German tax law, for explainability and AI grounding.
- [List and create sources — TaxMaxi Sources API](https://docs.taxmaxi.com/api/sources/create.md): Retrieve all sources linked to your account, or create a new source from an onchain wallet address — with optional immediate sync on creation.
- [Sources API: create, sync, and calculate tax](https://docs.taxmaxi.com/api/sources/overview.md): Learn how the TaxMaxi Sources API works: add a wallet as a source, sync its transactions, and calculate taxes for a given year and jurisdiction.
- [Sync sources and poll job status — TaxMaxi](https://docs.taxmaxi.com/api/sources/sync.md): Start a sync job to import and normalize transactions for a source, replay normalization from cached data, and poll job status until completion.
- [Calculate tax for a source — TaxMaxi Sources API](https://docs.taxmaxi.com/api/sources/tax.md): Run a jurisdiction-aware tax calculation on a synced source to get taxable gains, losses, tax-free gains, and total income for a given year.
- [Authentication: sessions, OAuth, and token refresh](https://docs.taxmaxi.com/authentication.md): Register a TaxMaxi account, verify your email, log in to get a Bearer token, and learn how to refresh sessions and authenticate via Coinbase OAuth.
- [Coinbase Workflow: Connect, Sync, and Calculate](https://docs.taxmaxi.com/cli/coinbase.md): Use `tax coinbase` to run the full Coinbase workflow in one command, or run each subcommand independently to connect, sync, replay, and calculate taxes.
- [TaxMaxi CLI flags: --json, --no-browser, --force, --year](https://docs.taxmaxi.com/cli/flags.md): Full reference for all global flags supported by the TaxMaxi CLI: `--json`, `--no-browser`, `--force`, and `--year`, with scripting examples.
- [TaxMaxi CLI: Install and Command Overview](https://docs.taxmaxi.com/cli/overview.md): The TaxMaxi CLI lets you connect Coinbase via OAuth, sync transactions, and compute German tax summaries from your terminal or automation pipeline.
- [Jurisdictions: Supported Tax Rules by Country](https://docs.taxmaxi.com/concepts/jurisdictions.md): TaxMaxi currently supports German crypto tax law, including the one-year exemption and FIFO accounting. Learn which events are taxable and which are not.
- [Sources: Connected Accounts and Wallets](https://docs.taxmaxi.com/concepts/sources.md): A source is a connected exchange account or onchain wallet that TaxMaxi syncs and taxes. Learn how to create, reuse, and identify sources.
- [Sync Jobs: Importing and Normalizing Transactions](https://docs.taxmaxi.com/concepts/sync-jobs.md): A sync job fetches raw transaction records from a provider and normalizes them into a canonical format. Learn how to start, poll, and replay sync jobs.
- [Tax Calculation: FIFO gains, losses, and income](https://docs.taxmaxi.com/concepts/tax-calculation.md): Tax calculation runs FIFO-based capital gains and income analysis on a synced source. Learn what each output field means and how to interpret results.
- [TaxMaxi: crypto tax infrastructure for developers](https://docs.taxmaxi.com/introduction.md): TaxMaxi is an API-first platform that turns raw exchange and onchain activity into machine-readable, tax-ready events for fintechs, wallets, and AI agents.
- [Quickstart: make your first TaxMaxi API call](https://docs.taxmaxi.com/quickstart.md): Register a TaxMaxi account, connect a wallet source, trigger a sync, and retrieve a German tax summary — all via the REST API in minutes.
- [Handling errors from the JavaScript SDK](https://docs.taxmaxi.com/sdk/error-handling.md): All TaxMaxi SDK methods throw TaxMaxiError on failure. Inspect the status code, error code tag, requestId, and fieldErrors to handle errors precisely.
- [Installing and configuring the JavaScript SDK](https://docs.taxmaxi.com/sdk/installation.md): Install the taxmaxi package and create a client using an API key, a browser session cookie, or server-side cookie forwarding for SSR frameworks.
- [TaxMaxi JavaScript SDK: Promise and Effect client](https://docs.taxmaxi.com/sdk/overview.md): The official TypeScript client for the TaxMaxi API. Connect sources, run syncs, and compute tax summaries in Node.js or browser environments.
- [Working with sources using the JavaScript SDK](https://docs.taxmaxi.com/sdk/sources.md): List sources, start and poll sync jobs, replay syncs, and compute tax summaries using the TaxMaxi JavaScript SDK's sources resource.