Tax filing

Quick Start ¶

Sign

HTTP Request

POST: /api/spot/v1/tax/filing/page

API Description

Requires signature authentication. Returns tax filing data for the main account and its sub accounts associated with the current API Key.
The response format matches the platform tax export, suitable for third-party tax tool integration.
The time range [startTime, endTime] uses UTC in ISO8601 format (e.g. 2024-01-01T00:00:00Z).
dataTypeCodes is a list of tax data type codes; at least one item is required. Only enabled type codes in the system are supported. See dataTypeCodes for details.
Pagination starts from page 1. Default page size is 1000, maximum 1000.

Parameters

Name	Type	Required	Notes
startTime	string	Y	Query start time (UTC, ISO8601), e.g. `2024-01-01T00:00:00Z`
endTime	string	Y	Query end time (UTC, ISO8601), e.g. `2024-12-31T23:59:59Z`
dataTypeCodes	string[]	Y	dataTypeCodes list, at least one item
page	number	N	Page number, starts from 1, default 1
pageSize	number	N	Page size, default 1000, maximum 1000

Returned Data

Name	Type	Required	Notes
code	number	Y	Error code
msg	string	Y	Description
data	object	N	Paginated result

Data

Name	Type	Required	Notes
records	object[]	Y	Tax filing data list
total	number	Y	Total count
current	number	Y	Current page
size	number	Y	Page size
pages	number	Y	Total pages

Records

Name	Type	Required	Notes
date	string	Y	Transaction time (UTC)
labelEn	string	Y	Transaction type label
account	string	Y	Account
outgoingAsset	string	Y	Outgoing asset
outgoingAmount	string	Y	Outgoing amount
incomingAsset	string	Y	Incoming asset
incomingAmount	string	Y	Incoming amount
feeAsset	string	Y	Fee asset
feeAmount	string	Y	Fee amount
typeId	string	Y	Type ID
txId	string	Y	On-chain transaction ID
fromAddress	string	Y	From address
toAddress	string	Y	To address
network	string	Y	Network
referenceId	string	Y	Reference ID
comment	string	Y	Comment

Note: If amount, address, or other fields have no corresponding data, — is returned.