Documentation / API reference / Accounting
Get Accounting Tax
Reference
Last reviewed 2026-09-18
Returns accounting records for a coldkey and token over a date range, including balances, transactions and daily income. Use the token list endpoint to find the tokens available for the wallet and period.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | TAO or SN1, SN2, etc. |
date_start | query | string (date) | Yes | Start of date range in YYYY-MM-DD format (inclusive) |
date_end | query | string (date) | Yes | End of date range in YYYY-MM-DD format (inclusive). Must be within 12 calendar months of date_start. |
coldkey | query | string | Yes | SS58 or hex format |
Responses
200 — Tax report retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].additional_data | string, nullable | |
data[].block_number | integer (int32) | Yes |
data[].coldkey | string | Yes |
data[].credit_amount | string, nullable | |
data[].daily_income | string, nullable | |
data[].daily_income_usd | string, nullable | |
data[].date | string (date), nullable | |
data[].debit_amount | string, nullable | |
data[].extrinsic_id | string, nullable | |
data[].free_balance | string, nullable | |
data[].locked_balance | string, nullable | |
data[].network | string | Yes |
data[].reserved_balance | string, nullable | |
data[].staked_balance | string, nullable | |
data[].timestamp | string (date-time) | Yes |
data[].token | string | Yes |
data[].token_price_in_tao | string, nullable | |
data[].token_price_in_usd | string, nullable | |
data[].total_balance | string, nullable | |
data[].transaction_type | string, nullable | |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Tax report not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.