Repository avatar
Other Tools
v1.1.1
active

orderflow

uk.swiftedge/orderflow

Free live order flow for BTC, gold, US 500 and more: order book, CVD, liquidations, funding.

Documentation

Swiftedge order flow: free MCP server and API

Free, live order flow data for AI assistants and your own code: order book depth and walls, candles with buy/sell volume and CVD, large trades, real liquidations, an estimated liquidation map, funding, open interest and key price levels for Bitcoin, Ethereum, Solana, XRP, gold, silver, the US 500, the US 100 and WTI crude oil.

  • MCP server: https://swiftedge.uk/mcp (Streamable HTTP, no key, no account)
  • REST API: https://swiftedge.uk/api/v1/... (JSON, no key, no account)
  • OpenAPI 3.1: /api/v1/openapi.json (also works as a ChatGPT GPT action)
  • Docs: swiftedge.uk/developers
  • Listed in the official MCP Registry as uk.swiftedge/orderflow

The same numbers are drawn live in Swiftedge Depth, a free order book heatmap with every trade, a footprint chart and 30+ indicators in the browser.

Live pages for every market

Every market trades 24/7 on Swiftedge. Each one has a free live order book heatmap and a levels page that is updated all day. The sessions pages show when the underlying market opens, closes and releases data, in your own time zone.

MarketLive heatmapLevels todayTrading sessionsGuide
Bitcoin/depth/btc/levels/btc/sessionsBitcoin levels explained
Gold/gold/depth/gold/levels/gold/sessionsGold order flow
Silver/silver/depth/silver/levels/silver/sessionsSilver order flow
WTI crude oil/wti/depth/wti/levels/wti/sessionsOil order flow
US 100/us100/depth/us100/levels/us100/sessionsUS 100 order flow
US 500/sp500/depth/sp500/levels
Ethereum/eth/depth/eth/levels
Solana/sol/depth/sol/levels
XRP/xrp/depth/xrp/levels

More guides: silver levels, oil levels, US 100 levels and Bitcoin trading sessions. The weekly COT report covers all nine markets, and the economic calendar shows how much past releases moved the markets in the first hour.

Connect it to your AI app

Claude (claude.ai or the desktop app): Settings → Connectors → Add custom connector, and paste https://swiftedge.uk/mcp.

Claude Code:

claude mcp add --transport http swiftedge https://swiftedge.uk/mcp

Cursor and other clients with an mcp.json:

{
  "mcpServers": {
    "swiftedge": { "url": "https://swiftedge.uk/mcp" }
  }
}

ChatGPT: import openapi.json as a GPT action.

Then ask, for example:

  • "Where are the biggest bid walls on gold right now?"
  • "Show me Bitcoin's CVD on the 4-hour chart."
  • "Where would longs on Solana get liquidated?"
  • "How much does CPI usually move gold in the first hour?"

Tools

Every tool is read-only. Each one is also a plain GET endpoint on https://swiftedge.uk.

MCP toolREST endpointWhat you get
list_markets/api/v1/marketsThe markets and their codes
get_market_snapshot/api/v1/snapshot?market=btcPrice, today's range, order book walls, resting liquidity, positioning levels, funding, open interest, large trades and liquidations near price
get_markets_overview/api/v1/markets-overviewEvery market in one table: price, change since 00:00 UTC, funding, 24-hour open interest change and the positioning flip
get_order_book/api/v1/order-book?market=btcThe live order book grouped by price level: largest bids and asks, resting USD per side and the imbalance
get_candles/api/v1/candles?market=btc&timeframe=4hOHLC candles with volume split into aggressive buying and selling, delta and cumulative volume delta (CVD)
get_large_trades/api/v1/large-trades?market=btcLarge aggressive market orders in the last 24 hours: totals, per hour, the 10 largest and the 10 latest
get_liquidations/api/v1/liquidations?market=btcLiquidations that really happened in the last 1-24 hours, longs and shorts in USD
get_liquidation_heatmap/api/v1/liquidation-heatmap?market=btcWhere leveraged positions would be liquidated within 5 % of price, with the largest clusters
get_funding_and_open_interest/api/v1/funding-and-open-interest?market=btcFunding (8-hour and annualized), next funding time, open interest and its 1/4/24-hour change
get_key_levels/api/v1/key-levels?market=goldToday's important prices above and below the live price: walls, positioning levels, high, low and open
get_economic_calendar/api/v1/economic-calendar?days=7Upcoming releases (CPI, jobs, central banks) with how much markets moved in the first hour after past releases
get_research_studies/api/v1/research-studiesSwiftedge's published studies with links and headline findings

Market codes: btc, eth, sol, xrp, gold, silver, us500, us100, oil. /api/v1/markets always lists the current set.

Use the REST API

curl "https://swiftedge.uk/api/v1/snapshot?market=btc&src=github"
curl "https://swiftedge.uk/api/v1/key-levels?market=gold&src=github"

Python (examples/snapshot.py) and JavaScript (examples/snapshot.mjs) examples print the order book walls and key levels for any market. examples/mcp_call.sh talks to the MCP server with plain curl.

Good to know

  • Free, no key. Please link to swiftedge.uk when you show the data, for example under a chart or in a bot's reply.
  • Freshness. A snapshot is at most about 15 seconds old, the order book about 10 seconds and the liquidation map about 5 minutes. Responses are cached for 15 seconds, so polling faster returns the same numbers.
  • Fair use. The same limit as the rest of the site.
  • What the numbers are. Swiftedge's own calculations on public perpetual futures order books and trades. Positioning levels and the liquidation map are estimates, not measurements and not a forecast. The data is descriptive and places no orders.
  • Live chart. For tick-by-tick data, open the live heatmap. You can also paper trade on the live order book and join the free Order Flow Cup.

License

The example code and this README are MIT licensed (see LICENSE). The API and MCP server are a free service run by Swiftedge, provided as is.

No installation packages available.

Remote