feat: add Beta badge to all v2 TVL and Treasury endpoints

- Create BetaBadge component (purple, mirrors ProBadge pattern)
- Wire BetaBadge into ModernLayout, ClassicLayout, and OperationsListItem
- Add beta indicator to sidebar, stacked vertically below HTTP method
- Add x-api-beta: true to all 8 v2 endpoints in pro spec
- Update llms.txt with Beta markers on all v2 entries

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: mintdart

defillama-openapi-pro.json

@@ -5541,6 +5541,7 @@
       "get": {
         "tags": ["TVL"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get aggregate TVL metrics for a protocol",
         "description": "Returns protocol metadata along with current TVL figures, chain breakdowns, and other aggregate metrics.",
         "parameters": [
@@ -5935,6 +5936,7 @@
       "get": {
         "tags": ["TVL"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical TVL chart for a protocol",
         "description": "Returns an array of [timestamp, value] pairs representing the protocol's TVL over time. By default returns the base TVL metric. Use the `key` parameter to select a different metric or aggregate all metrics.",
         "parameters": [
@@ -5988,6 +5990,7 @@
       "get": {
         "tags": ["TVL"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical TVL chart for a protocol broken down by chain",
         "description": "Returns an array of [timestamp, { chain: value }] pairs showing the selected metric per chain over time.",
         "parameters": [
@@ -6038,6 +6041,7 @@
       "get": {
         "tags": ["TVL"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical TVL chart for a protocol broken down by token",
         "description": "Returns an array of [timestamp, { token: value }] pairs showing TVL per token over time. Values are in USD by default, set currency=tokens for raw token amounts.",
         "parameters": [
@@ -6098,6 +6102,7 @@
       "get": {
         "tags": ["Treasury"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get aggregate treasury metrics for a protocol",
         "description": "Returns protocol metadata along with current treasury figures and chain breakdowns.",
         "parameters": [
@@ -6397,6 +6402,7 @@
       "get": {
         "tags": ["Treasury"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical treasury chart for a protocol",
         "description": "Returns an array of [timestamp, value] pairs representing the protocol's treasury value over time. By default excludes the protocol's own tokens (OwnTokens).",
         "parameters": [
@@ -6450,6 +6456,7 @@
       "get": {
         "tags": ["Treasury"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical treasury chart for a protocol broken down by chain",
         "description": "Returns an array of [timestamp, { chain: value }] pairs showing treasury value per chain over time. By default excludes the protocol's own tokens.",
         "parameters": [
@@ -6500,6 +6507,7 @@
       "get": {
         "tags": ["Treasury"],
         "x-api-plan-only": true,
+        "x-api-beta": true,
         "summary": "Get historical treasury chart for a protocol broken down by token",
         "description": "Returns an array of [timestamp, { token: value }] pairs showing treasury value per token over time. By default excludes OwnTokens and values are in USD. Use key and currency params to customize.",
         "parameters": [

llms.txt

@@ -4,7 +4,7 @@ DefiLlama API – Complete LLM Integration Guide
 ## Overview
 
 This document provides comprehensive guidance for LLMs to interact with ALL DefiLlama APIs.
-Includes API-Plan-only endpoints (marked with 🔒) and free endpoints, with full parameters and responses.
+Includes API-Plan-only endpoints (marked with 🔒), beta endpoints (marked with 🧪), and free endpoints, with full parameters and responses.
 
 ## Base URLs
 
@@ -185,7 +185,7 @@ These endpoints provide time-series chart data for individual protocol TVL.
 The `key` parameter selects which metric to return. The `currency` parameter
 (token-breakdown only) switches values from USD to raw token amounts.
 
-8a. 🔒 **GET /api/v2/metrics/tvl/protocol/{protocol}**
+8a. 🔒 🧪 **GET /api/v2/metrics/tvl/protocol/{protocol}**
     Base: `https://pro-api.llama.fi`
     Purpose: Aggregate TVL metrics for a protocol (metadata + current TVL figures)
     Parameters:
@@ -210,7 +210,7 @@ The `key` parameter selects which metric to return. The `currency` parameter
     }
     ```
 
-8b. 🔒 **GET /api/v2/chart/tvl/protocol/{protocol}**
+8b. 🔒 🧪 **GET /api/v2/chart/tvl/protocol/{protocol}**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical TVL value chart for a protocol
     Parameters:
@@ -225,7 +225,7 @@ The `key` parameter selects which metric to return. The `currency` parameter
       - `/v2/chart/tvl/protocol/uniswap?key=all` — sum of all metrics
       - `/v2/chart/tvl/protocol/morpho?key=borrowed` — borrowed only
 
-8c. 🔒 **GET /api/v2/chart/tvl/protocol/{protocol}/chain-breakdown**
+8c. 🔒 🧪 **GET /api/v2/chart/tvl/protocol/{protocol}/chain-breakdown**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical TVL chart broken down by chain
     Parameters:
@@ -239,7 +239,7 @@ The `key` parameter selects which metric to return. The `currency` parameter
       - `/v2/chart/tvl/protocol/euler/chain-breakdown` — default TVL per chain
       - `/v2/chart/tvl/protocol/euler/chain-breakdown?key=borrowed` — borrowed per chain
 
-8d. 🔒 **GET /api/v2/chart/tvl/protocol/{protocol}/token-breakdown**
+8d. 🔒 🧪 **GET /api/v2/chart/tvl/protocol/{protocol}/token-breakdown**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical TVL chart broken down by token
     Parameters:
@@ -260,7 +260,7 @@ These endpoints provide time-series chart data for protocol treasuries.
 By default, the protocol's own tokens (OwnTokens) are excluded. Use the
 `key` parameter to filter: "OwnTokens" for own tokens only, "all" to include everything.
 
-8e. 🔒 **GET /api/v2/metrics/treasury/protocol/{protocol}**
+8e. 🔒 🧪 **GET /api/v2/metrics/treasury/protocol/{protocol}**
     Base: `https://pro-api.llama.fi`
     Purpose: Aggregate treasury metrics for a protocol (metadata + current treasury figures)
     Parameters:
@@ -283,7 +283,7 @@ By default, the protocol's own tokens (OwnTokens) are excluded. Use the
     }
     ```
 
-8f. 🔒 **GET /api/v2/chart/treasury/protocol/{protocol}**
+8f. 🔒 🧪 **GET /api/v2/chart/treasury/protocol/{protocol}**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical treasury value chart for a protocol (excludes OwnTokens by default)
     Parameters:
@@ -298,7 +298,7 @@ By default, the protocol's own tokens (OwnTokens) are excluded. Use the
       - `/v2/chart/treasury/protocol/uniswap?key=OwnTokens` — own tokens only
       - `/v2/chart/treasury/protocol/uniswap?key=all` — sum of all including OwnTokens
 
-8g. 🔒 **GET /api/v2/chart/treasury/protocol/{protocol}/chain-breakdown**
+8g. 🔒 🧪 **GET /api/v2/chart/treasury/protocol/{protocol}/chain-breakdown**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical treasury chart broken down by chain (excludes OwnTokens by default)
     Parameters:
@@ -313,7 +313,7 @@ By default, the protocol's own tokens (OwnTokens) are excluded. Use the
       - `/v2/chart/treasury/protocol/aave/chain-breakdown?key=OwnTokens` — own tokens only per chain
       - `/v2/chart/treasury/protocol/aave/chain-breakdown?key=all` — all tokens per chain
 
-8h. 🔒 **GET /api/v2/chart/treasury/protocol/{protocol}/token-breakdown**
+8h. 🔒 🧪 **GET /api/v2/chart/treasury/protocol/{protocol}/token-breakdown**
     Base: `https://pro-api.llama.fi`
     Purpose: Historical treasury chart broken down by token
     Parameters:

packages/api-reference/src/components/BetaBadge/BetaBadge.vue

@@ -0,0 +1,33 @@
+<template>
+  <Badge
+    v-if="showBetaBadge"
+    class="api-beta-badge">
+    Beta
+  </Badge>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue'
+
+import { Badge } from '@/components/Badge'
+
+const { operation } = defineProps<{
+  operation?: {
+    'x-api-beta'?: boolean
+    [key: string]: any
+  }
+}>()
+
+const showBetaBadge = computed(() => {
+  return operation?.['x-api-beta'] === true
+})
+</script>
+
+<style scoped>
+.api-beta-badge {
+  font-weight: var(--scalar-bold);
+  font-size: var(--scalar-micro);
+  color: #9333ea;
+  margin-left: 8px;
+}
+</style>

packages/api-reference/src/components/BetaBadge/index.ts

@@ -0,0 +1 @@
+export { default as BetaBadge } from './BetaBadge.vue'

packages/api-reference/src/components/Content/Tag/OperationsListItem.vue

@@ -70,6 +70,11 @@ const title = computed(
           class="pro-indicator">
           API Plan
         </span>
+        <span
+          v-if="transformedOperation.information?.['x-api-beta'] === true"
+          class="beta-indicator">
+          Beta
+        </span>
       </span>
     </a>
   </li>
@@ -127,4 +132,15 @@ const title = computed(
   border-radius: 6px;
   display: inline-block;
 }
+
+.beta-indicator {
+  margin-left: 8px;
+  color: #9333ea;
+  font-size: var(--scalar-micro);
+  font-weight: var(--scalar-bold);
+  background: color-mix(in srgb, #9333ea, transparent 90%);
+  padding: 1px 4px;
+  border-radius: 6px;
+  display: inline-block;
+}
 </style>

packages/api-reference/src/features/Operation/layouts/ClassicLayout.vue

@@ -27,6 +27,7 @@ import { Anchor } from '@/components/Anchor'
 import { Badge } from '@/components/Badge'
 import { HttpMethod } from '@/components/HttpMethod'
 import OperationPath from '@/components/OperationPath.vue'
+import { BetaBadge } from '@/components/BetaBadge'
 import { ProBadge } from '@/components/ProBadge'
 import { SectionAccordion } from '@/components/Section'
 import { ExampleResponses } from '@/features/example-responses'
@@ -96,6 +97,7 @@ const handleDiscriminatorChange = (type: string) => {
               </Badge>
 
               <ProBadge :operation="operation" />
+              <BetaBadge :operation="operation" />
 
               <Badge
                 v-if="isWebhook"

packages/api-reference/src/features/Operation/layouts/ModernLayout.vue

@@ -17,6 +17,7 @@ import { computed, useId } from 'vue'
 import { Anchor } from '@/components/Anchor'
 import { Badge } from '@/components/Badge'
 import OperationPath from '@/components/OperationPath.vue'
+import { BetaBadge } from '@/components/BetaBadge'
 import { ProBadge } from '@/components/ProBadge'
 import {
   Section,
@@ -78,6 +79,7 @@ const handleDiscriminatorChange = (type: string) => {
       </Badge>
 
       <ProBadge :operation="operation" />
+      <BetaBadge :operation="operation" />
 
       <Badge
         v-if="isWebhook"

packages/api-reference/src/features/sidebar/components/SidebarElement.vue

@@ -129,25 +129,34 @@ const onAnchorClick = async (ev: Event) => {
         <p class="sidebar-heading-link-title">
           {{ item.title }}
         </p>
-        <p
+        <div
           v-if="'method' in item && !hasChildren"
           class="sidebar-heading-link-method">
-          &hairsp;
-          <span class="sr-only">HTTP Method:&nbsp;</span>
-          <SidebarHttpBadge
-            class="min-w-9.75 justify-end text-right"
-            :active="isActive"
-            :method="item.method">
-            <template #default>
-              <ScalarIconWebhooksLogo
-                weight="bold"
-                v-if="'webhook' in item"
-                :style="{
-                  color: getHttpMethodInfo(item.method).colorVar,
-                }" />
-            </template>
-          </SidebarHttpBadge>
-        </p>
+          <p class="sidebar-heading-link-method-row">
+            &hairsp;
+            <span class="sr-only">HTTP Method:&nbsp;</span>
+            <SidebarHttpBadge
+              class="min-w-9.75 justify-end text-right"
+              :active="isActive"
+              :method="item.method">
+              <template #default>
+                <ScalarIconWebhooksLogo
+                  weight="bold"
+                  v-if="'webhook' in item"
+                  :style="{
+                    color: getHttpMethodInfo(item.method).colorVar,
+                  }" />
+              </template>
+            </SidebarHttpBadge>
+          </p>
+          <span
+            v-if="
+              'operation' in item && item.operation?.['x-api-beta'] === true
+            "
+            class="sidebar-beta-badge">
+            Beta
+          </span>
+        </div>
       </a>
     </div>
     <slot v-if="open" />
@@ -178,6 +187,14 @@ const onAnchorClick = async (ev: Event) => {
 }
 .sidebar-heading-link-method {
   margin: 0;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-end;
+  gap: 2px;
+  flex-shrink: 0;
+}
+.sidebar-heading-link-method-row {
+  margin: 0;
 }
 .sidebar-heading.deprecated .sidebar-heading-link-title {
   text-decoration: line-through;
@@ -352,4 +369,13 @@ const onAnchorClick = async (ev: Event) => {
   color: var(--scalar-sidebar-color-1, var(--scalar-color-1));
   font-weight: var(--scalar-sidebar-font-weight-active, var(--scalar-semibold));
 }
+
+.sidebar-beta-badge {
+  color: #9333ea;
+  font-size: 9px;
+  font-weight: var(--scalar-bold);
+  text-transform: uppercase;
+  line-height: 1;
+  flex-shrink: 0;
+}
 </style>