Build on Topaz
One page for everything you need to build on Topaz DEX: the public analytics REST API with an OpenAPI 3.1 spec, protocol documentation, deployed contract addresses on BNB Chain, and the agent integration surfaces (llms.txt, agent skill, markdown content negotiation).
Analytics API
Read-only, CORS-enabled JSON over HTTPS — no API key required. A snapshot pipeline refreshes every 15 minutes; every response reports its own freshness via meta.snapshotAt.
Every response — success or error — uses the same envelope, so one parser handles both:
# Success
curl -s https://www.topazdex.com/api/stats/protocol
# → { "ok": true, "data": { ... }, "meta": { "chainId": 56, "snapshotAt": "..." } }
# Errors are structured JSON too — never HTML
curl -s https://www.topazdex.com/api/stats/pools/not-an-address
# → { "ok": false, "error": { "code": "invalid_pool_id", "message": "..." }, "meta": { ... } }
curl -s https://www.topazdex.com/api/does-not-exist
# → 404 { "ok": false, "error": { "code": "endpoint_not_found", "hint": "...", "docs": "..." } }OpenAPI 3.1 document describing every public analytics endpoint. Feed it to codegen, agents, or API clients.
www.topazdex.com/api/stats/openapi.jsonHuman-browsable reference with "Try it out" against live data.
www.topazdex.com/api/stats/docsLinkset discovery document pointing at the spec, docs, and agent manifest.
/.well-known/api-catalogNarrative guide to the analytics API: envelope, freshness, pagination, examples.
/docs/developers/data-apiQuotes, swap calldata, subgraphs, and on-chain integration patterns.
/docs/developers/integrationEvery core and Slipstream contract address on BNB Chain, with verified BscScan links.
/docs/contractsAgent Surfaces
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.
# Any page on the site, as markdown (acceptmarkdown.com convention)
curl -s -H "Accept: text/markdown" https://www.topazdex.com/docs/overviewMachine-readable site index: docs, dashboards, and API endpoints, one line each.
www.topazdex.com/llms.txtFull agent instructions for swaps, pools, gauges, bribes, and veNFTs.
www.topazdex.com/skill.mdMachine-readable skill metadata: version, install, verify, compatibility.
www.topazdex.com/skill.jsonThe Topaz Agent (chat, MCP, A2A) and how to install the agent skill.
/agentsShortcuts
The common guesses resolve. Each of these redirects to its canonical location:
| Shortcut | Resolves to |
|---|---|
| /api-docs | /api/stats/docs |
| /openapi.json | /api/stats/openapi.json |
| /docs/api | /docs/developers/data-api |