API & MCP

The desk API: every verified pair with its raw gap, fee-adjusted net, executable size, and the full gate trail, as JSON. Plus an MCP server, so AI agents can query the board directly. Desk holders only; the same key that unlocks the terminal.

Authentication: one key

<your-desk-key> is your desk key, the same key that unlocks the terminal (the key we send you after payment; you can also paste it at /unlock). Paste it wherever you see <your-desk-key> below. Requests without it return 401.

REST endpoints

GET /api/v1/pairsAll matched pairs. Params: limit (max 250), minNet (cents), ticker (single pair).

Auth: X-API-Key: <your-desk-key> header only (keys in URLs end up in logs, so we do not accept them). Rate limits per key: 120 REST requests and 240 MCP calls per 10 minutes. By default the REST API returns pairs on the board; add include=held,dismissed to also get pairs held for review or rejected, each with a status field.

curl -s "https://gap133.xyz/api/v1/pairs?limit=5&minNet=1" \
  -H "X-API-Key: <your-desk-key>"

Every pair object carries the venue legs with deep links, the gap block (rawCents, the edge at the touch before fees, quoteGapCents, the plain price difference for context, netCents, netPositive, buyVenue, execSizeContracts with execSizeUsd as its $1-per-contract settlement notional, and execCostUsd, the capital both legs tie up) and the gate block (match score, Jev same-event and settlement-terms verdicts with a terms label, staleness, and both venues' deadlines). netPositive is only true when the terms are the same or close.

MCP server

Point any MCP client at /api/mcp (streamable HTTP, JSON-RPC 2.0). Discovery is open; tool calls need your desk key. Four tools: list_pairs, get_pair, biggest_gaps, net_positive.

{
  "mcpServers": {
    "gap133": {
      "type": "http",
      "url": "https://gap133.xyz/api/mcp",
      "headers": { "X-API-Key": "<your-desk-key>" }
    }
  }
}

A raw call, for testing:

curl -s https://gap133.xyz/api/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <your-desk-key>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"biggest_gaps","arguments":{"limit":3}}}'

Why we offer this

Most scanners lock their data behind a dashboard. Ours is a terminal for humans and for the agents you delegate to. If you run strategies in code, take the board with you. If your AI assistant tracks markets, it can ask gap133 directly.

API & MCP - gap133