Skip to content
QeychainQeychain API

Get Transactions

GET
/api/v1/wallets/{address}/transactions
curl --request GET \
  --url 'https://api.qeychain.xyz/api/v1/wallets/example/transactions?page=1&per_page=50&hide_spam=true&sort_by=timestamp&sort_order=desc&include_lineage=false&include_tax_impact=false'

Get paginated transaction history with advanced filters.

Filters:

  • type: Filter by transaction type (swap, send, receive, stake, etc.)
  • chain: Filter by blockchain network
  • from_date / to_date: Date range filter
  • hide_spam: Hide spam/trash transactions (default true)
  • asset: Filter by asset symbol(s), comma-separated

Sorting:

  • sort_by: timestamp (default), value_usd, fee_usd
  • sort_order: desc (default), asc

Optional data:

  • include_lineage: Include source/destination lots for each transaction
  • include_tax_impact: Include realized gains/losses for taxable transactions

Response includes:

  • tx_hash, timestamp, type, chain
  • from_asset, to_asset, quantity, value_usd, fee_usd
  • filter_meta with available_years, available_types, available_assets, spam_count
  • Optionally: lineage (source_lots, destination_lots) and tax_impact

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
address
required
Address
string

Query Parameters

Section titled “Query Parameters”
page
Page

Page number (1-indexed)

integer
default: 1 >= 1

Page number (1-indexed)

per_page
Per Page

Items per page (max 100)

integer
default: 50 >= 1 <= 100

Items per page (max 100)

type
Any of:
string

Filter by transaction type(s), comma-separated (e.g., swap,send,receive)

chain
Any of:
string

Filter by blockchain network (e.g., ethereum, polygon)

from_date
Any of:
string

Start date filter (ISO 8601, e.g., 2024-01-01)

to_date
Any of:
string

End date filter (ISO 8601, e.g., 2024-12-31)

hide_spam
Hide Spam

Hide spam/trash transactions (default true)

boolean
default: true

Hide spam/trash transactions (default true)

asset
Any of:
string

Filter by asset symbol(s), comma-separated (e.g., ETH,USDC,stETH)

sort_by
Any of:
string

Sort field: timestamp (default), value_usd, fee_usd

sort_order
Any of:
string

Sort direction: desc (default), asc

include_lineage
Include Lineage

Include source/destination lot lineage

boolean

Include source/destination lot lineage

include_tax_impact
Include Tax Impact

Include tax impact (realized G/L) for each transaction

boolean

Include tax impact (realized G/L) for each transaction

owned_wallets
Any of:
Array<string>

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

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