MCP · Server
MCP server
/mcpmcpStreamable HTTP MCP server (stateless, JSON responses): send one JSON-RPC 2.0 message per request with the same developer key as REST (Accept must list application/json and text/event-stream), and discover tools with tools/list. There is one read-only tool per major data endpoint, named after it (options_flow_stats for /v1/options/flow/stats); its arguments are the endpoint's query parameters and its result is the endpoint's response envelope as structured content. Each request, including every tools/call, counts as one request against the account rate limit; JSON-RPC batches are rejected. A failed call is a tool error holding the API error object.
Example request
curl -sS "https://api.ordermap.si/mcp" \
-H "Authorization: Bearer $ORDERMAP_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'const res = await fetch("https://api.ordermap.si/mcp", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}`,
"Content-Type": "application/json",
Accept: "application/json, text/event-stream",
},
body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),
});
console.log(await res.json());Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
This endpoint takes no parameters.
Request body
Required. Content-Type: application/json
JSON body
A free-form object: the members depend on the request.
Tools
One read-only tool per major endpoint, named after it. The setup, the limits and the behaviour of failed calls are in the MCP guide. Each tool takes the query parameters of its endpoint.
| Tool | Endpoint | Returns |
|---|---|---|
futures_ | / | OHLCV bars of a futures contract, one minute to one day. |
futures_ | / | Large and aggressive futures prints with notional value. |
futures_ | / | Volume profile of the whole current trading session (POC, VAH, VAL). |
futures_ | / | Last trade, top of book and session OHLCV of a futures contract. |
futures_ | / | Volume by price for a window, with point of control and value area. |
indices_ | / | OHLC bars of an index, one minute to one month. |
indices_ | / | Live basis, fair value and premium of up to 10 indices. |
indices_ | / | The index level implied by its futures, bar by bar, including off-hours. |
indices_ | / | Current value and session range of up to 50 indices. |
market_ | / | One-call picture of the market: indexes, futures, volatility and breadth. |
market_ | / | Trading state of the US equity market and health of the data areas. |
options_ | / | Candles of one contract from the platform's own trade record. |
options_ | / | Modeled dealer gamma, delta, vanna or charm exposure by expiration. |
options_ | / | Modeled dealer gamma, delta, vanna or charm exposure by strike. |
options_ | / | Strike by expiration grid of modeled exposure, open interest or flow. |
options_ | / | Modeled exposure by strike at every interval of a session. |
options_ | / | Consolidated option orders: sweeps, splits, blocks and single prints. |
options_ | / | Call and put premium and volume at every strike, by aggressor class. |
options_ | / | Market share of option premium, volume and trades by exchange. |
options_ | / | Underlyings or contracts leading option flow: top premium, bullish, bearish and movers. |
options_ | / | Net call and put premium per bucket and cumulatively over the session. |
options_ | / | Net premium or net volume per bucket for calls, puts and overall. |
options_ | / | Put/call volume and premium ratios per bucket and cumulatively. |
options_ | / | Premium, volume and trades of a filtered option print set, by contract type and aggressor side. |
options_ | / | Unusual option activity as consolidated orders. |
options_ | / | Key levels of the modeled dealer exposure: walls, gamma flip, largest cell, max pain, expected move. |
options_ | / | Modeled exposure and executed flow by strike for SPX and SPXW. |
options_ | / | Max pain strike of an expiration, its payout curve and the max pain of every expiration. |
options_ | / | Open interest by strike or by expiration. |
options_ | / | Change in open interest per contract between the two latest open interest dates. |
options_ | / | Open interest per stored date for a selection of contracts. |
options_ | / | Unconsolidated option prints with aggressor side, sentiment and context. |
options_ | / | Intraday implied volatility against adjusted realized volatility. |
options_ | / | Implied volatility rank and percentile of a constant-maturity volatility. |
options_ | / | Implied volatility smile by strike and delta, with risk reversals and butterflies. |
options_ | / | At-the-money implied volatility by expiration, constant-maturity points and forward volatilities. |
stocks_ | / | OHLCV bars from 1 second to 1 month. |
stocks_ | / | Off-exchange dollar value, shares and trades per interval. |
stocks_ | / | Off-exchange price levels ranked by dollar value. |
stocks_ | / | Off-exchange share, notional and trade count of a stock for one date. |
stocks_ | / | Off-exchange (dark pool) prints of a stock, oldest first. |
stocks_ | / | Price change, size and sector of the large-cap universe. |
stocks_ | / | Top 20 gainers or losers of the day. |
stocks_ | / | Ticker news, newest first. |
stocks_ | / | Large equity prints, lit and off-exchange, newest first. |
stocks_ | / | Current-day snapshot of up to 50 stocks. |
stocks_ | / | Company details for a stock symbol. |
stocks_ | / | Consolidated trades of a stock, oldest first. |
Response
| Status | Meaning | Body |
|---|---|---|
200 | The JSON-RPC response. | Schema below |
202 | A notification was accepted. | Success |
400 | A JSON-RPC batch or an unreadable message. | Error object |
401 | Missing or invalid API key. | Error object |
429 | Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After | Error object |
Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.
200 response body
A free-form object: the members depend on the request.