Telegram

Canton Venues / Build

Build on Canton Venues

Live market data for every Canton trading venue, for your wallet, router, dashboard or agent: a JSON API, an MCP server and an open-source SDK. No key, no sign-up, cross-origin enabled, refreshed every five minutes. The API, the MCP server, the history and the code stay open and key-free.

Start with one call

Pick the one that matches what you build. Each answer is plain JSON over GET; open it in a browser to see it live. In the code, API is https://cantonvenues.com/api/v1.

A wallet or a swap screen

The best venue for this swap

The same trade priced on every venue by its best route on its own markets, one swap or two: pool and book fees, price impact and each venue's network fee included. best_venue is the one that returns the most after its network fee.

GET https://cantonvenues.com/api/v1/quote?sell=CC&buy=USDCx&amount_usd=1000
Open the live answer

JavaScript

const url = API + "/quote?sell=CC&buy=USDCx&amount_usd=1000";
const q = await fetch(url).then((r) => r.json());
q.best_venue;  // the venue to route to
q.by_venue[q.best_venue].after_network_fee;  // USDCx out

Python

import requests
q = requests.get(f"{API}/quote", params={
    "sell": "CC", "buy": "USDCx", "amount_usd": 1000}).json()
best = q["by_venue"][q["best_venue"]]
q["best_venue"], best["after_network_fee"]

Any size: amount in the token you sell, or amount_usd. Computed on request, 30 a minute per IP.

A router, an aggregator or a DCA product

Your fill against the best venue at its time

Give a trade you made and its time. It is priced again on every venue from the market as we read it at the five-minute readings either side, and shortfall_bps says how far your fill fell short of the best venue. Nothing is executed or stored.

GET https://cantonvenues.com/api/v1/check?sell=CC&buy=USDCx&amount_in=10000&amount_out=985&time=2026-10-28T07:05:00Z&venue=cantex
Open the live answer

JavaScript

const iso = "2026-10-28T07:05:00Z";  // when it filled
const url = API + "/check?sell=CC&buy=USDCx&amount_in=10000"
  + "&amount_out=985&venue=cantex&time=" + iso;
const c = await fetch(url).then((r) => r.json());
c.best_venue, c.shortfall_bps;  // your gap in bp

Python

c = requests.get(f"{API}/check", params={
    "sell": "CC", "buy": "USDCx", "amount_in": 10000,
    "amount_out": 985, "venue": "cantex",
    "time": "2026-10-28T07:05:00Z"}).json()
c["best_venue"], c["shortfall_bps"]

time as ISO (2026-10-28T07:05:00Z) or unix seconds; the record starts 27 Oct 2026.

Lending, vaults and risk

What collateral sells for on Canton

For every token: what selling it for USDCx nets as a share of its value, from $1K to $1M, per venue and at the best one; the largest sale each venue and all of them together take within 1%, 2% and 5%, and what limited it (the cost, or the end of a visible order book).

GET https://cantonvenues.com/api/v1/exit.json
Open the live answer

JavaScript

const x = await fetch(API + "/exit.json").then((r) => r.json());
const cbtc = x.tokens.find((t) => t.symbol === "CBTC");
cbtc.capacity_usd["2pct"].all_venues;  // $ within 2%

Python

x = requests.get(f"{API}/exit.json").json()
cbtc = next(t for t in x["tokens"] if t["symbol"] == "CBTC")
cbtc["capacity_usd"]["2pct"]["all_venues"]

Refreshed every five minutes; worst keeps the lowest share at $10K and $50K since worst_since.

Analytics and research

Volume and history you can check

Every venue's daily spot volume for the last 30 closed UTC days with each day's records side by side (the venue's own, our midnight reading of its 24-hour counter, an outside record) and whether they agree within 5%. Eight days of prices and premiums in five-minute steps in history.json.

GET https://cantonvenues.com/api/v1/volume.json
Open the live answer

JavaScript

const v = await fetch(API + "/volume.json").then((r) => r.json());

Python

v = requests.get(f"{API}/volume.json").json()

Every file and field: the endpoint list and llms.txt.

An AI agent

The same data over MCP

Add it in Claude as a custom connector, or in any MCP client as a streamable HTTP server. Read-only, no key. Tools: market_overview, list_tokens, token, quote, premiums, spreads, alerts, pools, venues, perps, exit_cost, check_trade.

https://cantonvenues.com/mcp

A Canton venue

Be read from your own feed

We read public APIs only. A public quote endpoint lets us check our math against your own engine every hour, as we do for Tradecraft, Cantex and OneSwap (quotecheck.json). A venue is an adapter in the open-source SDK; a pull request that adds yours is welcome, or register and point us to your docs.

Register your app

  • Notice before a breaking change, at least 14 days ahead, to the contact you give. A new field never breaks anything; removing or renaming a field or a file, or changing what one means, does.
  • Direct help. A question about a field, a route or a number gets a reply within a day.
  • What you need next. Ask for a pair, a field or a view; tell us what breaks for you.
  • A listing on this page if you want one, in your own words.

Registering is optional: the API is the same with it or without it. Your contact is used only to reach you about the data.

What you use