---
updatedAt: 2026-05-01T11:50:26.000Z
agentTools:
  projectIndex: https://docs.thetie.io/llms.txt
---

# Taxonomy Metadata

Returns metadata about the asset taxonomy system, including all availablesectors, subsectors, attributes, and ecosystems. 

# OpenAPI definition

````json
{
  "openapi": "3.1.0",
  "info": {
    "title": "The Tie API - Quant Taxonomy Endpoints",
    "version": "1.0.0",
    "summary": "Quant Asset Taxonomy API Documentation",
    "description": "Documentation for The Tie's Quant Asset Taxonomy endpoints providing comprehensive\nclassification data for cryptocurrency assets.\n\n## Authentication\n\nThe Tie API uses API key authentication. To authenticate your requests:\n\n1. **Include your API key in the request headers** using the header name `x-api-key`\n2. Example:\n   ```bash\n   curl -H \"x-api-key: YOUR_API_KEY\" https://api-thetie.io/v3/quant/assets/taxonomy/latest\n   ```\n\n**Important:** When testing endpoints using this documentation, make sure to add your API key\nto the `x-api-key` header field in the request headers section.\n\nFor more information about API keys and access control, contact api@thetie.io.\n\n## Asset Taxonomy Overview\n\nThe asset taxonomy system classifies cryptocurrency assets across multiple dimensions:\n\n- **Primary Sector**: Main category (e.g., \"Smart Contract Platforms\", \"DeFi\")\n- **Primary Subsectors**: Specific subcategories within the primary sector\n- **Secondary Sector**: Additional classification dimension\n- **Secondary Subsectors**: Subcategories within the secondary sector\n- **Attributes**: Asset characteristics (e.g., \"Mineable\", \"Proof-of-Stake\")\n- **Ecosystems**: Blockchain ecosystems the asset participates in\n\n### Pagination\n\nThe `/latest` endpoint supports cursor-based pagination using:\n- `limit`: Number of results per page (1-1000, default: 100)\n- `nextMarker`: Token for next page of results\n- `prevMarker`: Token for previous page of results\n\n### Caching\n\nAll endpoints are cached for 1 hour with stale-while-revalidate support for optimal performance.\n"
  },
  "servers": [
    {
      "url": "https://api-thetie.io",
      "description": "Production API Server"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "API key for authentication. Include your API key in the `x-api-key` header for all requests."
      }
    },
    "schemas": {
      "TaxonomyMetadata": {
        "type": "object",
        "required": [
          "sectors",
          "subsectors",
          "attributes",
          "ecosystems"
        ],
        "properties": {
          "sectors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "All available sectors in the taxonomy (alphanumerically sorted)",
            "example": [
              "DeFi",
              "Layer 1",
              "Smart Contract Platforms"
            ]
          },
          "subsectors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "All available subsectors in the taxonomy (alphanumerically sorted)",
            "example": [
              "DEX",
              "Lending",
              "Liquid Staking"
            ]
          },
          "attributes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "All available attributes in the taxonomy (alphanumerically sorted)",
            "example": [
              "Mineable",
              "Proof-of-Stake",
              "EVM Compatible"
            ]
          },
          "ecosystems": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "All available ecosystems in the taxonomy (alphanumerically sorted)",
            "example": [
              "Ethereum Ecosystem",
              "Bitcoin Ecosystem",
              "Solana Ecosystem"
            ]
          }
        }
      },
      "FormattedResponse": {
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Indicates if the request was successful",
            "example": true
          },
          "data": {
            "description": "The response payload (type varies by endpoint)"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "object",
            "required": [
              "message"
            ],
            "properties": {
              "message": {
                "type": "string",
                "description": "Human-readable error message",
                "example": "Asset not found"
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Quant",
      "description": "Endpoints for Quant customers providing comprehensive asset taxonomy data"
    }
  ],
  "paths": {
    "/v3/quant/assets/taxonomy/metadata": {
      "get": {
        "tags": [
          "Quant"
        ],
        "summary": "Taxonomy Metadata",
        "description": "Returns metadata about the asset taxonomy system, including all availablesectors, subsectors, attributes, and ecosystems. ",
        "operationId": "getTaxonomyMetadata",
        "responses": {
          "200": {
            "description": "Taxonomy metadata with all available classification options",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/FormattedResponse"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/TaxonomyMetadata"
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "metadata": {
                    "summary": "Complete taxonomy metadata",
                    "value": {
                      "success": true,
                      "data": {
                        "sectors": [
                          "DeFi",
                          "Layer 1",
                          "Smart Contract Platforms"
                        ],
                        "subsectors": [
                          "DEX",
                          "Lending",
                          "Liquid Staking"
                        ],
                        "attributes": [
                          "Mineable",
                          "Proof-of-Stake",
                          "EVM Compatible"
                        ],
                        "ecosystems": [
                          "Ethereum Ecosystem",
                          "Bitcoin Ecosystem",
                          "Solana Ecosystem"
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - missing or invalid API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}
````