# f1ow

> One MCP endpoint that gives Claude, ChatGPT, Cursor or your own agent live
> crypto market data — spot and perp price, derivatives, on-chain, sentiment,
> news and catalysts — already reconciled into one read. Read-only research and
> market-data tools only; no trade execution or asset transfer.

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.

## 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: research_regime, research_positioning, research_token_view, research_opportunities
Market data: market_quotes, market_overview, market_top_movers, market_coins, market_candles, market_coin_details, market_trending
Whale & flow: flow_whale_positions, flow_whale_context, flow_orderbook
Derivatives: funding_current, derivatives_open_interest
Sentiment: sentiment_fear_greed, sentiment_social, sentiment_twitter
Events & catalysts: events_prediction_odds, catalysts_etf_flows, catalysts_calendar, catalysts_economic_calendar
Search & filings: news_search, filings_search, ta_technicals
On-chain & risk: onchain_metrics, risk_position_size
Utility: providers_health, utc_time

## Links

- Home: https://www.f1ow.com
- 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