Per-user OTC lockup statistics

Endpoint

GET /api/otc/lockup/user/stats/v1

Description

Lifetime lockup statistics for a coldkey: total listings created (as seller), purchases made (as buyer), claims executed, fees paid, and bought/sold volume in TAO and alpha. Filter by netuid for per-subnet breakdown.

Parameters

Name	In	Type	Required	Description
account	query	string		Coldkey (SS58) to query.
netuid	query	integer		Subnet id. Omit to aggregate across all subnets.
page	query	integer		1-based page number.
limit	query	integer		Page size (max 200).
order	query	—		Sort order.

Responses

200 — Lockup user statistics retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "account",
          "netuid",
          "total_listings_created",
          "total_purchases_made",
          "total_claims_made",
          "total_volume_sold_tao",
          "total_volume_sold_alpha",
          "total_volume_bought_tao",
          "total_volume_bought_alpha",
          "total_fees_paid",
          "last_activity_block",
          "last_activity_timestamp"
        ],
        "properties": {
          "account": {
            "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"
              }
            }
          },
          "last_activity_block": {
            "type": "integer",
            "format": "int32"
          },
          "last_activity_timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "total_claims_made": {
            "type": "integer",
            "format": "int32"
          },
          "total_fees_paid": {
            "type": "string"
          },
          "total_listings_created": {
            "type": "integer",
            "format": "int32"
          },
          "total_purchases_made": {
            "type": "integer",
            "format": "int32"
          },
          "total_volume_bought_alpha": {
            "type": "string"
          },
          "total_volume_bought_tao": {
            "type": "string"
          },
          "total_volume_sold_alpha": {
            "type": "string"
          },
          "total_volume_sold_tao": {
            "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

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.