# glance.markets — full documentation

> glance.markets is a free, no-signup charting workspace for crypto, stock, and commodity markets. Candlestick charts, order books, funding, open interest, and 24-hour statistics stream from Binance, Bybit, OKX, Hyperliquid, and Coinbase, alongside a news reader and an anonymous live chat. Every market is addressable at /m/<SYMBOL>, and read-only JSON endpoints expose the same data without an API key.

Canonical origin: https://glance.markets
Index: https://glance.markets/llms.txt
Sitemap: https://glance.markets/sitemap.xml

## What the site provides

- Candlestick charts with built-in indicators, drawing tools, screenshots, and multi-chart layouts (charting by Vela).
- A live order book per selected market: 5, 10, or 20 levels per side.
- Watchlists that can mix venues and contract types, with live prices and 24-hour stats.
- Perpetual mark prices, current funding rates, funding intervals, and open interest where the venue provides them.
- A news reader with headlines and excerpts from eight crypto publishers, saved as a snapshot.
- "Talks", an anonymous IRC-style chat with one channel (#cryptocurrencies). No account required.
- Light and dark themes. All workspace state (watchlist, layouts, drawings) is stored in the browser; there is no login and no cloud sync.

Everything observable in the terminal is public market data. There are no accounts, no credentials, and no order execution.

## Server-rendered facts and client rendering

The interactive terminal is a client-side application. Search engines and answer engines still get useful server-rendered content per market page:

- Page title, description, canonical metadata, and a generated Open Graph/Twitter card.
- JSON-LD: WebSite and Organization on every page, plus WebPage and BreadcrumbList on market pages.
- A `<noscript>` market summary with price, 24-hour change, venue, and links to the JSON API.

The authoritative machine-readable source is always the JSON API below; prices on the page hydrate client-side and stream live after load.

## Market identities

Identities are venue-qualified and case-insensitive on input:

| Identity | Meaning |
| --- | --- |
| `BINANCE:BTCUSDT` | Binance USDT spot |
| `BINANCE:BTCUSDT.P` | Binance USDT perpetual |
| `BYBIT:BTCUSDT` | Bybit USDT spot |
| `BYBIT:BTCUSDT.P` | Bybit USDT perpetual |
| `OKX:BTC-USDT` | OKX USDT spot |
| `OKX:BTC-USDT-SWAP` | OKX USDT perpetual (contracts quoted in contracts, not base units) |
| `HYPERLIQUID:BTC.P` | Hyperliquid native USDC perpetual |
| `HYPERLIQUID:XYZ:TSLA.P` | Hyperliquid HIP-3 builder stock perpetual (USD, builder `XYZ`) |
| `HYPERLIQUID:XYZ:GOLD.P` | Hyperliquid HIP-3 builder commodity perpetual |
| `COINBASE:BTC-USD` | Coinbase USD spot |

Legacy bare symbols such as `BTCUSDT` resolve to Binance spot. Unsupported venues or malformed tickers are rejected with HTTP 400. A bare Hyperliquid ticker that only exists as a builder asset (for example `HYPERLIQUID:TSLA.P`) resolves to the most liquid builder listing (`HYPERLIQUID:XYZ:TSLA.P`).

## Pages

- `/` — the live terminal.
- `/m/<SYMBOL>` — one page per market, with server-rendered facts and the live terminal. Unparsable identities redirect to `/`.
- `/m/<SYMBOL>/opengraph-image` — generated 1200x630 social card: market logo, symbol, venue, price, 24-hour change, and a labelled candle window (15-minute candles over the last 12 hours). Cached for 60 seconds.
- `/robots.txt`, `/sitemap.xml`, `/llms.txt`, `/llms-full.txt` — discovery files.

## API reference

All endpoints are read-only, need no API key, and send `Access-Control-Allow-Origin: *` with `GET` and `OPTIONS` allowed, so browser-based agents and tools can call them directly.

### GET /api/markets

Active markets for one venue, sorted by 24-hour quote volume.

| Parameter | Required | Values |
| --- | --- | --- |
| `source` | No | `binance-spot`, `binance-perp`, `bybit-spot`, `bybit-perp`, `okx-spot`, `okx-perp`, `hyperliquid-perp`, `coinbase-spot`. Default `binance-spot`. |

Example: `GET /api/markets?source=hyperliquid-perp`

```json
{
  "markets": [
    {
      "symbol": "HYPERLIQUID:BTC.P",
      "ticker": "BTC",
      "source": "hyperliquid-perp",
      "base": "BTC",
      "quote": "USDC",
      "name": "Bitcoin",
      "category": "crypto",
      "price": 76650.5,
      "change": 950.5,
      "changePercent": 1.26,
      "quoteVolume": 1234567890,
      "markPrice": 76648,
      "fundingRate": 0.0000125,
      "fundingIntervalHours": 1,
      "openInterest": 12345.6,
      "updatedAt": 1767225600000
    }
  ],
  "fetchedAt": 1767225600000
}
```

Response notes:

- `warning` appears when one Hyperliquid builder failed; `unavailableDexs` lists the affected builders (`["*"]` when discovery itself failed). Other markets are still returned.
- Errors: `400` unsupported source, `502` upstream failure, `429` rate limit.
- Shared HTTP cache lifetime: 10 seconds.

### GET /api/candles

OHLCV bars for one identity.

| Parameter | Required | Values |
| --- | --- | --- |
| `symbol` | Yes | A venue-qualified identity (see above). Legacy bare symbols resolve to Binance spot. |
| `interval` | No | `1`, `5`, `15`, `30`, `60`, `240`, `1D`, `1W` by default; venue-specific intervals are also accepted when the venue supports them. Default `60`. |
| `limit` | No | 1-1000. Default 500. The requested limit is capped to each venue's page size. |
| `startTime`, `endTime` | No | Epoch milliseconds. Omitting `endTime` returns the latest bars. |

Example: `GET /api/candles?symbol=HYPERLIQUID%3ABTC.P&interval=60&limit=500`

```json
{
  "bars": [{ "time": 1767222000000, "open": 76500, "high": 76800, "low": 76400, "close": 76650, "volume": 123.4 }]
}
```

Response notes:

- Bars are ascending by `time`. `time` is the candle open time in epoch milliseconds.
- Coinbase intervals that its Exchange API lacks are aggregated from smaller native candles with UTC boundaries; volume is summed. No synthetic prices or empty bars are generated.
- Hyperliquid exposes at most the latest 5,000 candles per interval.
- Errors: `400` invalid identity, interval, limit, or time range; `502` upstream failure; `429` rate limit.
- Shared HTTP cache lifetime: 5 seconds.

### GET /api/news

Saved snapshot of headlines and excerpts from eight publishers (CoinDesk, Cointelegraph, Decrypt, The Block, CryptoSlate, Unchained, Protos, Bitcoin Magazine). Reads the snapshot; it does not fetch publishers.

```json
{
  "updatedAt": 1767225600000,
  "sources": [{ "id": "coindesk", "label": "CoinDesk", "ok": true, "error": null }],
  "articles": [
    {
      "id": "coindesk:...",
      "title": "Headline",
      "excerpt": "Short plain-text excerpt.",
      "url": "https://www.coindesk.com/...",
      "source": "coindesk",
      "publishedAt": 1767222000000,
      "topics": ["bitcoin"]
    }
  ]
}
```

`POST /api/news` refreshes the snapshot from the publishers (60-second cooldown; requires a writable `data/` directory on the server). The reader keeps up to 800 articles from the past seven days, strips tracking parameters, drops sponsored/press-release items, and links only to publisher HTTPS domains.

### GET /api/health

Deployment liveness check used by the container health check. Returns `{ "status": "ok", ... }`.

## Limits, caching, and privacy

- `/api/markets` and `/api/candles` allow a burst of 120 requests per trusted client IP, replenished at 120 per minute. Limits are shared through Redis when configured. A `429` response includes `Retry-After`.
- With `TRUST_PROXY_HOPS=0` (the default) forwarded IP headers are ignored and a shared unidentified-client bucket of 1,800 requests per minute applies per endpoint.
- Market responses advertise a 10-second shared HTTP cache lifetime; candle responses 5 seconds.
- No API keys, accounts, cookies, or credentials are required. The site does not store visitor identities; watchlists and layouts live in browser storage only.
- `robots.txt` asks crawlers to skip `/api/` paths so search indexes do not fill with JSON. Agent tooling can still call the endpoints directly, and CORS permits it.

## Data semantics worth knowing

- Prices come from each venue's public quote feed. Hyperliquid quotes are midpoints of the best bid and ask (labelled MID) unless only a mark price is available.
- Hyperliquid stock and commodity markets are perpetual derivatives from HIP-3 builders, denominated in USD; builder prefixes are part of the identity.
- Funding values are current upstream rates, not fixed or annualized yields.
- Hyperliquid does not publish 24-hour highs/lows in its asset context; those fields can be absent.
- Coinbase candles refresh through REST polling (about every 10 seconds); the other venues stream WebSocket candles.
- Coinbase and OKX perpetual quote volumes are estimated as base volume multiplied by current price and marked with `≈` (`quoteVolumeEstimated: true`).

## Attribution

Market data belongs to the respective exchanges. When quoting glance.markets data, cite "glance.markets" with a link to https://glance.markets. Bundled coin and stock logos identify their owners and remain their trademarks.