Market Data

ai.iturriPublished by iturri.aiOfficial publisherv0.2.2Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Hosted MCP server giving assistants verified crypto and US-equity market history: quality-flagged candles, funding, open interest, order flow and SEC filings.

What you can do
  • Discover the catalog: symbols, coverage, timeframes, pricing and quality legend
  • Fetch quality-flagged OHLCV candles, leakage-safe feature matrices, funding rates, open interest, long/short ratios and order-flow imbalance
  • Pull market context series, curated macro events and descriptive regime labels
  • Check data before trusting it: validate a dataset spec, audit your own bars, test signals for lookahead bias and universes for survivorship bias
  • Read SEC fundamentals, insider Form 4 trades and 13F institutional aggregates
  • Build dataset bundles and signed download URLs; read free daily pulse, change log and quality receipts
When to use it
Useful when building or checking trading backtests and AI trading agents that need traceable, quality-flagged crypto or US-equity history, and when you want an assistant to verify data coverage and bias before relying on a result.
Requirements
Remote streamable-HTTP endpoint; nothing to install. An optional Authorization bearer membership token covers metered calls; without it, paid tools return x402 quotes settled per call in USDC on Base. Network access required.
Before you install
Paid tools cost money: per-call x402 payments in USDC on Base, or a $39/month or $349/year membership token, and dataset packs priced per SKU. A payment-capable agent can settle charges and even buy a membership without a human. Coverage is narrow (120 symbols) and data is T+1, not a live stream. Nothing returned is a trading signal or financial advice.

Installation

In SourceWeft

  1. Open Market Data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.iturri%2Fmarket-data/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Iturri MCP server — verified market data for AI agents

Hosted MCP server. No install, nothing to run — connect to https://iturri.ai/mcp.

Iturri is a data library for trading-bot and AI-agent builders: verified crypto and US-equity history, leakage-safe features, and an agent-native API. Coverage is deliberately narrow — 120 liquid symbols (34 crypto since 2015-12 at 1m/5m/15m/1h/1d, 86 US stocks & ETFs EOD since 2016), not tens of thousands of tickers. Every candle is traceable to a SHA-256-checksummed primary source, cross-checked against a second primary venue, and shipped with a data card. Data is T+1 fresh (candles refresh daily at 08:30 UTC); this is history you can trust, not a real-time stream.

Why per-bar quality flags matter for agents

Free data sources silently patch gaps and restate history, and an agent has no way to know. Iturri never patches silently: every bar carries its own verdict — verified, raw, reconciled, interpolated, disputed, or outage — so an agent can filter to verified bars in one step, or call validate_backtest_data and read the coverage, flag distribution, gaps, and warnings for a range before trusting a backtest result. 99.8%+ of the 124.5M+ crypto bars carry the verified flag, backed by published audit numbers (BTC: 87,643 bars, 100.00% agreement with Coinbase Exchange; cross-timeframe 1m→1h audit 98.95% exact / 99.93% in-band over 2.4M hours).

Connect

The endpoint is streamable HTTP: https://iturri.ai/mcp (JSON-RPC 2.0 over POST; GET /mcp returns a human/agent-readable descriptor).

Claude Desktop

Add to claude_desktop_config.json (see examples/claude_desktop_config.json):

json
{  "mcpServers": {    "iturri": {      "type": "http",      "url": "https://iturri.ai/mcp",      "headers": { "Authorization": "Bearer <membership token — optional>" }    }  }}

Claude Code

sh
claude mcp add --transport http iturri https://iturri.ai/mcp

Any other MCP client

Point a streamable-HTTP MCP client at https://iturri.ai/mcp. Optionally send Authorization: Bearer <membership token>. Omit the header and paid tools return x402 quotes that payment-capable agents settle per call (x402 MCP transport, _meta["x402/payment"]).

Then ask the model to call describe_catalog (free) and go from there.

The 11 tools

ToolWhat it doesPrice
describe_catalogSymbols, coverage, pricing, quality legendfree forever
get_barsQuality-flagged OHLCV, 1m/5m/15m/1h/1d$0.001 per 1,000 candles
get_featuresLeakage-safe feature matrices (19 features)$0.01/call
get_fundingFunding-rate history from listing date$0.005/call
get_open_interestHourly open interest history$0.005/call
get_orderflowTaker buy/sell order-flow imbalance$0.005/call
get_contextMarket context series (Fear & Greed, VIX, DXY…)$0.005/call
get_eventsCurated events with surprise factors and measured impacts$0.01/call
get_regime_labelDescriptive market-regime lookup for a timestamp (never a prediction)$0.01/call
validate_backtest_dataAudits our data for a range: coverage, flag distribution, gaps, warnings — before you trust a result$0.01/call
build_bundleBuilds dataset/pack SKUs, returns signed URLspriced as the SKU

Payments — no accounts, no API keys

  • x402 per call (agents). Any priced tool returns an x402 v2 quote (USDC on Base). A payment-capable agent signs the authorization, retries, gets data. Gasless for the payer; settles on-chain with a receipt. Minimum $0.001 per paid call; empty results are free. An agent can even buy its own membership: POST /api/subscribe, pay $39 via x402, receive the token — no human in the loop.
  • Membership token. $39/month or $349/year — a bearer token that makes all metered API/MCP calls free (training-pack SKUs stay pay-per-sale). Humans: iturri.ai/subscribe (one MetaMask signature via EIP-3009). Renew by paying again — the token is the membership. No card, no account, no KYC.
  • describe_catalog is free forever — discovery costs nothing.

Example conversation

User: Is Iturri's SOL hourly data clean enough to backtest over 2023?

Claude: (calls describe_catalog — free — confirms SOL 1h coverage; then calls validate_backtest_data for SOL/1h/2023-01-01→2024-01-01) The quality report shows the coverage for that range, the per-flag distribution, and any gaps or warnings. If the verified share is high and there are no warnings, fetching the bars with get_bars and filtering to verified gives you an honest backtest input. I can pull the bars next — that call is priced at $0.001 per 1,000 candles.

Links

Hard line: Iturri sells data and tooling only. Nothing in any dataset, feature, label, or tool is a trading signal, a prediction, or financial advice. Verified history describes the past; it promises nothing about the future.

Source: README.md at commit e4a7f96

Tools

22

describe_catalog

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

Takes no parameters.

get_bars

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

Parameterstfrequiredendstartsymbolrequired

get_features

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

Parameterstfrequiredendstartsymbolrequired

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.

Parameterstfpackrequiredsymbol

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.

Parameterssymbolrequiredtimestamprequired

get_funding

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

Parametersendstartsymbolrequired

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).

Parameterstfendstartsymbolrequired

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.

Parametersendstartsymbolrequired

get_context

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

Parametersendstartseriesrequired

get_events

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

Parametersendtypestart

get_orderflow

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

Parameterstfendstartsymbolrequired

validate_backtest_data

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

Parameterstfrequiredendstartsymbolrequired

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).

Parameterstfrequiredbarsrequiredsymbolrequired

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).

Parameterstfrequiredsymbolrequiredsignalsrequired

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.

Parametersendassetstartsymbolsrequired

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).

Parametersendas_ofstartsymbolrequiredconcept

get_insider

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

Parametersendstartsymbolrequired

get_institutional

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

Parametersendstartsymbolrequired

get_funding_spread

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

Parametersendstartsymbolrequired

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.

Takes no parameters.

get_whats_new

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

Takes no parameters.

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.

Takes no parameters.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts