Get Api Conviction Latest 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/conviction/latest/v1

Parameters

Name	In	Type	Required	Description
coldkey	query	string		SS58 or hex format
hotkey	query	string		SS58 or hex format
netuid	query	integer
page	query	integer
limit	query	integer
order	query	—

Responses

200 — Conviction locks retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "coldkey",
          "hotkey",
          "netuid",
          "block_number",
          "timestamp",
          "amount_locked",
          "amount_tao",
          "conviction",
          "is_owner_hotkey",
          "is_owner_coldkey",
          "perpetual"
        ],
        "properties": {
          "amount_locked": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "amount_tao": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "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"
              }
            }
          },
          "conviction": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "hotkey": {
            "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"
              }
            }
          },
          "is_owner_coldkey": {
            "type": "boolean"
          },
          "is_owner_hotkey": {
            "type": "boolean"
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "perpetual": {
            "type": "boolean"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "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.