# f1ow

> One MCP endpoint that gives Claude, ChatGPT, Cursor or your own agent live
> the whole crypto market — price, derivatives, options, order flow, on-chain,
> sentiment, news and catalysts — drawn from a multitude of sources and
> reconciled into one read. 38 market and research tools, including
> trade-plan checks and replay, rule-based setup scans and paged history.
> One additional utility provides UTC time (39 tools total).
> No trade execution, asset transfer or autonomous position monitoring.

Users sign in with MetaMask, Google or GitHub, pay a 30-day stablecoin
subscription (USDC/USDT on Base, Arbitrum, Polygon or Ethereum), and connect via
OAuth or an API key. Autonomous agents can instead pay per call with x402.

## Documentation

- Docs (HTML): https://www.f1ow.com/docs
- Every docs page as Markdown: append `.md`, e.g. https://www.f1ow.com/docs/get-started.md
- All docs in one file: https://www.f1ow.com/llms-full.txt
- Tool reference: https://www.f1ow.com/docs/tools — one page per tool, e.g. https://www.f1ow.com/docs/tools/funding_current.md
- Connect: https://www.f1ow.com/docs/connect/claude, /chatgpt, /cursor, /vscode, /custom-agent
- Authentication (OAuth, API key, x402): https://www.f1ow.com/docs/auth
- REST API: https://www.f1ow.com/docs/api/rest · WebSocket API: https://www.f1ow.com/docs/api/websocket

## MCP endpoints

- OAuth (Claude / ChatGPT / human connectors): https://mcp.f1ow.com/mcp
- x402 pay-per-call (autonomous agents): https://mcp.f1ow.com/x402
- API key (Cursor / VS Code / custom): https://mcp.f1ow.com/ with `Authorization: Bearer <key>`
- Transport: Streamable HTTP

## REST & WebSocket APIs

The same tools, without MCP. Same credentials and metering.

- REST (Bearer API key or OAuth token): https://mcp.f1ow.com/v1 — e.g. `GET /v1/derivatives/funding/BTC`
- REST x402 pay-per-call: https://mcp.f1ow.com/x402/v1
- REST key in path: https://mcp.f1ow.com/key/{apikey}/v1
- WebSocket (JSON-RPC 2.0, subprotocol `jsonrpc-2.0`): wss://mcp.f1ow.com/v1/ws — MCP methods plus `subscriptions/subscribe` / `subscriptions/unsubscribe` (push on change, min 15s interval)
- WebSocket key in path: wss://mcp.f1ow.com/key/{apikey}/v1/ws
- OpenAPI 3.1: https://mcp.f1ow.com/openapi.json
- AsyncAPI 3.0: https://mcp.f1ow.com/asyncapi.json

## Discovery

- Discovery card: https://mcp.f1ow.com/.well-known/mcp.json
- API catalog (RFC 9727): https://mcp.f1ow.com/.well-known/api-catalog
- OAuth protected-resource (RFC 9728): https://mcp.f1ow.com/.well-known/oauth-protected-resource
- OAuth authorization server (RFC 8414): https://www.f1ow.com/.well-known/oauth-authorization-server
- JWKS: https://www.f1ow.com/.well-known/jwks.json

## Tools

Research & risk planning: research_regime, research_positioning, research_token_view, research_opportunities, research_trade_plan
Market data & history: market_quotes, market_overview, market_top_movers, market_coins, market_candles, market_history, market_coin_details, market_trending
Whale & flow: flow_whale_positions, flow_whale_context, flow_orderbook, flow_levels
Derivatives: funding_current, derivatives_open_interest, derivatives_liquidations, derivatives_flow
Options: options_chain, options_volatility, options_positioning, options_gamma, options_probability
Sentiment: sentiment_fear_greed, sentiment_social, sentiment_twitter
Events & catalysts: events_prediction_odds, catalysts_etf_flows, catalysts_calendar, catalysts_economic_calendar, catalysts_exchange_listings
Search & filings: news_search, filings_search, ta_technicals
On-chain: onchain_metrics
Utility: utc_time

## Research workflow and limits

Start with research_regime, scan with research_opportunities when needed, then
inspect a symbol with research_positioning and ta_technicals. Use flow_levels,
derivatives_flow and derivatives_liquidations for price-level and forced-flow
evidence. Check a proposed entry/stop/target with research_trade_plan; supply
account_size and risk_percent together for sizing, or placed_at and order_type
for a public-candle replay. Nothing about the trade plan is stored. MCP Apps
hosts can render interactive research views and a trade ticket.

Use market_history for paged price, open_interest, funding or liquidations
series; pass nextEndMs as end to page backwards (up to 1,000 rows per call).

Options describe implied move size, skew and expiry positioning. Gamma and
dealer-hedging what-ifs live in options_gamma and depend on an explicit
positioning scenario: modeled sensitivity, not observed dealer orders.
options_probability returns risk-neutral expiry odds, not calibrated forecasts.
Max pain is theoretical, not a price prediction. Options coverage is limited;
thin markets and missing inputs are stated in responses. Informational options
context also appears in regime, positioning and trade-plan reports.

Reports are snapshots. Re-run tools or configure WebSocket subscriptions for
change-driven updates; the server does not monitor positions automatically.
Check generatedAt, source timestamps, coverage and forming-row flags. Scores
are rule matches, not backtested expected returns.

## Links

- Home: https://www.f1ow.com
- Docs: https://www.f1ow.com/docs
- Dashboard (keys & subscription): https://www.f1ow.com/dashboard
- Terms: https://www.f1ow.com/terms
- Privacy: https://www.f1ow.com/privacy
- Refunds: https://www.f1ow.com/refunds
- Support (Telegram): https://t.me/mcp_f1ow