# Topaz DEX

> Topaz is an omnichain exchange combining trading fees, token emissions and voting rewards with token trading, stable/volatile and concentrated liquidity, veTOPAZ governance, protocol documentation and public analytics at https://www.topazdex.com. BNB Chain (56) is the hub; Robinhood Chain (4663), Base (8453), Ethereum (1) and Arc (5042) are live spokes. xTOPAZ entry, redemption, bridging and local voting are enabled. Fee APR and Emissions APR are separate yield modes. Planned networks are not live deployments.

[Fee earning](https://www.topazdex.com/explore/pools?earning=fees) and [emissions](https://www.topazdex.com/explore/pools?earning=emissions) open the existing pool list with context and the relevant APR sort. They add no emissions-only filter. The [homepage Markdown](https://www.topazdex.com/markdown) explains these paths, market-example selection and security-review scope.

Topaz DEX, Topaz Dex, and Topaz refer to this protocol. TOPAZ is the BNB token; veTOPAZ is a BNB vote-escrow NFT; xTOPAZ is a transferable share backed by an aggregate permanent veTOPAZ lock on BNB. Spoke voting uses staked xTOPAZ positions, not BNB veNFTs. Redeeming xTOPAZ on BNB creates a new permanent veTOPAZ NFT, not immediately liquid TOPAZ. Liquidity fees, gauge emissions, and voter incentives are distinct returns. A gauge-staked concentrated liquidity position earns emissions only while in range.

Use the published documentation and Markdown export for explanations, the public `/v1` API for current indexed data, the contracts page for chain-specific addresses, and fresh contract state for transaction preconditions. Check chain ID, source timestamps, response coverage, and feature availability before making current claims. An analytics snapshot or an index link does not authorize a transaction. Execution requires explicit user authorization and an authorized signing path.

## Agent resources

- [Skill guide](https://www.topazdex.com/skill.md): full GitHub-synchronized Topaz skill, with a committed fallback.
- [Skill manifest](https://www.topazdex.com/skill.json): version, capabilities, install and verification metadata.
- [Skill discovery](https://www.topazdex.com/.well-known/agent-skill.json): stable discovery document.
- [Full documentation](https://www.topazdex.com/llms-full.txt): complete published articles in one Markdown document.
- [API catalog](https://www.topazdex.com/.well-known/api-catalog): OpenAPI and service documentation discovery.
- [Sitemap](https://www.topazdex.com/sitemap.xml): canonical public pages and indexed pools.
- [Skill repository](https://github.com/topazdex/agent-skill): references, scripts and examples.
- [Latest release](https://github.com/topazdex/agent-skill/releases/latest): installable releases.
- [Changelog](https://github.com/topazdex/agent-skill/blob/main/CHANGELOG.md): published skill changes.
- [Topaz Agent](https://agents.topazdex.com): the separately hosted agent service.

## Agent protocols and public subdomains

- [Topaz Agent OpenAPI](https://agents.topazdex.com/openapi.json): machine-readable schema for the hosted agent service; check which operations and networks the service currently supports.
- [Topaz Agent A2A card](https://agents.topazdex.com/.well-known/agent-card.json): agent-to-agent discovery and capability metadata.
- [Topaz Agent MCP](https://agents.topazdex.com/mcp): Model Context Protocol service endpoint; use its documented protocol rather than crawling it as an article.
- [Topaz Agent sitemap](https://agents.topazdex.com/sitemap.xml): public pages on the separately hosted agent subdomain.
- [Topaz ID](https://id.topazdex.com/): identity, profile and wallet-connection service, separate from DEX trading and voting contracts.
- [Topaz ID connector guide](https://github.com/topazdex/agent-skill/blob/main/developers/topaz-id-connect.md): developer integration for Topaz ID account and signing flows.
- [Topaz quote service guide](https://github.com/topazdex/agent-skill/blob/main/references/swapping-api.md): supported quote and swap-batch workflow for `quote.topazdex.com`; the service root is not a documentation page.

## Public app and market pages

- [Topaz DEX](https://www.topazdex.com/): An omnichain decentralized exchange built for participation. Swap tokens, supply liquidity or put your voting power to work earning fees and rewards.
- [Swap](https://www.topazdex.com/swap): Trade tokens on BNB Chain, Robinhood Chain, Base, Ethereum and Arc.
- [Private swaps](https://www.topazdex.com/swap/privacy): Private swap funding, payout and tracking.
- [Explore pools](https://www.topazdex.com/explore/pools): Pool discovery and shared pool detail pages.
- [Explore tokens](https://www.topazdex.com/explore/tokens): Token discovery and market pages.
- [Liquidity positions](https://www.topazdex.com/positions): Manage wallet liquidity and staking.
- [veTOPAZ locks](https://www.topazdex.com/locks): Vote-escrow locks and governance.
- [Vote](https://www.topazdex.com/vote): Voting opportunities and allocations.
- [Incentives](https://www.topazdex.com/incentivize): Pool voting incentives.
- [Relays](https://www.topazdex.com/relays): Managed voting positions.
- [xTOPAZ](https://www.topazdex.com/xtopaz): Get, bridge and redeem xTOPAZ; stake and vote on Robinhood Chain, Base, Ethereum or Arc.
- [Public analytics | Topaz DEX](https://www.topazdex.com/stats): Combined and network-filtered Topaz liquidity, volume, fees and pool analytics.
- [Pool analytics | Topaz DEX](https://www.topazdex.com/stats/pools): All Topaz pools, ranked by TVL, volume, fees and APR.
- [Foundation transparency | Topaz DEX](https://www.topazdex.com/stats/foundation): Foundation wallet, veTOPAZ holdings, votes, incentives and effectiveness.
- [Pool fee performance | Topaz DEX](https://www.topazdex.com/stats/dynamic-fees): Observed custom and dynamic pool fees across Topaz networks.
- [TOPAZ token | Topaz DEX](https://www.topazdex.com/topaz): TOPAZ price, supply, protocol activity and liquidity across TOPAZ markets.
- [PFP Generator | Topaz DEX](https://www.topazdex.com/tool/pfp): Frame your profile photo with the Topaz ring. Upload, position, and download a square PNG.
- [Topaz Auto liquidity management | Topaz DEX](https://www.topazdex.com/alm): How Topaz Auto keeps concentrated liquidity in range, what it costs and risks, and every managed market read live from chain.
- [Agents](https://www.topazdex.com/agents): Topaz Agent and protocol skill resources, with service capability boundaries and guides to live multichain and xTOPAZ integration.
- [Developers](https://www.topazdex.com/developers): Topaz developer resources for BNB and live spokes: Stats API, contracts, xTOPAZ integration, indexing and agent discovery.
- [Methodology](https://www.topazdex.com/stats/methodology): Multichain analytics sources, rolling windows, network filters, APRs and data coverage.

## Documentation: start here

- [Docs](https://www.topazdex.com/docs): Topaz documentation: multichain swaps and liquidity, veTOPAZ locks, xTOPAZ bridging and voting across the five live networks.
- [Overview](https://www.topazdex.com/docs/overview): Topaz is a multichain DEX with a BNB token hub, V2 and Concentrated liquidity, and xTOPAZ for local spoke voting.
- [Quick Start](https://www.topazdex.com/docs/quickstart): Get started with swaps and liquidity across Topaz networks, veTOPAZ locks, xTOPAZ bridging and local voting.
- [FAQ](https://www.topazdex.com/docs/faq): Answers about Topaz networks, BNB and spoke availability, xTOPAZ, wallets, fees, locks, bridging and local voting.
- [Glossary](https://www.topazdex.com/docs/glossary): Topaz terminology: TOPAZ, veTOPAZ, xTOPAZ, hub and spokes, shares, local voting positions, bridging, gauges, pools and epochs.
- [AMM & Pool Types](https://www.topazdex.com/docs/concepts/amm): How automated market makers work, the difference between Topaz's stable and volatile v2 pools, and where concentrated liquidity fits in.
- [Concentrated Liquidity](https://www.topazdex.com/docs/concepts/concentrated-liquidity): How Slipstream concentrated liquidity works on Topaz: ticks, price ranges, capital efficiency, active vs out-of-range positions, tick spacing tiers, and the trade-offs of tight vs wide ranges.
- [Impermanent Loss](https://www.topazdex.com/docs/concepts/impermanent-loss): Impermanent loss explained: why LP returns can diverge from holding, how it differs in v2 vs Slipstream, and how fees, incentives, and range selection offset it on Topaz.
- [Oracles & TWAP](https://www.topazdex.com/docs/concepts/oracles): Slipstream's in-pool oracle, time-weighted average prices (TWAP), chain-specific observation capacity with BNB sizing examples, and dynamic fees.

## Documentation: trading, liquidity and governance

- [Swaps & Routing](https://www.topazdex.com/docs/trading/swaps): Topaz and 0x routing, exact input/output, cross-chain swaps, Permit2 approvals, native wrapping and route-specific fees.
- [Providing Liquidity](https://www.topazdex.com/docs/liquidity): Add liquidity to Topaz v2 stable and volatile pools, mint LP tokens, withdraw, and prepare to stake in gauges. The starting point for LPs on Topaz.
- [Concentrated Positions](https://www.topazdex.com/docs/liquidity/concentrated): Mint, manage, and close Slipstream concentrated-liquidity positions on Topaz: tick spacings, ranges, the NonfungiblePositionManager, fee collection, and staking the NFT in a gauge.
- [Pool Fees](https://www.topazdex.com/docs/liquidity/fees): Topaz pool fees explained: default v2 and Slipstream fees, custom per-pool overrides, dynamic volatility-based fees, unstaked position fees, and where fees flow on the ve(3,3) wheel.
- [Staking in Gauges](https://www.topazdex.com/docs/liquidity/staking): Stake V2 LP tokens or Concentrated NFTs for TOPAZ on BNB or xTOPAZ on activated spokes; compare fees, emissions and custody.
- [TOPAZ & Emissions](https://www.topazdex.com/docs/tokenomics): TOPAZ issuance and veTOPAZ rebases on BNB, plus how xTOPAZ extends the same economy to spoke liquidity incentives.
- [veTOPAZ Locks](https://www.topazdex.com/docs/tokenomics/vetopaz): BNB veTOPAZ lock rules and optional xTOPAZ wrapping: voting power, custody, permanent mode, reward claims and redemption.
- [Gauge Voting](https://www.topazdex.com/docs/gauges): BNB veTOPAZ and spoke xTOPAZ gauge voting: local allocations, epochs, fee and incentive rewards, resets and availability.
- [Incentives (Bribes)](https://www.topazdex.com/docs/voting/incentives): How bribe / incentive markets work on Topaz: depositing rewards to a gauge, when voters claim, ROI strategies for both sides, and the whitelisted token rule.
- [Managed Locks](https://www.topazdex.com/docs/voting/managed): Managed veNFTs on Topaz: how small veTOPAZ holders pool into a single managed lock for passive participation, how managers earn fees, and how to deposit and withdraw.
- [Protocol Governance](https://www.topazdex.com/docs/governance): BNB ProtocolGovernor and EpochGovernor, plus separate vault, bridge, budget and spoke administration in the multichain design.
- [Single-token liquidity zaps](https://www.topazdex.com/docs/liquidity/zaps): Create a concentrated liquidity position from one funding token, and distinguish CL zaps from xTOPAZ entry and bridge actions.

## Documentation: developers and agents

- [Integration Guide](https://www.topazdex.com/docs/developers/integration): Integrate live Topaz deployments across BNB Chain, Robinhood Chain, Base, Ethereum and Arc: pools, gauges, routing, token listing and xTOPAZ.
- [Data API](https://www.topazdex.com/docs/developers/data-api): Multichain API coverage and the legacy BNB Stats API reference: endpoints, schemas, freshness and period definitions.
- [Agents](https://www.topazdex.com/docs/agents): Topaz Agent and installable skill: BNB examples, capability checks and the new multichain documentation.
- [Runtimes & Install](https://www.topazdex.com/docs/agents/runtimes): Install the Topaz agent skill into Claude Code, Codex, Cursor, Continue, OpenCode, Hermes, or any URL-reading agent. Conventional locations, prompts, and the auto-detect installer.
- [Capabilities](https://www.topazdex.com/docs/agents/capabilities): What an AI agent can do with the Topaz skill. Example prompts grouped by workflow: quoting, swapping, liquidity, gauges, voting, bribes, and claiming.
- [Safety Model](https://www.topazdex.com/docs/agents/safety): How the Topaz agent skill stays safe by default. The four output labels, broadcast consent, slippage handling, approvals, and how to enforce read-only mode.
- [Topaz Agent](https://www.topazdex.com/docs/agents/topaz-agent): The Topaz Agent is a live, non-custodial DeFi strategist for the Topaz protocol on BNB Chain. Chat with it, integrate via MCP or OpenAPI, or connect agent-to-agent.
- [Multichain integration](https://www.topazdex.com/docs/developers/multichain): Chain-scoped contracts, xTOPAZ shares, spoke position IDs, bridge evidence and data requirements for Topaz integrations.

## Documentation: contracts, analytics and safety

- [Contracts](https://www.topazdex.com/docs/contracts): Topaz contract addresses on BNB Chain, Robinhood Chain, Base, Ethereum and Arc: tokens, DEX, xTOPAZ vault, bridge, voting, routers and zaps.
- [Security & Audits](https://www.topazdex.com/docs/security): BNB audit scope, separate multichain and CL Zap verification limits, xTOPAZ custody, bridge risks and per-chain administrative controls.
- [Airdrop & Sacrifice](https://www.topazdex.com/docs/airdrop): How Topaz seeded its initial veTOPAZ supply: the pre-mainnet airdrop snapshot and the Abstract-chain sacrifice event. Mechanics, caps, and final distribution details.
- [Bonus Lock](https://www.topazdex.com/docs/bonuslock): The BNB Bonus Lock program, its historical tier schedule and permanent-lock output; current allocation is shown on the lock creation page.
- [Stats Overview](https://www.topazdex.com/docs/stats): Multichain market analytics and legacy BNB reports: source freshness, rolling versus UTC-day figures and xTOPAZ accounting.
- [Rate Definitions](https://www.topazdex.com/docs/stats/rates): Every APR and APY Topaz publishes, defined: what it measures, which asset pays it, the period it covers, how it is annualized, and whether trading fees are included.
- [Private Swaps](https://www.topazdex.com/docs/privacy): Private swaps across supported EVM source and payout networks, integrated tracking, EOA funding and BNB USDC refund boundaries.
- [Do a Private Swap](https://www.topazdex.com/docs/privacy/swap): Fund a private swap on its selected EVM network, review one recipient, submit the deposit and track destination delivery.
- [Order History](https://www.topazdex.com/docs/privacy/history): Recent private orders, browser and wallet scope, source transaction hashes and integrated or hosted tracking.
- [Recovery & Refunds](https://www.topazdex.com/docs/privacy/recovery): Check private-swap recovery and refund eligibility; eligible refunds return USDC on BNB, regardless of the funding network.
- [Privacy Policy](https://www.topazdex.com/privacy): How Topaz DEX collects, uses, and protects information across our marketing site, documentation, analytics, agent services, and the Topaz decentralized exchange.
- [Terms of Service](https://www.topazdex.com/terms): The terms governing the Topaz site, documentation, analytics, agent services and decentralized exchange across supported networks.

## Documentation: multichain and xTOPAZ

- [Topaz across networks](https://www.topazdex.com/docs/multichain): Topaz is live on BNB Chain, Robinhood Chain, Base, Ethereum and Arc. Learn how xTOPAZ connects local liquidity, bridging and voting.
- [xTOPAZ explained](https://www.topazdex.com/docs/xtopaz): xTOPAZ shares in permanently locked TOPAZ: how backing, rebases, bridging and local voting fit together.
- [Get xTOPAZ](https://www.topazdex.com/docs/xtopaz/get): Deposit TOPAZ or wrap an eligible veTOPAZ lock on BNB, with share previews, reward claims and approval scope explained.
- [Bridge xTOPAZ](https://www.topazdex.com/docs/xtopaz/bridge): Move xTOPAZ through the BNB hub, understand messaging fees and bridge precision, and distinguish source confirmation from delivery.
- [Stake xTOPAZ and vote](https://www.topazdex.com/docs/xtopaz/staking): Spoke voting positions, the full-epoch withdrawal lock, local allocations, fees, incentives and closed-position claims.
- [Redeem xTOPAZ](https://www.topazdex.com/docs/xtopaz/redeem): Redeem liquid xTOPAZ on BNB for a new permanent veTOPAZ NFT, including the system-vote window and share-to-asset review.
- [Multichain emissions](https://www.topazdex.com/docs/multichain/emissions): How the BNB system gauge funds xTOPAZ budgets for local spoke gauges without introducing separate TOPAZ inflation schedules.

## Documentation: other

- [Topaz Auto](https://www.topazdex.com/docs/auto): Managed concentrated liquidity: one vault per pool keeps its range around the market, with emissions passed through as claimable TOPAZ or xTOPAZ.
- [Topaz Auto: deposit, withdraw and claim](https://www.topazdex.com/docs/auto/using): Enter a Topaz Auto vault with both tokens or one, withdraw in kind at any time, and claim emissions separately.
- [Topaz Auto risks and numbers](https://www.topazdex.com/docs/auto/risks): The risks managed concentrated liquidity keeps, and how managed value, Auto APR and time in range are computed.

## API and representations

- [Network registry](https://api.topazdex.com/v1/chains): supported chains, capabilities and source status.
- [API reference](https://api.topazdex.com/docs): interactive reference on the API service.
- [Complete API schema](https://api.topazdex.com/openapi.json): API service schema, including implemented /v1 routes.
- [Protocol snapshot](https://api.topazdex.com/v1/protocol): metrics with source freshness.
- [Pools](https://api.topazdex.com/v1/pools): public pool snapshots.
- [Gauges](https://api.topazdex.com/v1/gauges): gauges and distinct APRs.
- [Supply](https://api.topazdex.com/api/supply/topaz): TOPAZ supply.
- [CMC pairs](https://api.topazdex.com/api/v1/cmc/pairs): public market integration.

Published articles, the homepage and public analytics support `Accept: text/markdown` and `/markdown/<path>`. For example, [the overview in Markdown](https://www.topazdex.com/markdown/docs/overview) is a clean text representation of the [canonical overview](https://www.topazdex.com/docs/overview). Interactive wallet pages are linked above; their wallet state is not exported as public Markdown. `/markdown` is the homepage rendition. Unknown renditions return a Markdown 404 with recovery links.

The API is served from `api.topazdex.com`; the website's `/api/...` URLs are compatibility forwards for older clients. Availability and supported deployments must be established from API responses; an index entry does not establish production readiness. Unavailable data is not zero. `/privacy` is the policy; private swaps are at `/swap/privacy`. Old `/stats/pools/{address}` links resolve to `/explore/pools/bnb/{address}`. Each subdomain has its own crawl policy. This file is a discovery guide, not an access grant or a substitute for a sitemap or `robots.txt`.