buildAllTxnsUrl
ChatGPTBuild a browser link for the selected user. Read dataModel from getTaxInfo first. For v1 use txnType, txnHash and currency side/symbols; the URL uses /all-transactions. For v2 use type, hash and currency currency/direction (the getTransactions filterQuery fields supplied at the top level); the URL uses /all-transfers. Supply only filters for the target model.
createTransactions
ChatGPTCreate 1 to 50 manual TokenTax transactions only when the user explicitly asks to record specific transactions, never on your own initiative. Requires data model v2; non-admin users need a paid plan. Saves the entire batch immediately with per-transaction audit history; a failed batch saves nothing. Supply timestamps, classifications, transfers, and their accounts using verified records. movement, bridge, incoming, outgoing transactions are unsupported; use mergeTransactions for movements or bridges between existing transactions. Returns created transactions and audit IDs in input order, with applied=true on success. Creation does not run recalculation. After an uncertain response, check getTransactions before retrying to avoid duplicates.
editTransaction
ChatGPTCorrect an existing TokenTax transaction and its transfers only when the user explicitly asks for a specific correction, never on your own initiative. Requires data model v2; non-admin users need a paid plan. Changes are applied immediately and saved in edit history. Read the transaction with getTransactions first. Supply the complete desired transfer list, including unchanged legs and fees; omitted existing transfers are soft-deleted. Editing movement, bridge, incoming, outgoing transactions or transactions involving Spec ID is unsupported. Use mergeTransactions for movements or bridges between existing transactions. Returns the transaction, edit ID, status, and applied flag. After an uncertain response, reread the transaction before retrying.
getAccountsAndCredentials
ChatGPTReturns non-external accounts in accounts and external accounts in externalAccounts, each with active credentials nested in a credentials array, plus unassignedCredentials for active data sources without an account. Accounts group activity for tax lot tracking; credentials identify API connections, CSV imports or wallet sources, and several credentials can belong to one account. Includes creation/update dates, sync status, last sync attempt and success, and imported activity metadata. startDate/endDate are configured date boundaries; earliestTransaction/latestTransaction describe date-eligible imported activity. Account and credential addresses and integrations may differ. calculationSettings describes whether and when tax lot calculations use separate accounts. External accounts represent entities the user does not directly control, such as an on-chain staking pool, or user-controlled accounts not synced to TokenTax, such as a cold storage wallet with no taxable activity. They track movements of cryptocurrency and its existing tax lots so the same cost basis can be followed when funds return. An external account does not imply ownership or control of its address, and its external flag does not determine tax treatment.
getLineItems
ChatGPTRead calculated taxable line items from the tax dashboard, for v1 or v2. Use for actual disposal cost basis, proceeds and realized gain/loss instead of estimating from getTransactions prices. Uses the active successful calculation, with dashboard filters, sort behavior and pagination. Excludes like-kind crypto trades, as the dashboard does. Does not run accounting or change data. Each row is a calculated line item, not a whole sale: several rows can belong to one disposal. Aggregate all relevant pages by sellId (v1) or outgoingId (v2) for a disposal total; use getTransactions to look up the transfer-group IDs for whole-transaction totals. A largest line-item gain is not necessarily the largest sale gain. Monetary output is in report currency (USD when fiatCurrency is null), including fee adjustments; do not apply the fee components again. V1 sellId/buyId reference transactions; v2 outgoingId/incomingId reference transfers. Historical links/snapshots can be missing or refer to deleted records. txnHash is the sale transaction hash (v1: GraphQL txnLineItemSellIdTotxn.blocksvcHash; v2: outgoing transfer snapshot). Hashes can be missing or shared by multiple rows; use transaction/transfer IDs for matching. Returns report metadata and needsRecalculation; null means freshness is unavailable. Results may predate edits or a pending/failed job; getTaxInfo supplies latest job status. An unavailable report is distinct from an available report with zero matching rows. Non-admins require a paid plan for the requested year.
getMissingCostBasis
ChatGPTGet line items with missing cost basis for a given tax year. Use getLineItems for calculated taxable line items regardless of whether basis is missing. Returns sell date, currency, units sold, proceeds, and associated account info. Results are paginated — check totalCount and page to determine if more pages exist. Results come from the active successful calculation and may not reflect recent edits or a pending/failed recalculation.
getRunningBalance
ChatGPTGet running balances using the selected user's data model, aggregated overall and by account when available. For v2 users, transfer account assignments take precedence over credential accounts. Negative dates are investigation leads. By default returns only negative balance dates; set includeAllEntries for the full paginated history.
getTaxInfo
ChatGPTReturns tax settings and dashboard summary figures for each tax year associated with the user. Use getLineItems for the calculated taxable line items underlying disposal basis and realized gain/loss. Results are returned in columnar format (columns + rows). Fields: taxYear (number), filingMethod (e.g. FIFO/LIFO/Minimization), shortTermTaxRate (float), longTermTaxRate (float), state (e.g. "NY"), allowedFilingMethods lists the cost basis methods supported by each tax year's country; choose from this list for updateTaxInfo. dashboardIncome (float — calculated by the TokenTax app from the user's actual transactions), dashboardShortTermGains (float — calculated by the app), dashboardLongTermGains (float — calculated by the app), estimatedPnL (string — user-provided estimate entered during VIP onboarding, e.g. "$12,441"; not a calculated value). Also returns dataModel (v1 or v2) for the selected user; use it to choose transaction filters and reference instructions. Also returns recalculation: latestJob (null if none for the current data model), activeJobId, needsRecalculation, and unavailableReason. latestJob includes id, stored status, createdAt, finishedAt, error, and errorMessage. Status created means queued or running; completed and failed are terminal. Unknown or null statuses are preserved. latestJob is the most recently submitted job for the current data model. This tool only reads status; it does not start recalculation. activeJobId identifies the successful calculation supplying the dashboard figures, or is null if none exists. It can differ from latestJob.id, even when that job completed. needsRecalculation checks edits and dirty reports for the active calculation; null means the check is unavailable (see unavailableReason). Job completion alone does not mean the figures include subsequent edits. Use updateTaxInfo to change filingMethod, shortTermTaxRate, or longTermTaxRate for an unlocked existing tax year when requested. Rates are decimals (0.25 means 25%). After an update, dashboard figures will remain stale until a fresh recalculation runs. Numeric fields show "-" instead of a number when the user has no paid plan for that year (distinct from $0).
getTlhTaxLots
ChatGPTReturns individual tax lots eligible for tax-loss harvesting, including unrealized gain/loss, account, date acquired, and time to long-term status. Uses the latest available minimization report in the active calculation and the tax rates for its report year. By default returns the 20 lots with the largest unrealized losses (most impactful for harvesting). Pass gainLoss="gain" to see gain lots, or increase pageSize to see more results.
getTransactions
ChatGPTQuery the selected user's All Transactions data. Call getTaxInfo first to read dataModel. For v1, use txnType, txnHash, currency side/symbols and sortBy=txnTimestamp (default). For v2, use type, hash, currency currency/direction and sortBy=timestampMin (default). V2 results contain transfer groups with all active legs in a nested transfers table; filters select whole groups. Accounts are tax lot pools and credentials are data sources. Integration IDs are on individual v2 transfers. Transaction prices are not calculated disposal basis or realized gain/loss. Use getLineItems for those report results. Use only filters and sort fields for the target model; incompatible arguments are rejected.
getTxnPreview
ChatGPTPreview an on-chain transaction in the selected user's data model. Legacy users receive transaction fields and rawTxn; v2 users receive transfer groups with incoming, outgoing and fee transfers plus rawData. Initial classification is before pricing and reconciliation. Not all integrations support previews.
hypotheticalTrade
ChatGPTSimulates selling all (or a specific account's) lots of a given token at today's current market price. Fetches the live FMV and calculates the magnitude of the unrealized gain or loss that would be realized. Uses the latest available minimization report in the active calculation and the tax rates for its report year. Use this after identifying a candidate position with getTlhTaxLots.
mergeTransactions
ChatGPTCombine two existing TokenTax transactions into one movement or bridge only when the user explicitly asks to merge them, never on your own initiative. Use for the evidenced withdrawal and deposit sides of a transfer between different accounts, not trades or speculative matches. Requires data model v2; non-admin users need a paid plan. Inspect both transactions with getTransactions first. The merge applies immediately: the outbound group survives and the inbound group is soft-deleted. Returns the surviving transaction, merge history ID, status, and applied flag. Merging does not run recalculation. After an uncertain response, reread both transactions before retrying.
reconcileEvmTxn
ChatGPTFetch on-chain evidence and reconciliation instructions in the selected user's data model. Follow the correction format returned by this tool: transaction corrections for legacy users, group and transfer corrections for v2 users.
reconcileSolanaTxn
ChatGPTFetch on-chain evidence and reconciliation instructions in the selected user's data model. Follow the correction format returned by this tool: transaction corrections for legacy users, group and transfer corrections for v2 users.
startRecalculation
ChatGPTSubmit a recalculation using the selected user's current data model and saved tax settings, as in the web app. This tool does not change settings or accept a year/method override - that info is determined by the existing user settings (found in getTaxInfo) Rejects the request if the user's latest nondeleted recalculation job is queued or running, across both data models, as in the web app. Returns userId, dataModel, and jobId after queue submission. Submission does not mean the calculation has completed (recalculations may take minutes to complete).
updateTaxInfo
ChatGPTChanges the cost basis method and/or short-term and long-term capital gains tax rates for one existing, unlocked tax year. Use when requested by the user; choose from allowedFilingMethods returned by getTaxInfo for that year. Rates are nonnegative decimals (0.25 means 25%). Omitted settings stay unchanged. Edits are blocked during reconciliation mode, including for admins. Saves settings only. When the user requests recalculation, use startRecalculation with the saved settings, or recalculate in the web app. Submission does not mean completion; getTaxInfo returns recalculation status. Only poll when the user asks to monitor or wait for recalculation.