{
  "name": "Canton Venues open API",
  "about": "Live, read-only market data for Canton Network trading venues. No key, cross-origin enabled, refreshed every five minutes; every snapshot file carries t, the unix time of its snapshot (alerts and desk are running records; history's t is the list of its sample times).",
  "base": "https://cantonvenues.com/api/v1/",
  "endpoints": [
    {
      "name": "summary",
      "url": "https://cantonvenues.com/api/v1/summary.json",
      "about": "Canton Coin price, ecosystem figures, how many tokens and venues are priced, and the pools marked not trading"
    },
    {
      "name": "tokens",
      "url": "https://cantonvenues.com/api/v1/tokens.json",
      "about": "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"
    },
    {
      "name": "execution",
      "url": "https://cantonvenues.com/api/v1/execution.json",
      "about": "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"
    },
    {
      "name": "premium",
      "url": "https://cantonvenues.com/api/v1/premium.json",
      "about": "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"
    },
    {
      "name": "scan",
      "url": "https://cantonvenues.com/api/v1/scan.json",
      "about": "every cross-venue round trip at its best size, after costs"
    },
    {
      "name": "spreads",
      "url": "https://cantonvenues.com/api/v1/spreads.json",
      "about": "daily spread study: how long cross-venue spreads live"
    },
    {
      "name": "alerts",
      "url": "https://cantonvenues.com/api/v1/alerts.json",
      "about": "active alerts and the feed of every alert fired (spreads, pegs, premiums)"
    },
    {
      "name": "venues",
      "url": "https://cantonvenues.com/api/v1/venues.json",
      "about": "every Canton venue: type, 24h volume, what is read"
    },
    {
      "name": "venue_history",
      "url": "https://cantonvenues.com/api/v1/venue_history.json",
      "about": "per venue: daily volume and hourly readings"
    },
    {
      "name": "lp",
      "url": "https://cantonvenues.com/api/v1/lp.json",
      "about": "pools: liquidity, 24h volume, fee, fee APR"
    },
    {
      "name": "pools",
      "url": "https://cantonvenues.com/api/v1/pools.json",
      "about": "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)"
    },
    {
      "name": "perps",
      "url": "https://cantonvenues.com/api/v1/perps.json",
      "about": "perp markets on Rocky and Ekiden: price, basis, funding, spread"
    },
    {
      "name": "history",
      "url": "https://cantonvenues.com/api/v1/history.json",
      "about": "eight days of prices and premiums in five-minute steps (large, ~1.2 MB)"
    },
    {
      "name": "desk",
      "url": "https://cantonvenues.com/api/v1/desk.json",
      "about": "the paper desk's full record: router and arbitrage simulated on live quotes"
    },
    {
      "name": "quotecheck",
      "url": "https://cantonvenues.com/api/v1/quotecheck.json",
      "about": "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"
    },
    {
      "name": "arkiv",
      "url": "https://cantonvenues.com/api/v1/arkiv.json",
      "about": "where the hourly record on Arkiv (Tiramisu testnet) lives: each hour the quote check and the best-execution verdicts are written as readonly entities whose contents cannot be changed afterwards; the creator address, the query to read them, and the latest entity of each kind"
    },
    {
      "name": "weekly",
      "url": "https://cantonvenues.com/api/v1/weekly.json",
      "about": "the rolling last-7-days volume card by venue and day"
    },
    {
      "name": "exit",
      "url": "https://cantonvenues.com/api/v1/exit.json",
      "about": "what selling each token for USDCx nets, as a share of its value at our price: a ladder from $1K to $1M per venue and at the best one; the largest sale each venue (and all together) takes within 1%, 2% and 5%, with what limited it (the cost, or the end of a venue's visible order book); the worst share at $10K and $50K since worst_since"
    },
    {
      "name": "volume",
      "url": "https://cantonvenues.com/api/v1/volume.json",
      "about": "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 day record, our midnight reading of its 24-hour counter, an outside daily record), whether they agree within 5%, and Temple's volume per market; trade counts and average trade size are recorded and given on request"
    }
  ],
  "computed": [
    {
      "name": "quote",
      "url": "https://cantonvenues.com/api/v1/quote?sell=CC&buy=USDCx&amount_usd=25000",
      "about": "any trade size priced on every venue now, as the MCP quote tool (sell, buy, and amount or amount_usd)"
    },
    {
      "name": "check",
      "url": "https://cantonvenues.com/api/v1/check?sell=CC&buy=USDCx&amount_in=10000&amount_out=975&time=2026-10-27T21:30:00Z&venue=cantex",
      "about": "a trade you made, priced again on every venue from the market as we read it at the five-minute ticks either side of its time (record since 27 Oct 2026); the best venue after its network fee and how far your fill fell short of it in bp; venue optional. Nothing is executed or stored"
    }
  ],
  "mcp": {
    "url": "https://cantonvenues.com/mcp",
    "transport": "streamable-http",
    "tools": [
      "market_overview",
      "list_tokens",
      "token",
      "quote",
      "premiums",
      "spreads",
      "alerts",
      "pools",
      "venues",
      "perps",
      "exit_cost",
      "check_trade"
    ]
  },
  "build": {
    "url": "https://cantonvenues.com/build/",
    "about": "using the data in an app or an agent? One call to start with per kind of app, and a form to register it: notice at least 14 days before any breaking change, direct help, and a listing if you want one. Optional; the API stays the same without it"
  },
  "docs": "https://cantonvenues.com/llms.txt",
  "source": "https://github.com/olevasyliev/canton-venues-sdk"
}