Build on Topaz

Topaz DEX developer resources

Build on Topaz across BNB Chain, Robinhood Chain, Base, Ethereum and Arc: public analytics, deployed contracts, xTOPAZ integration, protocol guides and agent resources. API market requests are chain-qualified; contract addresses must match their deployment network.

Explore the API Integration guide Contract addresses →

Build for the hub and spokes

Network availability: live BNB Chain, Robinhood Chain, Base, Ethereum and Arc deployments.
Multichain integration: deployment bundles, xTOPAZ vault and OFT groups, local position IDs, receipts and indexing.
xTOPAZ economics: canonical share supply, per-spoke budgets and backing growth.
Liquidity zaps: single-token Concentrated deposits on BNB Chain, Robinhood Chain, Base, Ethereum and Arc (ERC-20 only), distinct from the xTOPAZ vault zap.

DEX, voting, bridging and zaps activate separately. Use the multichain API’s /v1/chains registry, chain-qualified market and account endpoints, and published observation metadata. Compatibility reports remain separately scoped.

Analytics API

Topaz DEX public analytics API

Read-only, CORS-enabled JSON over HTTPS — no API key required. Chain-scoped observations report coverage and freshness through endpoint-specific observation metadata.

Versioned endpoints return structured JSON with endpoint-specific data and metadata. Validate the schema for the endpoint you use:

bash

# Discover available networks
curl -s https://api.topazdex.com/v1/chains
# Combined protocol metrics
curl -s https://api.topazdex.com/v1/protocol
# Arc pool discovery, including uncurated pools
curl -s 'https://api.topazdex.com/v1/pools?chainIds=5042&scope=all'

Topaz DEX OpenAPI spec

→

OpenAPI 3.1 document describing every public analytics endpoint. Feed it to codegen, agents, or API clients.

api.topazdex.com/openapi.json

Topaz DEX API docs (Swagger UI)

→

Human-browsable reference with "Try it out" against live data.

api.topazdex.com/docs

API catalog (RFC 9727)

→

Linkset discovery document pointing at the spec, docs, and agent manifest.

/.well-known/api-catalog

Data API guide

→

Narrative guide to the analytics API: envelope, freshness, pagination, examples.

/docs/developers/data-api

Integration guide

→

Quotes, swap calldata, subgraphs, and on-chain integration patterns.

/docs/developers/integration

Deployed contracts

→

Deployed contracts on BNB Chain, Robinhood Chain, Base, Ethereum and Arc, with explorer links.

/docs/contracts

Agent Surfaces

Machine-readable by default

Agents get first-class entry points: an llms.txt site index, an installable agent skill, and markdown content negotiation on every page — request any page with Accept: text/markdown and the site returns a clean markdown rendition instead of HTML.

bash

# Any page on the site, as markdown (acceptmarkdown.com convention)
curl -s -H "Accept: text/markdown" https://www.topazdex.com/docs/overview

llms.txt

→

Machine-readable site index: docs, dashboards, and API endpoints, one line each.

www.topazdex.com/llms.txt

Agent skill guide

→

Full agent instructions for swaps, pools, gauges, bribes, and veNFTs.

www.topazdex.com/skill.md

Agent skill manifest

→

Machine-readable skill metadata: version, install, verify, compatibility.

www.topazdex.com/skill.json

Topaz for AI agents

→

The Topaz Agent (chat, MCP, A2A) and how to install the agent skill.

/agents

Shortcuts

Predictable URLs

The common guesses resolve. Each of these redirects to its canonical location:

Shortcut	Resolves to
/api-docs	https://api.topazdex.com/docs
/openapi.json	https://api.topazdex.com/openapi.json
/docs/api	/docs/developers/data-api