Get Api Accounting Tax V1

Note

This endpoint’s description is auto-generated from the schema. Human-written copy is pending — see work/openapi/missing-descriptions.txt.

Endpoint

GET /api/accounting/tax/v1

Parameters

Name	In	Type	Required	Description
token	query	string	✅	TAO or SN1, SN2, etc.
date_start	query	string	✅	Start of date range in YYYY-MM-DD format (inclusive)
date_end	query	string	✅	End of date range in YYYY-MM-DD format (inclusive). Must be within 12 calendar months of date_start.
coldkey	query	string	✅	SS58 or hex format

Responses

200 — Tax report retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "coldkey",
          "block_number",
          "timestamp",
          "network",
          "token"
        ],
        "properties": {
          "additional_data": {
            "type": "string",
            "nullable": true
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "coldkey": {
            "type": "string"
          },
          "credit_amount": {
            "type": "string",
            "nullable": true
          },
          "daily_income": {
            "type": "string",
            "nullable": true
          },
          "daily_income_usd": {
            "type": "string",
            "nullable": true
          },
          "date": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "debit_amount": {
            "type": "string",
            "nullable": true
          },
          "extrinsic_id": {
            "type": "string",
            "nullable": true
          },
          "free_balance": {
            "type": "string",
            "nullable": true
          },
          "locked_balance": {
            "type": "string",
            "nullable": true
          },
          "network": {
            "type": "string"
          },
          "reserved_balance": {
            "type": "string",
            "nullable": true
          },
          "staked_balance": {
            "type": "string",
            "nullable": true
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "token": {
            "type": "string"
          },
          "token_price_in_tao": {
            "type": "string",
            "nullable": true
          },
          "token_price_in_usd": {
            "type": "string",
            "nullable": true
          },
          "total_balance": {
            "type": "string",
            "nullable": true
          },
          "transaction_type": {
            "type": "string",
            "nullable": true
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

400 — Bad request

404 — Tax report not found

500 — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.