ai.iturri/market-data

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Verified market data for AI trading agents: quality-flagged candles, funding, OI, order flow. x402.

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "market-data": {
      "url": "https://iturri.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• describe_catalog

  Free discovery: symbols, timeframes, ranges, pricing, quality legend.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_bars

  Quality-flagged OHLCV candles. Priced per 1,000 candles.

  Parameters:

  • symbol (required) — string
  • tf (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_features

  Documented leakage-safe feature matrix rows. Priced per call.

  Parameters:

  • symbol (required) — string
  • tf (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• build_bundle

  Signed URL for a dataset SKU. Packs: crypto|equities ($59 each), everything ($149: both packs + all token sequences, $730 list), tokens ($18/symbol), dataset (per-symbol OHLCV, crypto $14 / equity $5), mtf (aligned multi-timeframe bundle $9, crypto only), features (feature matrix, crypto $7 / equity $4). Priced as the SKU.

  Parameters:

  • pack (required) — string
  • tf — string — features only — crypto: 1h (default) or 15m; equity: 1d
  • symbol — string — required for tokens|dataset|mtf|features

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_regime_label

  Descriptive market-state label (trend/range × calm/vol quadrant) for the most recent completed bar at or before a timestamp. Not a prediction.

  Parameters:

  • symbol (required) — string
  • timestamp (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_funding

  Perp funding-rate settlement history from listing date (checksummed archive).

  Parameters:

  • symbol (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_open_interest

  Open interest with per-row quality flags (verified archive + flagged bridge). tf=1h (default, full history) or tf=5m (archive-native 5-minute rows from 2020-09; ranged pulls, ~100k rows max per call).

  Parameters:

  • symbol (required) — string
  • tf — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_long_short

  Positioning ratios at 5-minute cadence from the checksummed venue archive (2020-09+): top-trader long/short by accounts and by position size, all-accounts long/short, taker buy/sell volume ratio. Ranged pulls, ~100k rows max per call.

  Parameters:

  • symbol (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_context

  Context series: fear_greed_1d, VIX_1d, DXY_1d, TNX_1d, DJI_1d.

  Parameters:

  • series (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_events

  Curated macro/crypto events (FOMC w/ surprise, halvings, incidents) in a range.

  Parameters:

  • end — string
  • type — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_orderflow

  Taker buy/sell imbalance, trade counts, quote volume (1h/1d via API; denser tiers in packs). buy_ratio 0.5 = balanced.

  Parameters:

  • symbol (required) — string
  • tf — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• validate_backtest_data

  Quality report for a dataset spec before you backtest on it: coverage, per-bar quality distribution, gaps, and concrete warnings.

  Parameters:

  • symbol (required) — string
  • tf (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• audit_my_data

  FREE: submit YOUR OHLCV bars and get an accuracy verdict against the verified archive — score, worst windows, systematic-offset findings. Tells you what's wrong, not the corrected values (that's get_bars).

  Parameters:

  • symbol (required) — string
  • tf (required) — string
  • bars (required) — object — columnar arrays: t (epoch s or ISO) required; o/h/l/c optional

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookahead_check

  FREE: submit backtest signals ({t, price}) and get an execution-feasibility verdict — impossible fills outside the bar's traded range, fills pinned at bar extremes (classic lookahead bias).

  Parameters:

  • symbol (required) — string
  • tf (required) — string
  • signals (required) — array

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• survivorship_check

  FREE: submit a backtest universe + window and get a survivorship-bias verdict — which of your symbols died mid-window, and which delisted symbols we cover that your universe omits.

  Parameters:

  • symbols (required) — array
  • end — string
  • asset — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_fundamentals

  Point-in-time SEC XBRL fundamentals (80 filers, incl. delisted): every restatement vintage with its filed date. Pass as_of for what was knowable then. Filter by concept (e.g. Assets, Revenues).

  Parameters:

  • symbol (required) — string
  • end — string
  • as_of — string
  • start — string
  • concept — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_insider

  SEC Form 4 insider transactions as filed (80 symbols, since 2016): officer/director trades with shares, price, post-trade holdings.

  Parameters:

  • symbol (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_institutional

  Quarterly 13F institutional aggregates (81 symbols): holders, shares, value + QoQ deltas from SEC DERA structured tables.

  Parameters:

  • symbol (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_funding_spread

  Hourly CEX-vs-DEX funding spread (67 symbols): Hyperliquid funding vs Binance 1h-equivalent, from HL genesis 2023-05.

  Parameters:

  • symbol (required) — string
  • end — string
  • start — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_market_pulse

  FREE daily pulse across the catalog: regime flips, funding extremes, CEX-vs-DEX spread extremes, biggest daily moves. One day of values — the history behind each number is the priced product.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_whats_new

  FREE: what the daily refresh changed — dataset windows extended vs ~7 days ago, new symbols and sections, freshness per asset class.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_quality_receipts

  FREE public scoreboard: last 30 daily fresh-data audits (cross-venue in-band vs Coinbase, 1m->1h rebuild exactness, depth sanity) — failures included, not hidden.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.