Skip to content
QeychainQeychain API

Generate Tax Report

POST
/api/v1/wallets/{address}/tax-reports/generate
curl --request POST \
  --url 'https://api.qeychain.xyz/api/v1/wallets/example/tax-reports/generate?tax_year=1&report_type=full&format=json&taxpayer_timezone=America%2FNew_York'

Generate tax report asynchronously for large wallets.

Returns a job_id that can be polled via GET /api/v1/jobs/{job_id}

Parameters:

  • report_type: Type of report (full, 8949, schedule-1, summary)
  • format: Output format (json, csv, pdf)

Response:

  • job_id: Unique identifier for the job
  • poll_url: URL to poll for status updates

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
address
required
Address
string

Query Parameters

Section titled “Query Parameters”
tax_year
required
Tax Year

Tax year (required)

integer

Tax year (required)

report_type
Report Type

Report type: full, 8949, schedule-1, summary

string
default: full

Report type: full, 8949, schedule-1, summary

format
Format

Output format: json, csv, pdf

string
default: json

Output format: json, csv, pdf

taxpayer_timezone
Taxpayer Timezone
string
default: America/New_York
owned_wallets
Any of:
Array<string>

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Response Generate Tax Report Api V1 Wallets Address Tax Reports Generate Post
object
key
additional properties
any
Examplegenerated
{}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}