# Canton Venues

> Live, read-only market data for the trading venues on the Canton Network: the same trade compared across venues at four sizes after each venue's network fee, Canton prices against outside markets, cross-venue spreads, pools and perps. Open JSON API and an MCP server, no key, no sign-up, cross-origin enabled.

Venues read: Temple, Cantex, Tradecraft, OneSwap, Pool Party, Rocky (spot and perps), Ekiden (perps). Snapshots refresh every five minutes. Nothing is signed or executed. Source: https://github.com/olevasyliev/canton-venues-sdk (open source).

## JSON API

Base URL: https://cantonvenues.com/api/v1/ (opening it returns this endpoint list as JSON). Every snapshot file carries `t`, the unix time of its snapshot (alerts.json and desk.json are running records; history.json's `t` is the list of its sample times). Amounts in USD unless a field name says otherwise.

- [summary.json](https://cantonvenues.com/api/v1/summary.json): Canton Coin price, ecosystem figures, how many tokens and venues are priced, and the pools marked not trading
- [tokens.json](https://cantonvenues.com/api/v1/tokens.json): every token: price, liquidity, 24h volume, 24h change (none for a token that traded under $1K in 24h), 7d change, the venues it trades on, 7-day hourly sparkline
- [execution.json](https://cantonvenues.com/api/v1/execution.json): best execution: every venue quoted at $100, $1K, $10K and $50K, both directions, each by its best route on its own markets (one swap or two), net of each venue's network fee (`network_fee` documents the fee per venue and whether it was measured or assumed); `market_mid` is the market price sizes are converted at, `not_trading` names pools left out
- [premium.json](https://cantonvenues.com/api/v1/premium.json): each asset's Canton price against its outside reference (CoinGecko; gold and silver spot from Ekiden's index while the spot market trades) or its $1 peg, overall and per venue; a token that traded under $1K in 24h shows no figure
- [scan.json](https://cantonvenues.com/api/v1/scan.json): every cross-venue round trip at its best size, after costs
- [spreads.json](https://cantonvenues.com/api/v1/spreads.json): daily spread study: how long cross-venue spreads live
- [alerts.json](https://cantonvenues.com/api/v1/alerts.json): active alerts and the feed of every alert fired (spreads, pegs, premiums)
- [venues.json](https://cantonvenues.com/api/v1/venues.json): every Canton venue: type, 24h volume, what is read
- [venue_history.json](https://cantonvenues.com/api/v1/venue_history.json): per venue: daily volume and hourly readings
- [lp.json](https://cantonvenues.com/api/v1/lp.json): pools: liquidity, 24h volume, fee, fee APR
- [pools.json](https://cantonvenues.com/api/v1/pools.json): raw reserves of every CC pool, the pools of two other tokens a route can take, and order-book levels per venue, the inputs every quote is computed from; `not_trading` lists pools whose reserves stood still while their price left the market (in no price or comparison)
- [perps.json](https://cantonvenues.com/api/v1/perps.json): perp markets on Rocky and Ekiden: price, basis, funding, spread
- [history.json](https://cantonvenues.com/api/v1/history.json): eight days of prices and premiums in five-minute steps (large, ~1.2 MB)
- [desk.json](https://cantonvenues.com/api/v1/desk.json): the paper desk's full record: router and arbitrage simulated on live quotes
- [quotecheck.json](https://cantonvenues.com/api/v1/quotecheck.json): the hourly check of our pool math against the venues' own quote engines (Tradecraft, Cantex, OneSwap): every trade compared, the largest gap, and Cantex's network fee per pair
- [arkiv.json](https://cantonvenues.com/api/v1/arkiv.json): where the hourly record on Arkiv (Tiramisu testnet) lives: the quote check and the best-execution verdicts written each hour as readonly entities whose contents cannot be changed afterwards; the creator address, the query to read them, the latest entity of each kind
- [weekly.json](https://cantonvenues.com/api/v1/weekly.json): the rolling last-7-days volume card by venue and day
- [exit.json](https://cantonvenues.com/api/v1/exit.json): what selling each token for USDCx nets, as a share of its value at our price (0.98 = 2% lost to fees and price impact): a ladder from $1K to $1M per venue and at the best one; `capacity_usd`, the largest sale each venue (and `all_venues` together) takes within 1%, 2% and 5%, with `limited_by` saying whether the cost or the end of the venue's visible order book stopped it; `worst`, the lowest share at $10K and $50K since `worst_since`. For lending, vault and risk tools: what collateral sells for on Canton
- [volume.json](https://cantonvenues.com/api/v1/volume.json): every venue's daily spot volume for the last 30 closed UTC days with each day's records side by side (`venue_day`: the venue's own record of the day; `venue_24h`: our midnight reading of its 24-hour counter; `outside`: an outside daily record), `check` = agree (within 5%), differ or single, and Temple's volume per market. Trade counts and average trade size per venue and day are recorded and given on request (https://cantonvenues.com/#contact)

Computed on request (plain GET, JSON, no key; errors come back as `{"error": ...}` with HTTP 400):

- [/api/v1/quote](https://cantonvenues.com/api/v1/quote?sell=CC&buy=USDCx&amount_usd=25000)`?sell=&buy=&amount=` or `&amount_usd=`: any trade size priced on every venue now (the MCP quote tool)
- `/api/v1/check?sell=&buy=&amount_in=&amount_out=&time=&venue=`: a trade you made, priced again on every venue from the market as it stood at the five-minute ticks either side of `time` (ISO such as 2026-10-28T09:00:00Z, or unix seconds; kept since 27 Oct 2026). Returns `best_venue`, `best_after_network_fee`, `shortfall_bps` (how far your `amount_out` fell short of the best venue, at the reading least favourable to that), and with `venue` given, `venue_choice_bps` and `fill_vs_your_venue_bps`. Nothing is executed or stored

Example: `curl -s https://cantonvenues.com/api/v1/premium.json | jq '.assets[] | {symbol, premium}'`

## MCP

Streamable HTTP server at https://cantonvenues.com/mcp, read-only, no key. Add it in Claude as a custom connector, or in any MCP client as a streamable HTTP server.

Tools:
- market_overview(): Canton Coin price, spot volume by venue (our own reading), Canton TVL with its day, top movers, largest premiums, latest alerts
- list_tokens(sort_by="liquidity", limit=30): every token; sort_by liquidity, volume, change_24h, change_7d or premium
- token(symbol): one token: price on each venue, premium to its outside reference, its pools, 7 days of hourly prices
- quote(sell, buy, amount=None, amount_usd=None): price any amount on every venue by its best route on its own markets, one swap or two (as best execution compares them), pool and book fees and price impact included, before and after each venue's network fee
- premiums(kind="all"): Canton prices against outside markets and pegs; kind all, reference or peg
- spreads(limit=10): buy-on-one-venue, sell-on-another round trips at their best size, after network cost
- alerts(limit=20): peg breaks, premiums over 1%, hourly moves over 5%, spreads that clear their costs; newest last
- pools(sort_by="tvl", limit=20): CC pools on every AMM with liquidity, 24h volume, fee and fee APR, and any marked not trading; sort_by tvl, volume or apr
- venues(): every Canton venue: type, 24h volume, and whether it is priced live, volume only, or unreadable
- perps(base=None): perp markets on Rocky and Ekiden: price, basis, funding, spread, open interest; base e.g. BTC, ETH or CC
- exit_cost(symbol, amount_usd=None): what selling the token for USDCx nets at sizes from $1K to $1M, the largest sale within 1%, 2% and 5% per venue and in all, the worst share since the record began; with amount_usd, that sale priced now
- check_trade(sell, buy, amount_in, amount_out, time, venue=None): a trade you made against every venue at that time (same as /api/v1/check)

Example questions: "where is CBTC cheapest for $20K right now?", "how much CBTC can I sell on Canton within 2%?", "I sold 10,000 CC for 975 USDCx on Cantex at 09:00 UTC today: was that a good fill?"

## Building on it

Using the data in an app or an agent? https://cantonvenues.com/build/ has one call to start with for a wallet, a router or DCA product, a lending or risk tool and an analytics product, and a form to register the app (optional; the API is the same without it). Registered apps get notice at least 14 days before any breaking change (removing or renaming a field or a file, or changing what one means; a new field is never breaking), direct help, and a listing on that page if they want one.

## Pages

- [Dashboard](https://cantonvenues.com/): tokens, best execution, premiums, spreads, pools, perps, API
- [Build](https://cantonvenues.com/build/): one call to start with per kind of app, and app registration
- [Venues](https://cantonvenues.com/venues/): one page per venue with its strongest facts and a share card
- [Weekly](https://cantonvenues.com/weekly/): the last seven days of Canton DEX volume by venue
- [Telegram channel](https://t.me/cantonvenues): a weekday post and loud alerts

## Contact

The form at https://cantonvenues.com/#contact. Built by Oleksii Vasyliev (https://github.com/olevasyliev).