Documentation / API reference / Accounting

Get Accounting Tax CSV

Reference

Last reviewed 2026-09-18

GET

https://api.taostats.io/api/accounting/tax_csv/v1API key required

Downloads accounting records for a coldkey and token over a date range as a CSV report. Select the wallet, token and reporting dates with the query parameters.

Try it

API key

Sent only to api.taostats.io, straight from your browser. It stays in this page’s memory unless you choose to remember it for this tab.

Remember for this tab

Get an API key

Load an example

Parameters

token string Required

TAO or SN1, SN2, etc.

date_start string (date) Required

Start of date range in YYYY-MM-DD format (inclusive)

date_end string (date) Required

End of date range in YYYY-MM-DD format (inclusive). Must be within 12 calendar months of date_start.

coldkey string Required

SS58 or hex format

Request

GET https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n

bash

curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n"

const response = await fetch('https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();

python

import requests

response = requests.get(
    "https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()

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

Status	Meaning
`200`	Tax report retrieved successfully
`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.

Was this page helpful?

Documentation / API reference / Accounting

Get Accounting Tax CSV

Reference

Last reviewed 2026-09-18

GET

https://api.taostats.io/api/accounting/tax_csv/v1API key required

Downloads accounting records for a coldkey and token over a date range as a CSV report. Select the wallet, token and reporting dates with the query parameters.

Try it

API key

Sent only to api.taostats.io, straight from your browser. It stays in this page’s memory unless you choose to remember it for this tab.

Remember for this tab

Get an API key

Load an example

Parameters

token string Required

TAO or SN1, SN2, etc.

date_start string (date) Required

Start of date range in YYYY-MM-DD format (inclusive)

date_end string (date) Required

End of date range in YYYY-MM-DD format (inclusive). Must be within 12 calendar months of date_start.

coldkey string Required

SS58 or hex format

Request

GET https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n

bash

curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n"

const response = await fetch('https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();

python

import requests

response = requests.get(
    "https://api.taostats.io/api/accounting/tax_csv/v1?token=TAO&date_start=2025-01-01&date_end=2025-03-31&coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()

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

Status	Meaning
`200`	Tax report retrieved successfully
`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.