MCP server · market data for AI assistants

MCP-сервер · данные рынка для ИИ-ассистентов

Crypto market data for your AI assistant: the Liqwall MCP server

Данные крипторынка для вашего ИИ-ассистента: MCP-сервер Liqwall

Connect Claude or another assistant that speaks the Model Context Protocol to the data of the Liqwall terminal and ask about the market in plain words. The assistant gets order-book walls of 14 exchanges, liquidations, funding, open interest, options levels and the large Hyperliquid positions with their stops and liquidation prices. The server only reads data: it never places orders and has no access to your exchange accounts or wallets.

Подключите Claude или другого ассистента, который работает по протоколу Model Context Protocol, к данным терминала Liqwall и спрашивайте о рынке обычными словами. Ассистент получает стены в стаканах 14 бирж, ликвидации, фандинг, открытый интерес, уровни опционов и крупные позиции Hyperliquid с их стопами и ценами ликвидации. Сервер только читает данные: он не ставит заявок и не имеет доступа к вашим счетам на биржах и кошелькам.

https://liqwall.com/mcp 6 tools, read-only 6 инструментов, только чтение Access with your API key Доступ по вашему ключу API From the Basic plan С тарифа Basic

What you can ask

Что можно спросить

You write an ordinary question. The assistant decides which tool to call and answers from what the server returns.

Вы пишете обычный вопрос. Ассистент сам решает, какой инструмент вызвать, и отвечает по тому, что вернул сервер.

  • What is the crypto market doing right now, and which coins stand out?
  • Что сейчас делает крипторынок и какие монеты выделяются?
  • Where are the nearest walls and liquidation clusters for BTC, above and below the price?
  • Где ближайшие стены и скопления ликвидаций по BTC выше и ниже цены?
  • Who are the largest Hyperliquid players in ETH right now? Show their entries, stops and liquidation prices.
  • Кто сейчас крупнейшие игроки Hyperliquid в ETH? Покажи их входы, стопы и цены ликвидации.
  • Has open interest in SOL been growing over the last 24 hours, and how has funding changed?
  • Рос ли открытый интерес по SOL за последние 24 часа и как менялся фандинг?
  • Give me a summary of BTC before I trade: order book, funding, positioning, liquidations, options levels.
  • Дай сводку по BTC перед сделкой: стакан, фандинг, позиции, ликвидации, уровни опционов.
  • Show the last 48 hourly candles of ETH and tell me where the high and the low of the range were.
  • Покажи последние 48 часовых свечей ETH и скажи, где были максимум и минимум диапазона.

Six tools

Шесть инструментов

Every tool only reads. The answer is JSON; times are UTC in ISO 8601. The fields missing and stale name what could not be fetched or is out of date, so the assistant says so and does not guess.

Каждый инструмент только читает. Ответ приходит в JSON; время — UTC в формате ISO 8601. Поля missing и stale называют то, что не удалось получить или что устарело: ассистент говорит об этом прямо и не гадает.

marketMarket overviewОбзор рынка

Ask“What is the market doing?”, “Does this coin stand out from the market?”

Спросить«Что делает рынок?», «Выделяется ли эта монета на фоне рынка?»

ReturnsThe main coins with price, change, order-book skew, share of market buys, open interest, funding, long share, liquidations, large and small Hyperliquid accounts and margin loans; USDT margin loans of the whole market; the top-50 basket; sector strength; the coins with the strongest deviations.

ВернётГлавные монеты: цена, изменение, перекос стакана, доля рыночных покупок, открытый интерес, фандинг, доля лонгов, ликвидации, крупные и мелкие счета Hyperliquid, маржинальные займы; займы USDT по всему рынку; корзину топ-50; силу секторов; монеты с самыми сильными отклонениями.

ArgumentsNone.

ПараметрыНет.

coinCoin summaryСводка монеты

Ask“Give me a summary of BTC”, “What is going on with SOL?”

Спросить«Дай сводку по BTC», «Что происходит с SOL?»

ReturnsPrice and changes, Binance order-book skew by depth from 0.5% to 6% on spot and perpetuals, trades over the last hour, open interest, funding, longs and shorts, top traders, futures basis, Coinbase premium, liquidations, margin loans, options, the nearest wall and liquidation cluster, and the Hyperliquid summary.

ВернётЦену и изменения, перекос стакана Binance по глубинам от 0,5% до 6% на споте и бессрочных контрактах, сделки за последний час, открытый интерес, фандинг, лонги и шорты, топ-трейдеров, базис фьючерсов, премию Coinbase, ликвидации, маржинальные займы, опционы, ближайшую стену и скопление ликвидаций, сводку Hyperliquid.

Argumentscoin — a ticker: BTC, ETH, SOL, XRP, HYPE and others; also XAU, XAG, CL, SPY, QQQ. Pair names such as BTCUSDT work too.

Параметрыcoin — тикер: BTC, ETH, SOL, XRP, HYPE и другие; также XAU, XAG, CL, SPY, QQQ. Имена пар вроде BTCUSDT тоже принимаются.

levelsPrice levelsУровни цены

Ask“Where are the levels?”, “How far can it go?”, “Where are the stops and liquidations?”

Спросить«Где уровни?», «Как далеко может пойти цена?», «Где стопы и ликвидации?»

ReturnsBid walls below and ask walls above the price with their size, exchanges and age; liquidation clusters; the Hyperliquid map of liquidations, stops, take-profits and resting orders within 1, 2, 5 and 10% of the price; options levels: max pain, call and put walls, gamma flip, expected move, the largest strikes; prediction-market probabilities; absorptions over the last 24 hours; the range band of the current day.

ВернётСтены покупок ниже цены и стены продаж выше неё с размером, биржами и возрастом; скопления ликвидаций; карту Hyperliquid — ликвидации, стопы, тейки и лимитные заявки в пределах 1, 2, 5 и 10% от цены; уровни опционов: max pain, стены коллов и путов, точку смены гаммы, ожидаемый ход, крупнейшие страйки; вероятности рынков прогнозов; поглощения за последние 24 часа; коридор текущего дня.

Argumentscoin — the ticker of the coin.

Параметрыcoin — тикер монеты.

whalesHyperliquid whalesКиты Hyperliquid

Ask“What are the whales doing in ETH?”, “Who stands behind this wall?”

Спросить«Что делают киты в ETH?», «Кто стоит за этой стеной?»

ReturnsThe 10 largest positions with side, size, entry, liquidation price, stop, take-profit and the result of the account; large market orders over 6 hours; changes of large positions over 24 hours; working TWAP orders; long-standing walls in the book with their owners.

Вернёт10 крупнейших позиций: сторона, размер, вход, цена ликвидации, стоп, тейк и результат счёта; крупные рыночные заявки за 6 часов; изменения крупных позиций за 24 часа; работающие заявки TWAP; давно стоящие стены в стакане с их владельцами.

Argumentscoin — the ticker of the coin.

Параметрыcoin — тикер монеты.

seriesIndicator seriesРяд индикатора

Ask“Is the order book getting stronger?”, “Is open interest growing?”, “Who was buying over the last day?”

Спросить«Стакан становится сильнее?», «Растёт ли открытый интерес?», «Кто покупал за последние сутки?»

ReturnsThe history of one indicator: a summary of every column (the last value, the change over 1, 4 and 24 hours, the place of the last value within its window, the minimum and the maximum) and up to 48 points. More than 40 kinds of series:

ВернётИсторию одного индикатора: сводку по каждой колонке (последнее значение, изменение за 1, 4 и 24 часа, место последнего значения в своём окне, минимум и максимум) и до 48 точек. Больше 40 видов рядов:

  • Order book: book_spot, book_perp, wall_pull_spot, wall_pull_perp
  • Стакан: book_spot, book_perp, wall_pull_spot, wall_pull_perp
  • The whole market, top-50 basket: market_book, market_breadth, market_funding, market_oi, sectors
  • Весь рынок, корзина топ-50: market_book, market_breadth, market_funding, market_oi, sectors
  • Trades: trades_spot, trades_perp, cvd_spot, cvd_perp, trade_sizes, spot_vs_perp
  • Сделки: trades_spot, trades_perp, cvd_spot, cvd_perp, trade_sizes, spot_vs_perp
  • Derivatives and positioning: oi, funding, long_short, top_traders, liquidations, basis, coinbase_premium
  • Деривативы и позиции: oi, funding, long_short, top_traders, liquidations, basis, coinbase_premium
  • Margin loans: loans_coin, loans_usdt, margin_long_short
  • Маржинальные займы: loans_coin, loans_usdt, margin_long_short
  • Hyperliquid: hl_positions, hl_flow
  • Hyperliquid: hl_positions, hl_flow
  • Options: dvol, opt_iv, opt_skew, opt_oi, opt_gex, opt_flow, opt_structures
  • Опционы: dvol, opt_iv, opt_skew, opt_oi, opt_gex, opt_flow, opt_structures

The full list with a description of every kind comes with the tool itself. A kind the server does not know returns the list of all kinds.

Полный список с описанием каждого вида приходит вместе с самим инструментом. На вид, которого сервер не знает, он отвечает списком всех видов.

Argumentskind — required. coin — not needed for whole-market kinds. tf — 1m, 5m, 15m, 1h, 4h, 1d; 1h if omitted. bars — from 2 to 500. exchange — where a kind offers a choice: binance, coinbase, hyperliquid, bybit, okx, gate, kraken, aster, deribit, or all for every exchange together. depth — order-book depth in % of the price. columns — which columns to return as points.

Параметрыkind — обязателен. coin — не нужен для рядов всего рынка. tf — 1m, 5m, 15m, 1h, 4h, 1d; без него — 1h. bars — от 2 до 500. exchange — там, где у ряда есть выбор: binance, coinbase, hyperliquid, bybit, okx, gate, kraken, aster, deribit или all — все биржи вместе. depth — глубина стакана в % от цены. columns — какие колонки вернуть точками.

candlesCandlesСвечи

Ask“Show the last 48 hourly candles of ETH”, “Where were the high and the low this week?”

Спросить«Покажи последние 48 часовых свечей ETH», «Где были максимум и минимум на этой неделе?»

ReturnsBinance candles — the perpetual, or spot for a coin without one: OHLCV and a summary of the window with the change, the high and the low with their times, ATR, and volume against its average.

ВернётСвечи Binance — бессрочный контракт, а для монеты без него спот: OHLCV и сводку окна — изменение, максимум и минимум с их временем, ATR, объём относительно своего среднего.

Argumentscoin — the ticker of the coin. tf — from 1m to 1w; 1h if omitted. bars — from 2 to 300.

Параметрыcoin — тикер монеты. tf — от 1m до 1w; без него — 1h. bars — от 2 до 300.

How to connect

Как подключить

1. Get your API key

1. Получите ключ API

Open the terminal, sign in, open the account menu and choose Plan and API. Press Create key and copy the key at once: it is shown only one time. MCP access is included from the Basic plan.

Откройте терминал, войдите, откройте меню аккаунта и выберите Тариф и API. Нажмите Создать ключ и сразу скопируйте ключ: он показывается только один раз. Доступ к MCP входит в тариф Basic и выше.

2. Claude Code

2. Claude Code

One command in the terminal of your computer. Put your key in place of YOUR_API_KEY.

Одна команда в терминале вашего компьютера. Вместо YOUR_API_KEY подставьте свой ключ.

claude mcp add --transport http liqwall https://liqwall.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

3. A client with a settings file

3. Клиент с файлом настроек

Many clients describe a remote server in a JSON file. This is the entry for .mcp.json of Claude Code. In other clients the meaning is the same — the address and one header — and the field names follow the documentation of the client.

Многие клиенты описывают удалённый сервер в файле JSON. Это запись для файла .mcp.json в Claude Code. В других клиентах смысл тот же — адрес и один заголовок, — а имена полей смотрите в документации клиента.

{
  "mcpServers": {
    "liqwall": {
      "type": "http",
      "url": "https://liqwall.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Either header works: Authorization with the word Bearer before the key, or X-API-Key with the key alone. A key in the address is not accepted.

Подходит любой из двух заголовков: Authorization со словом Bearer перед ключом или X-API-Key с одним ключом. Ключ в адресе не принимается.

4. Check the connection

4. Проверьте подключение

Ask the assistant: “What is the crypto market doing right now?” Or send one request yourself — the answer lists the six tools.

Спросите ассистента: «Что сейчас делает крипторынок?» Или отправьте один запрос сами — в ответе придёт список шести инструментов.

curl -s -X POST https://liqwall.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/list"}'

For developers

Для разработчиков

  • Address: POST https://liqwall.com/mcp. Transport: Streamable HTTP; every request gets one JSON answer.
  • Адрес: POST https://liqwall.com/mcp. Транспорт: Streamable HTTP; на каждый запрос приходит один ответ в JSON.
  • Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
  • Версии протокола: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
  • Apps that accept only a server address and sign you in through the browser are not supported yet: the server needs the key in a header.
  • Приложения, которые принимают только адрес сервера и ведут вход через браузер, пока не поддерживаются: серверу нужен ключ в заголовке.

Limits

Пределы

PlanТарифTool calls per minuteВызовов инструментов в минуту
Basic37
Standard87
Advanced375
  • The limit is counted per account: several keys of one account share it.
  • Предел считается на аккаунт: несколько ключей одного аккаунта делят его между собой.
  • Up to 2 calls of one account run at the same time.
  • Одновременно выполняется до 2 вызовов одного аккаунта.
  • One call takes up to 60 seconds; a request is up to 64 KB.
  • Один вызов длится до 60 секунд; запрос — до 64 КБ.
  • Above the limit the server answers with an error and the field retry_after_s: after how many seconds to repeat.
  • Сверх предела сервер отвечает ошибкой с полем retry_after_s: через сколько секунд повторить.
  • How far back the history goes follows your plan.
  • Глубина истории зависит от вашего тарифа.

Plan

Тариф

The MCP server is part of the Basic plan and every plan above it, at no extra charge. The same key works for the data API. What a plan does not include comes back as a line in missing, not as a failure.

MCP-сервер входит в тариф Basic и во все тарифы выше, без доплаты. Тот же ключ работает и для API данных. То, чего нет в тарифе, приходит строкой в поле missing, а не сбоем.

If something fails

Если не работает

AnswerОтветWhat it means and what to doЧто это значит и что делать
401No key, or the key was not accepted. Check the header and the key; create a new key if needed.Ключа нет или он не принят. Проверьте заголовок и сам ключ; при необходимости создайте новый.
403The plan has no MCP access, the account is blocked, or the request came from a web page of another site.В тарифе нет доступа к MCP, аккаунт заблокирован или запрос пришёл со страницы другого сайта.
429The request limit of the plan is reached. The header Retry-After says after how many seconds to repeat.Исчерпан предел запросов тарифа. Заголовок Retry-After говорит, через сколько секунд повторить.
405The address answers POST requests only.Адрес отвечает только на запросы POST.
413The request is longer than 64 KB.Запрос длиннее 64 КБ.
503The server is busy. Repeat in a few seconds.Сервер занят. Повторите через несколько секунд.
isErrorThe tool could not answer: no such coin or a wrong argument. The field error carries the code, and the text says what to fix.Инструмент не смог ответить: нет такой монеты или неверный параметр. В поле error — код, в тексте — что исправить.

Questions

Вопросы

Can the assistant trade for me through this server?

Может ли ассистент торговать за меня через этот сервер?

No. The server only reads market data. It does not place orders and has no access to your exchange accounts, wallets or keys of exchanges.

Нет. Сервер только читает рыночные данные. Он не ставит заявок и не имеет доступа к вашим счетам на биржах, кошелькам и ключам бирж.

Which assistants can use it?

Какие ассистенты могут им пользоваться?

Any MCP client that connects to a remote server over HTTP and lets you set a request header. The command for Claude Code is above; in other clients you enter the same two things, the address and the header.

Любой MCP-клиент, который подключается к удалённому серверу по HTTP и позволяет задать заголовок запроса. Команда для Claude Code приведена выше; в других клиентах вводятся те же две вещи — адрес и заголовок.

What do missing and stale mean in an answer?

Что значат missing и stale в ответе?

missing lists the parts that could not be fetched in time or are not in your plan. stale lists the parts that are older than they should be. The rest of the answer is complete.

missing перечисляет части, которые не удалось получить вовремя или которых нет в вашем тарифе. stale перечисляет части, которые старше положенного. Остальной ответ полный.

Which coins are covered?

Какие монеты есть?

The coins of the Liqwall terminal: BTC, ETH, SOL and the other large coins, plus several instruments of traditional markets such as gold and oil. For a coin the server does not know, the tool says so.

Монеты терминала Liqwall: BTC, ETH, SOL и другие крупные монеты, а также несколько инструментов традиционных рынков, например золото и нефть. Если монеты на сервере нет, инструмент так и ответит.

Where do I get help?

Куда обратиться за помощью?

Write to the support bot in Telegram: @Liqwallsupportbot. The rules of the service are on the Terms page, and what we store is on the Privacy page.

Напишите боту поддержки в Telegram: @Liqwallsupportbot. Правила сервиса — на странице «Условия», а что мы храним — на странице «Конфиденциальность».