# Weekend Gap Board

> Free, keyless data for AI trading agents: how far tokenized US stocks have moved over the weekend vs a Fri 16:00 ET reference (Hyperliquid HIP-3 oracle where a liquid market exists, otherwise the token last-hour average; not the official close), how much the token issuers disagree, where Hyperliquid HIP-3 stock perps sit vs the tokens, and how funding differs across perp venues for the same stock.

Early test. One static snapshot, refreshed by hand (check `token_prices_asof`). Thin weekend liquidity: gaps can close or flip at the open. Not investment advice.

## Endpoints

- [Board JSON](https://weekend-gap-board.pages.dev/v1/latest.json): GET, no auth, CORS on, cached 300 s.
- [OpenAPI 3.1](https://weekend-gap-board.pages.dev/openapi.json): schema for the JSON.
- [MCP server](https://weekend-gap-board.pages.dev/mcp): Streamable HTTP (stateless JSON responses), no auth. One tool, `get_weekend_board(section?, ticker?, limit?, include_breakdown?)`.
- [MCP server card](https://weekend-gap-board.pages.dev/.well-known/mcp/server-card.json)
- [Human page](https://weekend-gap-board.pages.dev/)

## Fields (all gaps in basis points vs the Fri 16:00 ET reference)

- `weekend_gap[]`: `ticker`, `reference_source` (`hyperliquid_oracle` | `token_last_hour_avg`), `ref_market` (HL market for the oracle, else null), `token_consensus_gap_bps` (volume-weighted median across live token series), `n_series`, `n_issuers`, `issuer_dispersion_bps` (max-min across issuers), `hip3_market`, `hip3_gap_bps`, `hip3_minus_token_bps` (null when no HIP-3 market), `issuers[]` {`issuer`, `venue`, `gap_bps`}.
- `funding_cross_venue[]`: `ticker`, `n_venues_oi50k`, `max_apr_pct`/`max_venue`, `min_apr_pct`/`min_venue`, `spread_apr_pct`, `total_oi_usd`, `venues[]` {`venue`, `apr_pct`, `oi_usd`}. APR = hourly rate x 8760; venues with OI >= $50k and non-zero rates.
- Metadata: `token_prices_asof`, `perp_snapshot_asof`, `reference`, `reference_time_utc`, `reference_method`, `reference_sources`, `units`, `coverage`, `attribution`, `disclaimer`.

## Example

```
curl -s https://weekend-gap-board.pages.dev/v1/latest.json | jq '.weekend_gap[] | {ticker, token_consensus_gap_bps, hip3_minus_token_bps}'
curl -s https://weekend-gap-board.pages.dev/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weekend_board","arguments":{"ticker":"NVDA"}}}'
```

## Attribution

DEX token prices powered by GeckoTerminal (CoinGecko). Perp/funding data from each venue's public API; Hyperliquid info API (also the source of the reference oracle). Only derived numbers (gaps, medians, funding APR) are published; no reference prices or raw token prices. No official exchange closing prices are used.

## Paid API waitlist

A paid API (higher limits, history, alerts) is planned. Get notified when it goes live: form at https://weekend-gap-board.pages.dev/#notify, or `POST https://weekend-gap-board.pages.dev/v1/notify` with JSON `{"email": "...", "use": "optional: what you'd use it for"}`. The email is only used to tell you when it launches.

## Feedback

Want history, more tickers, a fair-value estimate, or an alert? Tell the author: https://x.com/CryptoRaziel