diff --git a/docs.json b/docs.json
index d98ae25..66a29ab 100644
--- a/docs.json
+++ b/docs.json
@@ -91,6 +91,12 @@
               "runtime/messaging",
               "runtime/sessions-api"
             ]
+          },
+          {
+            "group": "TOKEN",
+            "pages": [
+              "tokenomics"
+            ]
           }
         ]
       },
diff --git a/index.mdx b/index.mdx
index bccf74d..d0033fd 100644
--- a/index.mdx
+++ b/index.mdx
@@ -3,6 +3,15 @@ title: Overview
 description: 'Build autonomous AI agents with the most popular agentic framework'
 ---
 
+<Card
+  title="$elizaOS Token Information"
+  icon="coins"
+  href="/tokenomics"
+  color="#0B35F1"
+>
+  Learn about $elizaOS tokenomics, contract addresses, vesting schedules, and token release details
+</Card>
+
 ## What is elizaOS?
 
 elizaOS is a TypeScript framework for building AI agents that can think, learn, and act autonomously. Create agents with unique, persistent personalities, equip them with plugins to interact with the world, and let them work toward their goals independently.
diff --git a/tokenomics.mdx b/tokenomics.mdx
new file mode 100644
index 0000000..74780d8
--- /dev/null
+++ b/tokenomics.mdx
@@ -0,0 +1,78 @@
+---
+title: Tokenomics
+description: Key information about the $elizaOS token economics, contract addresses, vesting schedules, and token release details
+---
+
+See below key information about the $elizaOS tokenomics.
+
+## Contract Addresses
+
+<Info>
+$elizaOS is available on multiple chains with cross-chain functionality enabled from day one.
+</Info>
+
+**$elizaOS SVM:** `DuMbhu7mvQvqQHGcnikDgb4XegXJRyhUBfdU22uELiZA`
+
+**$elizaOS EVM (ETH & Base & BSC):** `0xea17Df5Cf6D172224892B5477A16ACb111182478`
+
+**Token Standards:** BEP-20 (BSC), ERC-20 (Ethereum, Base) and SPL (Solana). CCIP enabled day one.
+
+**Total Supply:** 11,000,000,000
+
+**Circulating Supply:** 7,482,200,000 (as of November 11, 2025)
+
+## Vesting and Transparency
+
+All token allocations follow structured vesting schedules with built-in transparency mechanisms:
+
+<Steps>
+  <Step title="Ecosystem/Community">
+    3-month cliff + 9-month linear vest
+  </Step>
+  
+  <Step title="Foundation">
+    24-month linear vest
+  </Step>
+  
+  <Step title="Team & Contributors">
+    12-month cliff from October 21, then 24-month linear vest (total 36 months)
+  </Step>
+  
+  <Step title="SAFT">
+    Locked multisig, minimum 12-month cliff
+  </Step>
+  
+  <Step title="Liquidity & POL">
+    Programmatic for market making
+  </Step>
+</Steps>
+
+<Note>
+**Monitoring:** All vesting wallets will be publicly listed with explorer links for real-time tracking. Streamflow contracts enforce cliffs and prevent discretionary early unlocks.
+</Note>
+
+## Token Release Schedule
+
+After the migration from `$ai16z` to `$elizaOS`, the `$elizaOS` total supply will gradually expand from 6.6B to 11B (+40%), with circulating supply increasing by 882M, from 6.6B to 7.4B (approximately +13%) immediately.
+
+This unlocks capital for increased liquidity demands of the token becoming multichain and funding ecosystem growth – including:
+
+- **607M tokens** for liquidity & listings
+- **275M tokens** of Protocol Owned Liquidity
+
+<Warning>
+Over time, total supply could expand to up to 11B tokens, though actual circulating supply may be less as a large portion is held by the Foundation and Treasury for ecosystem development and liquidity management.
+</Warning>
+
+## Change Log
+
+### v1.0 - November 6, 2025
+
+**Description:** Migration from `$ai16z` to `$elizaOS` started
+
+---
+
+### v1.1 - November 11, 2025
+
+**Description:** Introduction of `$ai16z` snapshot at 11:40am UTC
+