Skip to content
QeychainQeychain API

Get Tax Summary

GET
/api/v1/tax-reports/{address}/summary
curl --request GET \
  --url https://api.qeychain.xyz/api/v1/tax-reports/example/summary

Get tax summary for a wallet address.

Returns realized gains/losses, income, and disposal counts filtered by tax year if specified.

Response Format:

{
  "success": true,
  "data": {
    "address": "0x...",
    "total_realized_gl": "1500.00",
    "short_term_gains": "2000.00",
    ...
  },
  "meta": {...}
}

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
address
required
Address
string

Query Parameters

Section titled “Query Parameters”
tax_year
Any of:
integer

Tax year to filter (e.g., 2024). If not provided, returns all-time.

owned_wallets
Any of:
Array<string>

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Response Get Tax Summary Api V1 Tax Reports Address Summary Get
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"
    }
  ]
}