Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.taxmaxi.com/llms.txt

Use this file to discover all available pages before exploring further.

The TaxMaxi Sources API lets you connect onchain wallets, sync their transaction history, and run tax calculations against the normalized data. A source represents a single wallet address. Once you create a source, you kick off a sync job to import raw transaction records from the blockchain and normalize them into a consistent format. When the sync is complete, you can request a tax calculation for any supported jurisdiction and year. Most endpoints require a bearer token — pass it as Authorization: Bearer <token> on every protected request.

​
Base URL

https://api.taxmaxi.com
All sources endpoints are under the /v1 prefix.

​
Authentication

Include your session token in the Authorization header on every request that requires authentication: 
Authorization: Bearer <token>
POST /v1/sources is the only endpoint that accepts unauthenticated requests. When you call it without credentials, the API creates an anonymous source and returns a claim token you can use to associate that source with an account later.

​
Workflow

1

Create a source

Call POST /v1/sources with a wallet address. Pass sync: true to start a sync immediately, or trigger it separately.
2

Sync the source

Call POST /v1/sources/:sourceId/sync to import and normalize transactions. Poll GET /v1/sources/:sourceId/jobs/:jobId until the job status reaches completed or failed.
3

Calculate tax

Once the sync is complete, call POST /v1/sources/:sourceId/tax with a year and jurisdiction to get your tax summary.

​
Endpoint reference

MethodPathAuth requiredDescription
GET/v1/sourcesYesList all sources for your account
POST/v1/sourcesNoCreate or reuse a source
POST/v1/sources/:sourceId/syncYesStart a sync job for a source
POST/v1/sources/:sourceId/replayYesReplay normalization from cached raw data
GET/v1/sources/:sourceId/jobs/:jobIdYesPoll the status of a sync job
POST/v1/sources/:sourceId/taxYesCalculate tax for a completed source

​
Pages in this section

Create

List your sources or create a new one from a wallet address.

Sync

Start a sync job, replay normalization, and poll job status.

Tax

Calculate taxable gains, losses, and income for a source.