Tax filing
快速入门¶
Restful API¶
公共接口¶
用户接口¶
订单接口¶
报税数据接口¶
WebSocket API¶
WebSocket接入说明¶
公共接口¶
用户接口¶
订单接口¶
1. 分页查询报税数据¶
HTTP请求
POST: /api/spot/v1/tax/filing/page
API说明
- 需完成 签名 鉴权，查询当前 API Key 对应主账号及其子账号的报税数据。
- 返回数据格式与平台报税导出一致，适用于第三方报税工具对接。
- 时间范围
[startTime, endTime]均为 UTC 时间，格式为 ISO8601（如2024-01-01T00:00:00Z）。 dataTypeCodes为报税数据类型代码，至少传入一项；仅支持系统中已启用的类型代码，详见 dataTypeCodes。- 分页从第 1 页开始，默认每页 1000 条，最大 1000 条。
请求参数
| 参数名 | 参数类型 | 必须 | 备注 |
|---|---|---|---|
| startTime | string | Y | 查询起始时间(UTC, ISO8601)，如 2024-01-01T00:00:00Z |
| endTime | string | Y | 查询结束时间(UTC, ISO8601)，如 2024-12-31T23:59:59Z |
| dataTypeCodes | string[] | Y | dataTypeCodes 列表，至少一项 |
| page | number | N | 页码，从 1 开始，默认 1 |
| pageSize | number | N | 每页条数，默认 1000，最大 1000 |
返回数据
| 名称 | 类型 | 必须 | 备注 |
|---|---|---|---|
| code | number | Y | 错误码 |
| msg | string | Y | 说明 |
| data | object | N | 分页查询结果 |
data
| 名称 | 类型 | 必须 | 备注 |
|---|---|---|---|
| records | object[] | Y | 报税数据列表 |
| total | number | Y | 总条数 |
| current | number | Y | 当前页码 |
| size | number | Y | 每页条数 |
| pages | number | Y | 总页数 |
records
| 名称 | 类型 | 必须 | 备注 |
|---|---|---|---|
| date | string | Y | 交易时间(UTC) |
| labelEn | string | Y | 交易类型标签 |
| account | string | Y | 账户 |
| outgoingAsset | string | Y | 转出资产 |
| outgoingAmount | string | Y | 转出数量 |
| incomingAsset | string | Y | 转入资产 |
| incomingAmount | string | Y | 转入数量 |
| feeAsset | string | Y | 手续费币种 |
| feeAmount | string | Y | 手续费数量 |
| typeId | string | Y | 类型ID |
| txId | string | Y | 链上交易ID |
| fromAddress | string | Y | 转出地址 |
| toAddress | string | Y | 转入地址 |
| network | string | Y | 网络 |
| referenceId | string | Y | 关联ID |
| comment | string | Y | 备注 |
说明：金额、地址等字段若无对应数据，返回
—。