Skip to main content
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

All sources endpoints are under the /v1 prefix.

​
Authentication

Include your session token in the Authorization header on every request that requires authentication:
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

​
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.