# Overview

> Crypto market data for AI agents — one MCP server, REST API and WebSocket API with live prices, derivatives, options, order flow, on-chain, sentiment, news and catalysts.

Source: https://www.f1ow.com/docs

f1ow gives Claude, ChatGPT, Cursor, VS Code or your own agent the whole crypto market through **one endpoint**. Prices, perpetual derivatives, options, order flow, whale positioning, on-chain activity, sentiment, news and catalysts are drawn from many sources and reconciled into one read. That read is available as 39 tools.

> New here? Start a free trial: https://www.f1ow.com/dashboard

## Three ways in

- [MCP server](https://www.f1ow.com/docs/connect/claude): Point Claude, ChatGPT, Cursor or VS Code at one URL. The model discovers every tool and calls them on its own.
- [REST API](https://www.f1ow.com/docs/api/rest): Every tool is a plain HTTP resource with JSON responses and an OpenAPI 3.1 spec. Bring your own code.
- [WebSocket API](https://www.f1ow.com/docs/api/websocket): JSON-RPC 2.0 over a socket, with subscriptions that push only when a result changes.

All three share the same tools, the same API key and the same balance. Agents without an account can [pay per call with x402](https://www.f1ow.com/docs/auth#x402).

## What you can ask

- **Research & risk** (5): `research_regime`, `research_positioning`, `research_opportunities`, `research_trade_plan`, `research_token_view`
- **Market data** (8): `market_quotes`, `market_candles`, `market_history`, `market_overview`, `market_top_movers`, `market_trending`, `market_coin_details`, `market_coins`
- **Derivatives** (4): `derivatives_flow`, `derivatives_liquidations`, `funding_current`, `derivatives_open_interest`
- **Options** (5): `options_chain`, `options_volatility`, `options_positioning`, `options_gamma`, `options_probability`
- **Order flow & whales** (4): `flow_whale_positions`, `flow_orderbook`, `flow_levels`, `flow_whale_context`
- **Technicals** (1): `ta_technicals`
- **Sentiment** (3): `sentiment_fear_greed`, `sentiment_social`, `sentiment_twitter`
- **News & filings** (2): `news_search`, `filings_search`
- **Events & catalysts** (5): `catalysts_etf_flows`, `events_prediction_odds`, `catalysts_calendar`, `catalysts_economic_calendar`, `catalysts_exchange_listings`
- **On-chain** (1): `onchain_metrics`
- **Utilities** (1): `utc_time`

The composite **research** tools assemble many reads at once:

- [Market Regime](https://www.f1ow.com/docs/tools/research_regime) tells you what kind of market you are trading in.
- [Positioning](https://www.f1ow.com/docs/tools/research_positioning) shows who is crowded, fragile or trapped on one coin.
- [Opportunity Scan](https://www.f1ow.com/docs/tools/research_opportunities) scans liquid coins for rule-based setups.
- [Trade Plan Review](https://www.f1ow.com/docs/tools/research_trade_plan) checks an entry, stop and target, sizes the position and replays a placed trade.

The rest are focused building blocks: quotes, candles, funding, open interest, liquidations, order books, options chains and more. See the [tool reference](https://www.f1ow.com/docs/tools).

## Who it is for

- [AI traders](https://www.f1ow.com/docs/use-cases/ai-traders): Ask Claude or ChatGPT about the market in plain English and get answers grounded in live data.
- [Trading bot developers](https://www.f1ow.com/docs/use-cases/trading-bots): Feed your strategy funding, open interest, liquidations and levels from one REST or WebSocket API.
- [Agent builders](https://www.f1ow.com/docs/use-cases/agent-builders): Give an autonomous agent a market-data toolset with typed schemas, pay-per-call and machine-readable discovery.

## What it is not

f1ow is read-only. It observes the market and returns snapshots. It never places orders, holds funds or watches positions for you. Setup scans and trade plans are rule-based planning geometry, not personalized advice or a promise of returns.

## Machine-readable

- [OpenAPI 3.1](https://mcp.f1ow.com/openapi.json) and [AsyncAPI 3.0](https://mcp.f1ow.com/asyncapi.json) specs
- [MCP discovery card](https://mcp.f1ow.com/.well-known/mcp.json) and [API catalog (RFC 9727)](https://mcp.f1ow.com/.well-known/api-catalog)
- Every docs page as Markdown (append `.md`), [`/llms.txt`](https://www.f1ow.com/llms.txt) and [`/llms-full.txt`](https://www.f1ow.com/llms-full.txt)