From 63b5e3c5fb6ff82ecbaa31088c9959a87159ca4d Mon Sep 17 00:00:00 2001
From: TanmayDagur <nitindagur2002@gmail.com>
Date: Mon, 27 Jul 2026 16:38:33 +0530
Subject: [PATCH] feat(playground): add Token Price Tracker page with live
 market data

---
 .../src/app/data/pages-metadata.ts            |   8 +
 apps/playground-web/src/app/navLinks.ts       |   4 +
 .../src/app/tokens/price-tracker/page.tsx     |  34 +++
 .../token-price/token-price-tracker.tsx       | 209 ++++++++++++++++++
 4 files changed, 255 insertions(+)
 create mode 100644 apps/playground-web/src/app/tokens/price-tracker/page.tsx
 create mode 100644 apps/playground-web/src/components/token-price/token-price-tracker.tsx

diff --git a/apps/playground-web/src/app/data/pages-metadata.ts b/apps/playground-web/src/app/data/pages-metadata.ts
index b3ba3ecbadc..ebf073c34b9 100644
--- a/apps/playground-web/src/app/data/pages-metadata.ts
+++ b/apps/playground-web/src/app/data/pages-metadata.ts
@@ -16,6 +16,7 @@ import {
   SquareIcon,
   SquircleDashedIcon,
   StampIcon,
+  TrendingUpIcon,
   UserIcon,
   WalletCardsIcon,
 } from "lucide-react";
@@ -203,6 +204,13 @@ export const tokensFeatureCards: FeatureCardMetadata[] = [
     link: "/tokens/nft-components",
     description: "Headless UI components for rendering NFT Media and metadata",
   },
+  {
+    icon: TrendingUpIcon,
+    title: "Price Tracker",
+    link: "/tokens/price-tracker",
+    description:
+      "Live token prices, market cap, and 24h volume across chains",
+  },
 ];
 
 export const aiFeatureCards: FeatureCardMetadata[] = [
diff --git a/apps/playground-web/src/app/navLinks.ts b/apps/playground-web/src/app/navLinks.ts
index 864beb4dc60..7ef4732be34 100644
--- a/apps/playground-web/src/app/navLinks.ts
+++ b/apps/playground-web/src/app/navLinks.ts
@@ -173,6 +173,10 @@ const tokens: ShadcnSidebarLink = {
       href: "/tokens/nft-components",
       label: "NFT Components",
     },
+    {
+      href: "/tokens/price-tracker",
+      label: "Price Tracker",
+    },
   ],
 };
 
diff --git a/apps/playground-web/src/app/tokens/price-tracker/page.tsx b/apps/playground-web/src/app/tokens/price-tracker/page.tsx
new file mode 100644
index 00000000000..8c116ea09d0
--- /dev/null
+++ b/apps/playground-web/src/app/tokens/price-tracker/page.tsx
@@ -0,0 +1,34 @@
+import { TrendingUpIcon } from "lucide-react";
+import { PageLayout } from "@/components/blocks/APIHeader";
+import { TokenPriceTracker } from "@/components/token-price/token-price-tracker";
+import ThirdwebProvider from "@/components/thirdweb-provider";
+import { createMetadata } from "@/lib/metadata";
+
+const title = "Price Tracker";
+const description =
+  "Live token prices, market cap, and 24h volume across chains";
+
+export const metadata = createMetadata({
+  title,
+  description,
+  image: {
+    icon: "wallets",
+    title,
+  },
+});
+
+export default function Page() {
+  return (
+    <ThirdwebProvider>
+      <PageLayout
+        containerClassName="space-y-12"
+        icon={TrendingUpIcon}
+        description={description}
+        docsLink="https://portal.thirdweb.com/typescript/v5/bridge/get-supported-tokens?utm_source=playground"
+        title={title}
+      >
+        <TokenPriceTracker />
+      </PageLayout>
+    </ThirdwebProvider>
+  );
+}
diff --git a/apps/playground-web/src/components/token-price/token-price-tracker.tsx b/apps/playground-web/src/components/token-price/token-price-tracker.tsx
new file mode 100644
index 00000000000..196bcbdfd21
--- /dev/null
+++ b/apps/playground-web/src/components/token-price/token-price-tracker.tsx
@@ -0,0 +1,209 @@
+"use client";
+
+import { useQuery } from "@tanstack/react-query";
+import { useState } from "react";
+import { Bridge } from "thirdweb";
+import {
+  arbitrum,
+  base,
+  ethereum,
+  optimism,
+  polygon,
+} from "thirdweb/chains";
+import { THIRDWEB_CLIENT } from "@/lib/client";
+import { CodeExample } from "../code/code-example";
+
+const CHAINS = [
+  { chain: ethereum, label: "Ethereum", id: 1 },
+  { chain: base, label: "Base", id: 8453 },
+  { chain: polygon, label: "Polygon", id: 137 },
+  { chain: arbitrum, label: "Arbitrum", id: 42161 },
+  { chain: optimism, label: "Optimism", id: 10 },
+] as const;
+
+function formatUsd(value: number): string {
+  if (value >= 1_000_000_000) {
+    return `$${(value / 1_000_000_000).toFixed(2)}B`;
+  }
+  if (value >= 1_000_000) {
+    return `$${(value / 1_000_000).toFixed(2)}M`;
+  }
+  if (value >= 1_000) {
+    return `$${(value / 1_000).toFixed(2)}K`;
+  }
+  return `$${value.toFixed(2)}`;
+}
+
+function formatPrice(value: number): string {
+  if (value >= 1) {
+    return `$${value.toFixed(2)}`;
+  }
+  if (value >= 0.01) {
+    return `$${value.toFixed(4)}`;
+  }
+  return `$${value.toFixed(6)}`;
+}
+
+function TokenPriceTrackerPreview() {
+  const [selectedChainId, setSelectedChainId] = useState(1);
+
+  const tokensQuery = useQuery({
+    queryKey: ["bridge-tokens-price", selectedChainId],
+    queryFn: () =>
+      Bridge.tokens({
+        client: THIRDWEB_CLIENT,
+        chainId: selectedChainId,
+        limit: 15,
+        sortBy: "market_cap",
+        includePrices: true,
+      }),
+    refetchInterval: 30_000,
+  });
+
+  return (
+    <div className="w-full max-w-3xl space-y-4 px-4">
+      {/* Chain Selector */}
+      <div className="flex items-center gap-2 flex-wrap">
+        {CHAINS.map((c) => (
+          <button
+            key={c.id}
+            type="button"
+            onClick={() => setSelectedChainId(c.id)}
+            className={`rounded-full border px-3 py-1 text-xs font-medium transition-colors ${
+              selectedChainId === c.id
+                ? "border-primary bg-primary text-primary-foreground"
+                : "border-border bg-background text-muted-foreground hover:bg-accent"
+            }`}
+          >
+            {c.label}
+          </button>
+        ))}
+      </div>
+
+      {/* Token List */}
+      <div className="rounded-lg border bg-card">
+        {/* Header */}
+        <div className="grid grid-cols-[1fr_auto_auto_auto] gap-4 border-b px-4 py-2.5 text-xs font-medium text-muted-foreground">
+          <span>Token</span>
+          <span className="w-24 text-right">Price</span>
+          <span className="hidden w-24 text-right sm:block">Market Cap</span>
+          <span className="hidden w-24 text-right sm:block">24h Volume</span>
+        </div>
+
+        {/* Loading State */}
+        {tokensQuery.isLoading && (
+          <div className="space-y-0">
+            {Array.from({ length: 8 }).map((_, i) => (
+              <div
+                key={`skeleton-${i.toString()}`}
+                className="grid grid-cols-[1fr_auto_auto_auto] gap-4 border-b px-4 py-3 last:border-b-0"
+              >
+                <div className="flex items-center gap-3">
+                  <div className="size-8 animate-pulse rounded-full bg-muted" />
+                  <div className="space-y-1.5">
+                    <div className="h-3.5 w-20 animate-pulse rounded bg-muted" />
+                    <div className="h-3 w-12 animate-pulse rounded bg-muted" />
+                  </div>
+                </div>
+                <div className="h-4 w-24 animate-pulse self-center rounded bg-muted" />
+                <div className="hidden h-4 w-24 animate-pulse self-center rounded bg-muted sm:block" />
+                <div className="hidden h-4 w-24 animate-pulse self-center rounded bg-muted sm:block" />
+              </div>
+            ))}
+          </div>
+        )}
+
+        {/* Error State */}
+        {tokensQuery.isError && (
+          <div className="px-4 py-8 text-center text-sm text-muted-foreground">
+            Failed to load token data. Please try again.
+          </div>
+        )}
+
+        {/* Data */}
+        {tokensQuery.data?.map((token) => (
+          <div
+            key={`${token.chainId}-${token.address}`}
+            className="grid grid-cols-[1fr_auto_auto_auto] gap-4 border-b px-4 py-3 last:border-b-0 hover:bg-accent/50 transition-colors"
+          >
+            <div className="flex items-center gap-3">
+              {token.iconUri ? (
+                <img
+                  src={token.iconUri}
+                  alt={token.name}
+                  className="size-8 rounded-full"
+                />
+              ) : (
+                <div className="size-8 rounded-full bg-muted" />
+              )}
+              <div>
+                <p className="text-sm font-medium leading-tight">
+                  {token.name}
+                </p>
+                <p className="text-xs text-muted-foreground">{token.symbol}</p>
+              </div>
+            </div>
+            <span className="w-24 self-center text-right text-sm font-medium tabular-nums">
+              {token.prices?.usd ? formatPrice(token.prices.usd) : "—"}
+            </span>
+            <span className="hidden w-24 self-center text-right text-xs text-muted-foreground tabular-nums sm:block">
+              {token.marketCapUsd ? formatUsd(token.marketCapUsd) : "—"}
+            </span>
+            <span className="hidden w-24 self-center text-right text-xs text-muted-foreground tabular-nums sm:block">
+              {token.volume24hUsd ? formatUsd(token.volume24hUsd) : "—"}
+            </span>
+          </div>
+        ))}
+      </div>
+
+      {/* Auto-refresh indicator */}
+      <p className="text-center text-xs text-muted-foreground">
+        Auto-refreshes every 30s
+        {tokensQuery.isFetching && !tokensQuery.isLoading && (
+          <span className="ml-1.5 inline-block size-2 animate-pulse rounded-full bg-green-500" />
+        )}
+      </p>
+    </div>
+  );
+}
+
+export function TokenPriceTracker() {
+  return (
+    <CodeExample
+      header={{
+        title: "Token Price Tracker",
+        description:
+          "Fetch live token prices, market cap, and 24h volume using the Bridge.tokens() API with multi-chain support and auto-refresh.",
+      }}
+      code={`import { Bridge } from "thirdweb";
+import { useQuery } from "@tanstack/react-query";
+
+function App() {
+  const { data: tokens } = useQuery({
+    queryKey: ["tokens", chainId],
+    queryFn: () =>
+      Bridge.tokens({
+        client: THIRDWEB_CLIENT,
+        chainId: 1, // Ethereum
+        limit: 15,
+        sortBy: "market_cap",
+        includePrices: true,
+      }),
+    refetchInterval: 30_000, // auto-refresh every 30s
+  });
+
+  return tokens?.map((token) => (
+    <div key={token.address}>
+      <img src={token.iconUri} alt={token.name} />
+      <span>{token.name} ({token.symbol})</span>
+      <span>\${token.prices?.usd?.toFixed(2)}</span>
+      <span>MCap: {token.marketCapUsd}</span>
+      <span>Vol: {token.volume24hUsd}</span>
+    </div>
+  ));
+}`}
+      lang="tsx"
+      preview={<TokenPriceTrackerPreview />}
+    />
+  );
+}