Introduction

Qeychain is a REST API for cryptoassets portfolio tracking and U.S. tax reporting, built for financial advisors, RIAs, and the applications that serve them. Point it at a client’s public wallet addresses and it returns current holdings, FIFO cost basis, unrealized gain/loss, full transaction history, and IRS-ready tax reports — all valued in USD.

This reference covers everything you need to authenticate, make your first call, and understand the shape of every response.

Base URL

All requests go to the production host:

https://api.qeychain.xyz

Every supported endpoint lives under the /api/v1 prefix, for example https://api.qeychain.xyz/api/v1/wallets/{address}/dashboard.

API versions

Qeychain exposes two surfaces:

• v1 (/api/v1) — supported. The institutional product API. Every response uses a standardized envelope, carries a request ID for tracing, supports pagination on list endpoints, and returns typed, machine-readable error codes. Build all new integrations here.
• Legacy (/api/...) — deprecated. An older surface kept only for backward compatibility with existing clients. It receives no new features. Migrate to v1.

Note

Use /api/v1 for everything. The legacy paths exist only so older integrations keep working, and they may be removed in a future release.

What you can do

• Track wallets across multiple chains and roll several addresses up into a single view.
• Read holdings and cost basis — current positions, per-asset holdings intelligence, FIFO cost basis, and unrealized gain/loss:
  • GET /api/v1/wallets/{address}/dashboard
  • GET /api/v1/wallets/{address}/positions
  • GET /api/v1/wallets/{address}/holdings
  • GET /api/v1/wallets/{address}/cost-basis
  • GET /api/v1/wallets/{address}/lots
• Pull transaction history — paginated, filterable by type, chain, asset, and date range, with spam filtering:
  • GET /api/v1/wallets/{address}/transactions
• Generate IRS tax reports — Form 8949, Schedule 1, and a tax summary with estimated liability:
  • GET /api/v1/wallets/{address}/tax-reports/8949
  • GET /api/v1/wallets/{address}/tax-reports/schedule-1
  • GET /api/v1/wallets/{address}/tax-reports/summary

Supported chains

Qeychain tracks fungible tokens and native coins only — there is no NFT support. All valuation is in USD.

Chain	Address format	Notes
EVM (Ethereum and EVM-compatible networks)	0x + 40 hex characters	A single address is resolved across many EVM networks
Bitcoin	bc1… (bech32) or 1… / 3… (legacy)	Native BTC
Solana	base58	Native SOL and SPL tokens

Notes and caveats

Caution

Wash-sale detection is off by default. Under current IRS treatment, cryptoassets are property and are not subject to the wash-sale rule, so tax outputs exclude wash-sale adjustments unless an operator opts in via server configuration. Do not assume wash_sale_* fields are populated.

Note

Tokenized U.S. Treasury tracking is conservative. Tokenized-treasury positions appear in list and holdings responses like any other fungible token, but Qeychain does not promise accrued-yield or APY figures for them — treat those as out of scope.

Next steps

• Authentication — get a token and make authenticated requests.
• Quickstart — your first end-to-end call.
• Response format — the envelope, pagination, and error shape shared by every v1 endpoint.