# Get the filter vocabularies

`GET /v3/vocabulary`

One discovery surface for every value a v3 filter accepts. Closed
vocabularies (grades, sentiments, stances, sort keys, activity modes,
rankings, universes, asset types, series measures) are versioned with
the contract; catalog-derived sets (project categories, intel
categories, chains) are composed from their owning catalogs at read
time and carry their own versions.

## Authentication

Required. Send an API key in the `x-api-key` header.

## Parameters

None.

## Request body

None.

## Responses

```json
{
  "200": {
    "description": "Vocabularies.",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "data",
            "meta"
          ],
          "properties": {
            "data": {
              "$ref": "#/components/schemas/Vocabulary"
            },
            "meta": {
              "$ref": "#/components/schemas/Meta"
            }
          }
        },
        "examples": {
          "success": {
            "summary": "Current vocabularies",
            "value": {
              "data": {
                "grades": [
                  "chipped",
                  "flawed",
                  "cut",
                  "polished",
                  "flawless"
                ],
                "sentiments": [
                  "positive",
                  "neutral",
                  "negative"
                ],
                "stances": [
                  "supportive",
                  "skeptical",
                  "neutral",
                  "mixed",
                  "unknown"
                ],
                "assetTypes": [
                  "token",
                  "stablecoin",
                  "nft-collection"
                ],
                "marketCapBands": [
                  "low",
                  "mid",
                  "large"
                ],
                "projectSort": [
                  "rank",
                  "trend",
                  "createdAt",
                  "reinforcedAt"
                ],
                "intelSort": [
                  "reinforcedAt",
                  "detectedAt"
                ],
                "activityModes": [
                  "all",
                  "observations",
                  "none"
                ],
                "projectRankings": [
                  "trend"
                ],
                "universes": [
                  "crypto"
                ],
                "seriesMeasures": [
                  "trend",
                  "rank"
                ],
                "alertTriggers": [
                  "intelligence.material",
                  "rank.entered"
                ],
                "alertCadences": [
                  "instant",
                  "hourly",
                  "every_12h",
                  "daily"
                ],
                "projectCategories": [
                  {
                    "slug": "modular-blockchains",
                    "name": "Modular blockchains"
                  }
                ],
                "intelCategories": [
                  {
                    "slug": "product-launch",
                    "name": "Product launch"
                  }
                ],
                "chains": [
                  "ethereum",
                  "solana",
                  "base"
                ]
              },
              "meta": {
                "versions": {
                  "vocabulary": "3.0.0-draft.1",
                  "taxonomy": "taxonomy-v2"
                }
              }
            }
          }
        }
      }
    }
  },
  "401": {
    "$ref": "#/components/responses/Unauthorized"
  },
  "429": {
    "$ref": "#/components/responses/RateLimited"
  },
  "500": {
    "$ref": "#/components/responses/Internal"
  }
}
```

## Referenced schemas

```json
{
  "Vocabulary": {
    "type": "object",
    "required": [
      "grades",
      "sentiments",
      "stances",
      "assetTypes",
      "marketCapBands",
      "projectSort",
      "intelSort",
      "activityModes",
      "projectRankings",
      "universes",
      "seriesMeasures",
      "alertTriggers",
      "alertCadences",
      "projectCategories",
      "intelCategories",
      "chains"
    ],
    "properties": {
      "grades": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Grade"
        }
      },
      "sentiments": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "stances": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Stance"
        }
      },
      "assetTypes": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "marketCapBands": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "projectSort": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "intelSort": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "activityModes": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "projectRankings": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "universes": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "seriesMeasures": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "alertTriggers": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/AlertTrigger"
        }
      },
      "alertCadences": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/AlertCadence"
        }
      },
      "projectCategories": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "slug",
            "name"
          ],
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          }
        }
      },
      "intelCategories": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "slug",
            "name"
          ],
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          }
        }
      },
      "chains": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  },
  "Grade": {
    "type": "string",
    "enum": [
      "chipped",
      "flawed",
      "cut",
      "polished",
      "flawless"
    ],
    "description": "Evidence grade of an Intel item, lowest to highest. Grades describe\nthe shape of the evidence, never the truth of the claim.\n"
  },
  "Stance": {
    "type": "string",
    "enum": [
      "supportive",
      "skeptical",
      "neutral",
      "mixed",
      "unknown"
    ]
  },
  "AlertTrigger": {
    "type": "string",
    "enum": [
      "intelligence.material",
      "rank.entered"
    ],
    "description": "The set of launch triggers."
  },
  "AlertCadence": {
    "type": "string",
    "enum": [
      "instant",
      "hourly",
      "every_12h",
      "daily"
    ],
    "description": "Chat delivery cadence. First event in a window delivers immediately;\nthe window bundles the rest. `instant` is subject to a per-day\nplatform safety ceiling.\n"
  },
  "Meta": {
    "type": "object",
    "description": "Response metadata. Empty when nothing applies.",
    "properties": {
      "history": {
        "$ref": "#/components/schemas/HistoryMeta"
      },
      "versions": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Named component versions that shaped this response."
      }
    }
  },
  "HistoryMeta": {
    "type": "object",
    "description": "The history window applied to this response. Both fields are null when the account has no history limit.",
    "required": [
      "lookbackDays",
      "earliestAvailableAt"
    ],
    "properties": {
      "lookbackDays": {
        "oneOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ]
      },
      "earliestAvailableAt": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  }
}
```

Schema references resolve against the [canonical OpenAPI specification](https://api.aixbt.tech/v3/openapi.yaml).