Report Cost Basis on Deposits

Release Details

Release Date: September 21, 2026

Release Type

New feature

Summary

Platforms can now report cost basis on crypto deposits, so that assets transferred in from an external wallet are reported with their true acquisition history rather than an unknown cost basis. Platforms submit one or more acquisition lots against a deposit, each with a quantity and a USD cost basis, and zerohash forwards them for 1099-DA reporting.

Endpoints Impacted

New endpoints were created for this new product release. The deposit_id is the same identifier returned by the existing crypto deposit endpoints.

Endpoints

• POST /deposits/{deposit_id}/lots submit cost-basis lots for a deposit, with a request_id for idempotency and an optional effective_datetime
  • Each lot takes a quantity and a cost_basis in USD, plus an optional acquisition_transaction_datetime
  • Lot quantities must sum exactly to the deposit amount, and only digital assets are supported
• GET /deposits/{deposit_id}/lots retrieve the lots on file for a deposit and their current reporting status
  • Statuses include pending_transaction, ready, pending, reported, failed, and deleted
  • Failures that cannot be retried are prefixed NON_RETRYABLE:, and failures that exhausted the retry budget are prefixed MAX_RETRIES_EXCEEDED:
• DELETE /deposits/{deposit_id}/lots remove the lots on file so that basis can be corrected and resubmitted under a new request_id

Webhooks

No new webhooks were introduced for this release. Reporting status is read through the GET endpoint.

Relevant Documentation

• Report Cost Basis on Deposits