List dTao trades (swap events)

Endpoint

GET /api/dtao/trade/v1

Description

Returns individual dTao swap events — the on-chain trades where a coldkey exchanged one asset for another through a subnet pool. Each row records the from/to asset names (e.g. TAO → an alpha symbol, or alpha↔alpha routed through TAO), the amounts swapped, the TAO and USD value of the trade, and the block + extrinsic that executed it.

Use this for trader activity feeds, per-coldkey swap history, and per-asset volume analytics. For aggregated per-subnet volume totals see /api/dtao/delegation_volume/v1; for aggregated TAO flow into/out of a subnet see /api/dtao/tao_flow/v1.

Parameters

Name	In	Type	Required	Description
coldkey	query	string		Filter by the coldkey that executed the trade (SS58 or hex).
extrinsic_id	query	string		Filter by exact extrinsic id (<block>-<index>).
from_name	query	string		Filter by the source asset name (e.g. TAO, or the subnet’s alpha symbol).
to_name	query	string		Filter by the destination asset name.
tao_value_min	query	string		Minimum TAO value of the trade in rao (inclusive).
tao_value_max	query	string		Maximum TAO value of the trade in rao (inclusive).
usd_value_min	query	string		Minimum USD value of the trade (inclusive).
usd_value_max	query	string		Maximum USD value of the trade (inclusive).
block_number	query	integer		Filter to a single block height.
block_start	query	integer		Start of block range (inclusive).
block_end	query	integer		End of block range (inclusive).
timestamp_start	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive).
timestamp_end	query	integer		End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive).
page	query	integer		1-based page number.
limit	query	integer		Page size (max 200).
order	query	—		Sort order, e.g. block_number_desc, tao_value_desc.

Responses

200 — Dtao trades retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "extrinsic_id",
          "coldkey",
          "from_name",
          "to_name",
          "from_amount",
          "to_amount",
          "tao_value",
          "usd_value"
        ],
        "properties": {
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "coldkey": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "extrinsic_id": {
            "type": "string"
          },
          "from_amount": {
            "type": "string"
          },
          "from_name": {
            "type": "string"
          },
          "tao_value": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "to_amount": {
            "type": "string"
          },
          "to_name": {
            "type": "string"
          },
          "usd_value": {
            "type": "string"
          }
        }
      }
    },
    "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 — Dtao trades 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.