ai.iturri/market-data
Verified market data for AI trading agents: quality-flagged candles, funding, OI, order flow. x402.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http market-data 'https://iturri.ai/mcp' --header 'Authorization: <Optional: '\''Bearer <membership token>'\'' from https://iturri.ai/subscribe — covers metered tools. Omit to pay per call via x402.>'
{
"mcpServers": {
"market-data": {
"type": "http",
"url": "https://iturri.ai/mcp",
"headers": {
"Authorization": "<Optional: 'Bearer <membership token>' from https://iturri.ai/subscribe — covers metered tools. Omit to pay per call via x402.>"
}
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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):
{
"mcpServers": {
"iturri": {
"type": "http",
"url": "https://iturri.ai/mcp",
"headers": { "Authorization": "Bearer <membership token — optional>" }
}
}
}
Claude Code
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
| Tool | What it does | Price |
|---|---|---|
describe_catalog | Symbols, coverage, pricing, quality legend | free forever |
get_bars | Quality-flagged OHLCV, 1m/5m/15m/1h/1d | $0.001 per 1,000 candles |
get_features | Leakage-safe feature matrices (19 features) | $0.01/call |
get_funding | Funding-rate history from listing date | $0.005/call |
get_open_interest | Hourly open interest history | $0.005/call |
get_orderflow | Taker buy/sell order-flow imbalance | $0.005/call |
get_context | Market context series (Fear & Greed, VIX, DXY…) | $0.005/call |
get_events | Curated events with surprise factors and measured impacts | $0.01/call |
get_regime_label | Descriptive market-regime lookup for a timestamp (never a prediction) | $0.01/call |
validate_backtest_data | Audits our data for a range: coverage, flag distribution, gaps, warnings — before you trust a result | $0.01/call |
build_bundle | Builds dataset/pack SKUs, returns signed URLs | priced 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_catalogis 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 callsvalidate_backtest_datafor 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 withget_barsand filtering toverifiedgives you an honest backtest input. I can pull the bars next — that call is priced at $0.001 per 1,000 candles.
Links
- Site: https://iturri.ai/
- Docs / build roadmap: https://iturri.ai/build
- OpenAPI spec: https://iturri.ai/openapi.json
- llms.txt: https://iturri.ai/llms.txt
- MCP tutorial: https://iturri.ai/blog/connect-trading-data-to-claude-mcp
- Sourcing & verification policy: https://iturri.ai/sourcing
- Free catalog: https://iturri.ai/api/catalog
- Contact: source@iturri.ai
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.
Questions fréquentes
Qu'est-ce que ai.iturri/market-data ?
Verified market data for AI trading agents: quality-flagged candles, funding, OI, order flow. x402.
Comment installer ai.iturri/market-data ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http market-data 'https://iturri.ai/mcp' --header 'Authorization: <Optional: '\''Bearer <membership token>'\'' from https://iturri.ai/subscribe — covers metered tools. Omit to pay per call via x402.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour ai.iturri/market-data ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
ai.iturri/market-data est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient ai.iturri/market-data ?
Il est publié par iturri-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.