MidasFlow
AI
EN
MidasFlow
AI
An agent-native crypto market-data feed. One Bearer key, two ways to connect: a remote MCP server or plain REST. Built to be read by LLM agents and humans alike.
MidasFlow Flow API โ crypto market DATA for AI agents; unrelated to the Flow (FLOW) blockchain.
Market data, not financial advice. MidasFlow emits AI-generated market data and selecting features โ not financial advice and not profitable-trade guarantees. Accuracy is published as a with/without-filter delta over realized outcomes. Your agent makes the decisions; we only provide the data.
Every call authenticates with a single API key of the form mf_live_โฆ, sent as a
Bearer token in the Authorization header. The same key works for
both MCP and REST.
Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxxNever put the key in the URL or query string. Query strings leak into proxy logs, browser history and referrer headers. Headers do not. The header is the only supported place for the key.
Get a key: create one in your MidasFlow cabinet (Settings โ API). The key is shown once โ copy it immediately. Every account starts on Free (free) with one free key; paid tiers are a separate Flow API purchase.
Add the remote MCP connector โ one URL, header auth, no SDK or glue. The model gets the tools listed below as native function calls.
claude mcp add --transport http midasflow https://mcp.midasflow.ai/mcp \
--header "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx"https://mcp.midasflow.ai/mcp (streamable-HTTP).No MCP client? Hit REST directly with the same header. The public REST base is
https://mcp.midasflow.ai.
curl -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
"https://mcp.midasflow.ai/v1/signals/pull?limit=2"MCP host = mcp.midasflow.ai ยท REST host = mcp.midasflow.ai.
They are different hosts on purpose; the Bearer header is identical.
/v1)Every metered endpoint draws weighted units from your daily quota โ heavy / crown
calls cost more units than cheap context. The Units column is the weight per call;
regime is a loss-leader (billed at the 1-unit floor). Min tier is the
lowest Flow tier that returns non-trivial data; lower tiers may get a coarsened or gated response.
| Method | Path | Returns | Min tier | Units |
|---|---|---|---|---|
| GET | /v1/signals/pull | Pull recent signals | Free | 2 |
| GET | /v1/signals/live | Latest signal snapshot | Free | 2 |
| GET | /v1/signals/elite | ELITE consensus feed (crown analytics) | Prime | 10 |
| GET | /v1/stream | Live signal stream (SSE) | PRO | 10 |
| GET | /v1/outcomes | Realized track-record (proof of edge, no models) | Free | 10 |
| GET | /v1/accuracy | Proof of edge โ sourceรboost first-TP WR | Free | 10 |
| GET | /v1/large-trades | Whale trade feed (large prints, market data) | Free | 1 |
| GET | /v1/liquidations | Multi-exchange liquidation feed (market data) | Free | 1 |
| GET | /v1/anomalies | Per-symbol market anomaly events | Free | 2 |
| GET | /v1/flow | Order-flow microstructure snapshot | PRO | 2 |
| GET | /v1/cross_flow | Cross-exchange flow origin (per symbol) | PRO | 10 |
| GET | /v1/squeeze/{symbol} | Squeeze / liquidation-cascade proximity | PRO | 5 |
| GET | /v1/regime | Market regime context (bundled) | Free | 1 |
| GET | /v1/phase | Move-lifecycle / entry-timing phase | VIP | 2 |
| GET | /v1/derivatives | Derivatives context (funding / OI / basis) | PRO | 1 |
| GET | /v1/score/{symbol} | Calibrated P(TP1) score + trade plan | PRO | 10 |
| GET | /v1/candles/{symbol} | OHLCV candles (our hypertable) | PRO | 1 |
| GET | /v1/orderbook/{symbol} | Order-book walls + imbalance (cross-venue) | PRO | 1 |
| GET | /v1/cvd/{symbol} | Cumulative volume delta series (cross-exchange) | VIP | 2 |
| GET | /v1/heatmap/{symbol} | Liquidation heatmap matrix (timeรprice) | VIP | 3 |
| GET | /v1/sweeps/{symbol} | Stop-hunt sweep events | VIP | 1 |
| GET | /v1/whales/{symbol} | Per-symbol whale prints (on-chain) | VIP | 1 |
| GET | /v1/funding/{symbol} | Per-symbol OI long/short + funding context | PRO | 1 |
| GET | /v1/intel/{symbol} | Per-symbol aggregated signal intelligence | VIP | 1 |
| GET | /v1/movers | Top 24h movers (real forward moves) | PRO | 1 |
| GET | /v1/market | Market overview (BTC/ETH/SOL + regime) | Free | 1 |
| GET | /v1/analyze/{symbol} | AI-Analyst report (LLM-backed) | Prime | 8 |
| GET | /v1/sr | Support/Resistance levels (technical + order-book) | Free | 1 |
| GET | /v1/symbol/check | Pre-trade symbol safety guard | Free | 1 |
| POST | /v1/backtest | Backtest a setup โ historical P(TP1 before SL) + EV [PREVIEW ยท roadmap] | Free | 10 |
| GET | /v1/tiers | Flow tiers & what each delivers now | Free | 1 |
| GET | /v1/account | Account & billing (x402 stub) | Free | 1 |
| GET | /v1/usage | Your usage & quota | Free | 1 |
* /v1/flow: Free sees a coarsened view (CVD trend direction + sweep
state only); the full microstructure snapshot unlocks at Core+. Symbol-keyed endpoints take the
symbol in the path, e.g. /v1/score/BTCUSDT, /v1/squeeze/ETHUSDT.
Over MCP the same surface is exposed as named tools (14, grouped). Your agent calls them directly:
| Tool | What it does | REST equivalent |
|---|---|---|
get_signals | Recent SignalEvents โ the live feed (normal) or the rare elite consensus crown feed. | grouped โ kinds: normal, elite |
score_symbol | Calibrated P(first TP1 before SL) band + coarse plan, folded with a feed-safety check. | /v1/score/{symbol} |
get_candles | Raw OHLCV bars at a timeframe โ the price/volume history other tools derive from. | /v1/candles/{symbol} |
get_orderbook | Live book walls / imbalance / spread, folded with support/resistance + Fibonacci. | /v1/orderbook/{symbol} |
get_flow | Order-flow microstructure: full VPIN snapshot, CVD series, sweeps, or cross-exchange origin. | grouped โ kinds: vpin, all, cvd, sweeps, cross |
get_heatmap | Liquidation-heatmap matrix โ price-magnet zones where leverage clusters. | /v1/heatmap/{symbol} |
get_context | Context reads: market regime, move-phase, derivatives summary, per-venue funding, squeeze proximity, signal-quality intel. | grouped โ kinds: regime, phase, derivatives, funding, squeeze, intel |
get_whales | Large-player intel: whale prints per symbol, or multi-exchange liquidation prints. | grouped โ kinds: whales, liquidations |
get_market | Whole-market board: top movers, market overview, or the anomaly board. | grouped โ kinds: movers, overview, anomalies |
get_accuracy | Realized proof-of-edge: sourceรboost first-TP win-rate, or windowed track-record. | grouped โ kinds: accuracy, outcomes |
account | Your key's account view: tier/quota/balance, usage+endpoint_weights, or the tier ladder. | grouped โ kinds: account, tiers, usage |
backtest | Replay an arbitrary {entry,tp,sl} setup over 1m history โ historical P(TP1) + EV. | POST /v1/backtest |
analyze | Full AI-Analyst narrative report fusing flow/derivs/levels/regime/signals. | /v1/analyze/{symbol} |
calc_ev | Pure local EV / risk-reward / break-even calculator over a win-rate + avg win/loss. | (local โ no network) |
SignalEvent schemaSignal endpoints return SignalEvent objects. Headline fields are always
present; the richer blocks below are null unless your tier unlocks
them. Raw model probabilities are deliberately withheld โ exposing the continuous gradient would
enable surrogate model-extraction.
| Field | Type | Meaning |
|---|---|---|
schema_version | string | Payload schema version (e.g. "1.0") |
signal_id | string? | Unique signal identifier |
timestamp | int | Epoch seconds at emission |
symbol | string | Trading pair, e.g. BTCUSDT |
price | float | Price at signal time |
direction | enum | LONG | SHORT |
source | enum | Public family: pump ยท flow ยท breakout ยท unified ยท orchestrator ยท other (never the raw model ladder) |
model_confidence | float? | Bucketed class score in [0,1] โ not P(win). Use /v1/accuracy or /v1/outcomes for realized win-rate. |
entry_path | string? | Entry-method descriptor |
disclaimer | string | "AI-generated market data, not financial advice." |
| Block | Unlocks at | Key fields |
|---|---|---|
volume | Free | buy_ratio_1m, vol_mult |
regime | Free | regime, fear_greed, btc_state, btc_ret_24h_pct |
breakout | Core | tf_confirmed, support_pct, resistance_pct, run_up_pct, n_clear_overhead |
derivatives | Core | funding_rate, oi_usd, oi_delta_15m_pct, ls_ratio, taker_buy_ratio, liq_buy_usd_5m, liq_sell_usd_5m |
lifecycle | Core | nth, first_price, ret_pct, age_min, recurrence_2h, path |
outcome_dist | Core | typical_pct, p_ge_2pct, tail_pct, p_up, tier, n, bucket_id, is_bucketed (base-rate by source/state, not per-signal) |
phase | Edge | phase, momentum, exhaustion, knife_score, bounce_score, confidence, accum_score, accum_breakout |
cross | Edge | propagation, n_exchanges, confirm_pct, vw_buy_ratio, dominant_exchange, lead_exchange, turnover_tier, oi_total_usd, early_warning (the cross-exchange moat) |
indicators | Edge | rsi, atr_pct, vwap_dev, adx, sma_dist (per-timeframe maps) |
flags | Edge | late_entry, vertical_move, not_bybit_tradeable, fast_path (machine booleans only) |
model_scores | Prime | band = low | med | high (3-class confidence). Raw per-model probabilities are withheld; the band is all an agent needs to self-filter. |
outcome | โ | filled, realized_pnl_pct, mfe_pct, mae_pct, close_reason, hold_min, hit_tp_before_sl, price_5m/15m/30m/1h (forward marks for self-audit) |
Block-to-tier gating is enforced server-side. The headline fields and the forward
outcome marks ship on every tier so any agent can self-verify accuracy against real
data.
The Flow API is tariffed separately from the Telegram bot plan. Every cabinet key starts on Free (free); paid tiers are a separate Flow API purchase. Daily quota is in weighted units (not flat calls), so the quota rations the expensive crown calls without throttling cheap context. Numbers below are current defaults and may be tuned via configuration.
| Tier | Daily units | Feed lag | Blocks unlocked |
|---|---|---|---|
| Free free | 200 | ~15 min | regime, volume (real signals, delayed) |
| PRO | 750 | real-time | + breakout, derivatives, lifecycle, outcome_dist |
| VIP | 1,500 | real-time | + cross, flags, indicators, mfbreakout, phase |
| Prime | 8,500 | real-time | + model_scores |
| Apex | 16,600 | real-time | = tier below (all blocks) |
Free sees real signals on a ~15-minute lag (so an agent can self-verify
accuracy on real data); the fresh real-time edge is the paid upsell. There are also
Flow (PRO) / Flow (VIP) bundles that mirror the human plan's data tier, and
a Flow Metered prepaid mode billed per-weight. Call GET /v1/tiers for the
live, authoritative ladder (which blocks each tier delivers today vs roadmap).
GET /v1/schema returns the machine-readable response contract โ a JSON-Schema document
describing every /v1/* payload, so an agent can introspect the API instead of
hard-coding field names. Poll GET /v1/schema/version and diff schema_version
to detect breaking changes.
curl -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
"https://mcp.midasflow.ai/v1/schema" | jq '.endpoints | keys'The MidasFlow Flow API is a crypto market-data feed for AI agents, delivered over a remote MCP
server (https://mcp.midasflow.ai/mcp) and plain REST (https://mcp.midasflow.ai/v1).
It returns structured market data for your agent to reason over โ market data, not financial advice,
and unrelated to the Flow (FLOW) blockchain.
Yes โ a native MCP server at https://mcp.midasflow.ai/mcp exposing ~14 grouped tools
such as get_signals, get_flow, get_market, get_intel
and score_symbol. It works with any MCP-compatible runtime including Claude, ChatGPT,
Cursor, Claude Code, Gemini CLI and Codex, using a Bearer mf_live_ key that also works over REST.
Add the remote MCP connector https://mcp.midasflow.ai/mcp with an
Authorization: Bearer mf_live_โฆ header (CLI/agent runtimes), or use the cabinet connector
flow for Claude web / ChatGPT (OAuth). See Connect above; keyless self-discovery
lives at GET /v1/schema.
One subscription powers both the Telegram bot and your agent's API/MCP key across five tiers, each with a daily weighted-unit quota: Free $0 (200 units/day), PRO $49/mo (750), VIP $99/mo (1,500), Prime $199/mo (8,500) and Apex $399/mo (16,600). Yearly billing is $399 / $799 / $1,990 / $3,990.
Disclaimer. MidasFlow emits AI-generated market data and selecting features โ not financial advice and not profitable-trade guarantees. Crypto markets carry substantial risk. Accuracy figures are published as a with/without-filter delta over realized outcomes. Always do your own research.
Authoritative live source: `midasflow://catalog` + `GET /v1/schema`. Generated 2026-06-28 by gen_agent_docs.py.