Skip to content

MCP · Server

MCP server

Model Context Protocol endpoint.
POST/mcpmcp
On this page

Streamable 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"}'

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

objectA JSON-RPC 2.0 request or notification.

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.

ToolEndpointReturns
futures_bars/v1/futures/barsOHLCV bars of a futures contract, one minute to one day.
futures_flow/v1/futures/flowLarge and aggressive futures prints with notional value.
futures_session_profile/v1/futures/session-profileVolume profile of the whole current trading session (POC, VAH, VAL).
futures_snapshot/v1/futures/snapshotLast trade, top of book and session OHLCV of a futures contract.
futures_volume_profile/v1/futures/volume-profileVolume by price for a window, with point of control and value area.
indices_bars/v1/indices/barsOHLC bars of an index, one minute to one month.
indices_basis_snapshot/v1/indices/basis/snapshotLive basis, fair value and premium of up to 10 indices.
indices_implied_price/v1/indices/implied-priceThe index level implied by its futures, bar by bar, including off-hours.
indices_snapshot/v1/indices/snapshotCurrent value and session range of up to 50 indices.
market_overview/v1/market/overviewOne-call picture of the market: indexes, futures, volatility and breadth.
market_status/v1/market/statusTrading state of the US equity market and health of the data areas.
options_contract_price_history/v1/options/contract/price-historyCandles of one contract from the platform's own trade record.
options_exposure_by_expiration/v1/options/exposure/by-expirationModeled dealer gamma, delta, vanna or charm exposure by expiration.
options_exposure_by_strike/v1/options/exposure/by-strikeModeled dealer gamma, delta, vanna or charm exposure by strike.
options_exposure_heatmap/v1/options/exposure/heatmapStrike by expiration grid of modeled exposure, open interest or flow.
options_exposure_intervals/v1/options/exposure/intervalsModeled exposure by strike at every interval of a session.
options_flow/v1/options/flowConsolidated option orders: sweeps, splits, blocks and single prints.
options_flow_by_strike/v1/options/flow/by-strikeCall and put premium and volume at every strike, by aggressor class.
options_flow_exchanges/v1/options/flow/exchangesMarket share of option premium, volume and trades by exchange.
options_flow_leaders/v1/options/flow/leadersUnderlyings or contracts leading option flow: top premium, bullish, bearish and movers.
options_flow_net_drift/v1/options/flow/net-driftNet call and put premium per bucket and cumulatively over the session.
options_flow_net_flow/v1/options/flow/net-flowNet premium or net volume per bucket for calls, puts and overall.
options_flow_put_call_ratio/v1/options/flow/put-call-ratioPut/call volume and premium ratios per bucket and cumulatively.
options_flow_stats/v1/options/flow/statsPremium, volume and trades of a filtered option print set, by contract type and aggressor side.
options_flow_unusual/v1/options/flow/unusualUnusual option activity as consolidated orders.
options_levels/v1/options/levelsKey levels of the modeled dealer exposure: walls, gamma flip, largest cell, max pain, expected move.
options_market_map/v1/options/market-mapModeled exposure and executed flow by strike for SPX and SPXW.
options_max_pain/v1/options/max-painMax pain strike of an expiration, its payout curve and the max pain of every expiration.
options_open_interest/v1/options/open-interestOpen interest by strike or by expiration.
options_open_interest_change/v1/options/open-interest/changeChange in open interest per contract between the two latest open interest dates.
options_open_interest_history/v1/options/open-interest/historyOpen interest per stored date for a selection of contracts.
options_trades/v1/options/tradesUnconsolidated option prints with aggressor side, sentiment and context.
options_volatility_drift/v1/options/volatility/driftIntraday implied volatility against adjusted realized volatility.
options_volatility_rank/v1/options/volatility/rankImplied volatility rank and percentile of a constant-maturity volatility.
options_volatility_skew/v1/options/volatility/skewImplied volatility smile by strike and delta, with risk reversals and butterflies.
options_volatility_term_structure/v1/options/volatility/term-structureAt-the-money implied volatility by expiration, constant-maturity points and forward volatilities.
stocks_bars/v1/stocks/barsOHLCV bars from 1 second to 1 month.
stocks_dark_pool_flow/v1/stocks/dark-pool/flowOff-exchange dollar value, shares and trades per interval.
stocks_dark_pool_levels/v1/stocks/dark-pool/levelsOff-exchange price levels ranked by dollar value.
stocks_dark_pool_summary/v1/stocks/dark-pool/summaryOff-exchange share, notional and trade count of a stock for one date.
stocks_dark_pool_trades/v1/stocks/dark-pool/tradesOff-exchange (dark pool) prints of a stock, oldest first.
stocks_market_map/v1/stocks/market-mapPrice change, size and sector of the large-cap universe.
stocks_movers/v1/stocks/moversTop 20 gainers or losers of the day.
stocks_news/v1/stocks/newsTicker news, newest first.
stocks_prints_large/v1/stocks/prints/largeLarge equity prints, lit and off-exchange, newest first.
stocks_snapshot/v1/stocks/snapshotCurrent-day snapshot of up to 50 stocks.
stocks_ticker_details/v1/stocks/ticker-detailsCompany details for a stock symbol.
stocks_trades/v1/stocks/tradesConsolidated trades of a stock, oldest first.

Response

StatusMeaningBody
200The JSON-RPC response.Schema below
202A notification was accepted.Success
400A JSON-RPC batch or an unreadable message.Error object
401Missing or invalid API key.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

object

A free-form object: the members depend on the request.