Poloniex MCP
The Poloniex MCP server lets you query market data and account information from the Poloniex spot exchange. It is read-only and never places or cancels trades.
get_ticker— Fetch 24-hour ticker data (last price, high, low, volume) for any spot trading pair (e.g.,BTC_USDT). No credentials required.get_orderbook— Retrieve order book depth (bids and asks) with optional limit on price levels (up to 150 per side) and price aggregation scale. No credentials required.get_balances— Access authenticated account balances, optionally filtered by account type (e.g.,SPOTorFUTURES). Requires API key and secret.(not in schema but noted in README)
get_open_orders— View active/open orders with optional filters. Requires API key and secret.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Poloniex MCP what's the current BTC_USDT ticker?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
poloniex-mcp
A local Model Context Protocol (MCP) server that
exposes the Poloniex spot exchange to any MCP client
(e.g. Claude Desktop). Built in TypeScript on the official
@modelcontextprotocol/sdk high-level McpServer API, communicating over
stdio.
Tools
All 35 tools are read-only (GET endpoints) — this server never places,
modifies, or cancels orders. Paths and parameters are validated against the
official Poloniex Python and
Java SDKs and the REST docs.
Public tools need no credentials; authenticated tools require a Poloniex API key and secret (see Credentials).
Public — market data
Tool | Endpoint | Description |
|
| 24h ticker (last, high, low, volume). Omit symbol for all. |
|
| Order book depth (bids/asks); |
|
| Latest trade price. Omit symbol for all. |
|
| Current mark price. Omit symbol for all. |
|
| Components used to derive a symbol's mark price. |
|
| OHLC candles; |
|
| Recent public trades; |
|
| Margin collateral info. Omit currency for all. |
|
| Borrow rates for all tiers and currencies. |
Public — reference data
Tool | Endpoint | Description |
|
| Trading symbols and trade-limit info. Omit symbol for all. |
|
| Supported currencies and networks; |
|
| Current Poloniex server time. |
Authenticated — account
Tool | Endpoint | Description |
|
| Account balances; |
|
| Ids, types, and state for all of the caller's accounts. |
|
| Airdrops, rebates, staking, adjustments; rich filters. |
|
| Trading fee rates and related fee info. |
|
| Margin/lending interest history. |
|
| Transfers between the caller's accounts. |
Authenticated — wallets
Tool | Endpoint | Description |
|
| Deposit addresses. Omit currency for all. |
|
| Deposit/withdrawal/adjustment activity; |
Authenticated — orders
Tool | Endpoint | Description |
|
| Active (open) orders, with optional filters. |
|
| A single order by order id or client order id ( |
|
| Historical (closed/canceled) orders, with filters. |
|
| Trades that filled a specific order (order id only). |
|
| Account trade history across orders; |
|
| Current status of the account's order kill switch. |
Authenticated — smart orders
Tool | Endpoint | Description |
|
| Active (pending) smart orders (stop / stop-limit). |
|
| A single smart order by order id or client order id. |
|
| Historical (triggered/canceled) smart orders, with filters. |
Authenticated — margin
Tool | Endpoint | Description |
|
| Margin info (equity, margin balance, available margin). |
|
| Borrow status per currency. Omit currency for all. |
|
| Max/available buy/sell size for a |
Authenticated — subaccounts
Tool | Endpoint | Description |
|
| Accounts within the caller's account group. |
|
| Balances by currency and account type per account. |
|
| Transfer records among accounts in the group, with filters. |
Symbols use Poloniex format, e.g. BTC_USDT (input is normalized, so
btc_usdt also works). Subaccount and primary-only endpoints require the
appropriate account permissions on your API key.
Related MCP server: coinex-mcp-server
Requirements
Node.js 24+ (uses global
fetch,AbortSignal.timeout, andnode:crypto).
Project structure
src/
index.ts # entry point: loads config, starts stdio transport
server.ts # builds the McpServer and registers tools
config.ts # env configuration, validated with Zod
tools/
index.ts # registerTools(): wires per-domain tool groups
shared.ts # shared helpers (result wrapping, normalization, query builders)
market.ts # public market-data tools
reference.ts # public reference-data tools (symbols, currencies, timestamp)
account.ts # authenticated account tools
wallets.ts # authenticated wallet read tools
orders.ts # authenticated order read tools
smartorders.ts # authenticated smart-order read tools
margin.ts # authenticated margin read tools
subaccounts.ts # authenticated subaccount read tools
poloniex/
client.ts # typed HTTP client (timeout + error handling)
auth.ts # HMAC-SHA256 request signing
test/
unit.test.ts # auth signing + HTTP client unit tests
server.test.ts # in-memory MCP integration tests
market.test.ts # public market/reference tool tests
account.test.ts # account & wallet tool tests
orders.test.ts # order & smart-order tool tests
margin.test.ts # margin & subaccount tool testsInstall & build
npm install
npm run buildScripts
Script | Purpose |
| Compile TypeScript to |
| Run the compiled server ( |
| Run the server from source via |
| Run the Vitest suite. |
| Run tests with a coverage report. |
| Type-check without emitting. |
| Format the codebase with Prettier. |
Credentials
The public market- and reference-data tools need no credentials. For the authenticated tools (account, wallets, orders, smart orders, margin, and subaccounts), set your Poloniex API key and secret:
POLONIEX_API_KEYPOLONIEX_API_SECRET
Optional overrides: POLONIEX_BASE_URL (default https://api.poloniex.com),
POLONIEX_TIMEOUT_MS (default 10000). Copy .env.example to .env for local
development.
Requests are signed with HMAC-SHA256 (base64), per the Poloniex
api.poloniex.com REST specification, using the key / signature /
signTimestamp headers.
Security: never commit your API key/secret. Keep them in the MCP client's
envblock (below) or a git-ignored.env. A read-only API key is recommended since this server never places trades.
Use with Claude Desktop
Build first (npm run build), then add the following to
claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and
restart Claude Desktop:
{
"mcpServers": {
"poloniex": {
"command": "node",
"args": ["/absolute/path/to/poloniex-mcp/dist/index.js"],
"env": {
"POLONIEX_API_KEY": "your-api-key-here",
"POLONIEX_API_SECRET": "your-api-secret-here"
}
}
}
}Omit the env block if you only want the public tools.
Versioning
This project follows Semantic Versioning
(MAJOR.MINOR.PATCH), starting at 0.1.0. While on 0.x, the API is
considered unstable and minor versions may include breaking changes.
PATCH — backwards-compatible bug fixes.
MINOR — backwards-compatible functionality (e.g. a new tool).
MAJOR — incompatible changes (reserved for
1.0.0and beyond).
Record every change in CHANGELOG.md under [Unreleased], then on
release bump the version with npm version <patch|minor|major> (which updates
package.json and creates a vX.Y.Z git tag) and move the notes under the new
version heading.
License
MIT © Sallehuddin Abdul Latif
Available Tools
35 toolsget_account_activityGet Account ActivityB
Fetch account activity such as airdrops, rebates, staking, and adjustments, with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, limit, endTime, currency, +3 more.
get_account_infoGet Account InfoA
Fetch account information (ids, types, and state) for all of the caller's accounts. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: no named parameters.
get_account_marginGet Account MarginA
Fetch the account's margin information (equity, margin balance, and available margin). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: accountType.
get_balancesGet BalancesA
Fetch authenticated account balances from Poloniex. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: accountType.
get_borrow_rates_infoGet Borrow Rates InfoA
Fetch borrow rates for all tiers and currencies. Public — no credentials required.
Inputs: no named parameters.
get_borrow_statusGet Borrow StatusA
Fetch the borrow status (borrowed amounts, rates, and available amounts) for margin currencies. Omit currency for all. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: currency.
get_candlesGet CandlesA
Fetch OHLC candlestick data for a symbol at a given interval. Public — no credentials required.
Inputs: symbol (required), interval (required), limit, endTime, +1 more.
get_collateral_infoGet Collateral InfoA
Fetch margin collateral information. Omit currency for all currencies, or pass one for a single currency. Public — no credentials required.
Inputs: currency.
get_currenciesGet CurrenciesA
Fetch supported currencies and their chain/network details. Omit currency for all currencies. Set v2 for the v2 response format. Public — no credentials required.
Inputs: v2, currency, includeMultiChainCurrencies.
get_deposit_addressesGet Deposit AddressesA
Fetch deposit addresses for the account. Omit currency for all currencies, or pass one for a single currency. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: currency.
get_fee_infoGet Fee InfoA
Fetch the caller's trading fee rates and related fee information. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: no named parameters.
get_interest_historyGet Interest HistoryB
Fetch the account's interest history (margin/lending). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, limit, endTime, direction, +1 more.
get_kill_switch_statusGet Kill Switch StatusA
Fetch the current status of the account's order kill switch. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: no named parameters.
get_market_tradesGet Market TradesA
Fetch recent public trades for a symbol. Public — no credentials required.
Inputs: symbol (required), limit.
get_mark_priceGet Mark PriceA
Fetch the current mark price. Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.
Inputs: symbol.
get_mark_price_componentsGet Mark Price ComponentsA
Fetch the components used to derive a symbol's mark price. Public — no credentials required.
Inputs: symbol (required).
get_max_sizeGet Max Buy/Sell SizeA
Fetch the maximum and available buy/sell amounts for a symbol on margin. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: symbol (required).
get_open_ordersGet Open OrdersA
Fetch active (open) orders for the account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, side, limit, symbol, +2 more.
get_orderGet OrderA
Fetch a single order by its order id or client order id (provide exactly one). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: id, clientOrderId.
get_orderbookGet Order BookA
Fetch order book depth (bids and asks) for a Poloniex spot symbol. Public — no credentials required.
Inputs: symbol (required), limit, scale.
get_orders_historyGet Orders HistoryA
Fetch historical (closed/canceled) orders with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, side, type, limit, +7 more.
get_order_tradesGet Order TradesA
Fetch the trades that filled a specific order, by order id. Client order id is not supported by this endpoint. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: id (required).
get_priceGet PriceA
Fetch the latest trade price. Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.
Inputs: symbol.
get_smart_open_ordersGet Open Smart OrdersA
Fetch active (pending) smart orders (stop / stop-limit) for the account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, side, limit, symbol, +1 more.
get_smart_orderGet Smart OrderA
Fetch a single smart order by its order id or client order id (provide exactly one). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: id, clientOrderId.
get_smart_orders_historyGet Smart Orders HistoryA
Fetch historical (triggered/canceled) smart orders with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, side, type, limit, +7 more.
get_subaccount_balancesGet Subaccount BalancesA
Fetch balances by currency and account type (SPOT and FUTURES) for each account in the account group. Only functional for a primary account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: no named parameters.
get_subaccountsGet SubaccountsA
Fetch all accounts within the caller's account group (primary and subaccounts). Only functional for a primary account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: no named parameters.
get_subaccount_transfer_recordsGet Subaccount Transfer RecordsA
Fetch transfer records among accounts in the account group, with optional filters. Max interval between startTime and endTime is 6 months; without them, the last 7 days are returned. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, limit, endTime, currency, +6 more.
get_symbolsGet SymbolsA
Fetch trading symbols and their trade-limit information. Omit symbol for all symbols, or pass one for a single market. Public — no credentials required.
Inputs: symbol.
get_tickerGet TickerA
Fetch 24h ticker data (last price, high, low, volume). Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.
Inputs: symbol.
get_timestampGet Server TimestampA
Fetch the current Poloniex server time. Public — no credentials required.
Inputs: no named parameters.
get_trade_historyGet Trade HistoryA
Fetch the account's trade history across orders, with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, limit, endTime, symbols, +2 more.
get_transfer_recordsGet Transfer RecordsA
Fetch records of transfers between the caller's accounts (e.g. spot <-> futures), with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: from, limit, endTime, currency, +2 more.
get_wallet_activityGet Wallet ActivityA
Fetch deposit and withdrawal activity within a time window. Both start and end are required. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.
Inputs: end (required), start (required), activityType.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 35 tools
Each getter targets a distinct resource, and the descriptions clarify public vs. authenticated data. The main overlap is get_price vs. get_ticker, both of which return a latest price, though ticker adds 24h stats. A few account-related getters could require careful reading but are conceptually separate.
All tools use a consistent get_<resource> snake_case pattern, which makes the family easy to recognize. The only minor variation is pluralization, but it follows the natural noun being accessed.
35 tools is excessive for a single MCP server and beyond the 25-tool threshold where agent tool selection suffers. Even though each getter maps to a distinct endpoint, grouping them into market-data, account, orders, and margin servers would be cleaner.
The set is entirely read-only: there are no create/cancel order, place trade, transfer, or withdrawal operations. This leaves major dead ends for a general Poloniex exchange workflow, even though market data and account-read coverage is broad.
Maintenance
Related MCP Connectors
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
JW3.ai remote MCP server for market reads and confirm-gated trading execution.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Related MCP Servers
- GoMIT

coinex-mcp-serverofficial
AlicenseNot gradedqualityDmaintenanceAn MCP server for interacting with the CoinEx cryptocurrency exchange, enabling market data queries and authenticated trading operations via AI agents.Apache 2.0- FlicenseNot gradedqualityDmaintenancePython-based MCP server that provides real-time and historical cryptocurrency data from 100+ exchanges via CCXT, with tools for tickers, OHLCV, markets, and order books.1-
- AlicenseAqualityDmaintenanceBrowser-automated MCP server for Coinbase crypto exchange, enabling live prices, portfolio management, transaction history, and trading.65 npm1MIT