MCP tool reference · #217 of 563 by publishers
get_positions
Exposed by 13 servers from 13 publishers, read from the live servers by the Serverdex check; most of them sit in Finance; 23.1% of them take a limit parameter; the most-starred is CoinRithm Agent Trading (4 stars).
get_positions(…)Parameters
share = % of the 13 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 23.1% | 0% | How many positions, 1 to 100. Default 50. |
| status | string | 15.4% | 0% | Position status filter |
| symbol | string | 15.4% | 0% | Filter by trading pair, e.g. BTC, ETHUSDT |
| wallet | array | 15.4% | 0% | Scope to one wallet or a book of wallets (up to 25). Each value is a wallet address, a known username, or a trd_-prefixed trader id, resolved like get_trader |
| _apiKey | string | 7.7% | 0% | Optional, your own N2YO API key for higher limits; omit to use the shared Pipeworx key. |
| account | string | 7.7% | 100% | — |
| address | string | 7.7% | 100% | 0x-prefixed 20-byte account address (0x followed by 40 hex characters) |
| agentTrace | object | 7.7% | 0% | Optional private trace metadata stored in the caller's ledger. |
| altitude | number | 7.7% | 0% | Observer altitude in meters above sea level (default 0). |
| category | string | 7.7% | 0% | Filter by provider-backed market category. One category such as Basketball or Esports; the word sports is rejected, so omit category for every sports and esport |
| chainId | integer | 7.7% | 0% | Chain to target. Supported: 1, 4663. Default: 1. |
| condition_id | string | 7.7% | 0% | Scope to one market: raw provider condition_id or mkt_-prefixed market id |
Source: the input schema each server returns for get_positions, aggregated over the 13 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with get_positions
13 of 13 · 13 publishers · 13 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes get_positions |
|---|---|---|---|---|---|---|
| 1 | CoinRithm Agent Tradingcoinrithm · Finance | coinrithm | Finance | 4 | yes | List open + historical positions for a venue. venue='futures' returns mock futures positions (with unrealized PnL + liquidation distance on open ones); venue='pm' returns mock prediction-market positions (with unrealized mark on open ones). Response includes asOf — pass it back as updatedSince on the next call to poll only positions that changed (catches worker-fired SL/TP, liquidations, and settl |
| 2 | TraderSpytarget1m · Finance | target1m | Finance | 3 | yes | Use this when the user asks for current or historical smart-money positions, optionally filtered by status, source, or symbol. |
| 3 | 0xinsider0xinsider · Crypto & Web3 | 0xinsider | Crypto & Web3 | 1 | yes | Current prediction-market positions from the public positions-board feed, cursor-paginated by current value, largest first. Under 5 decided markets trader.win_rate_status is not_enough_data: give trader.markets_decided, not trader.win_rate as a rate. data_quality (beside data) reads as get_trader describes: stale is not a tolerance, and unknown is never recent. consistency=snapshot adds the snapsh |
| 4 | make.funmakedotfun · Business & CRM | makedotfun | Business & CRM | 1 | yes | Use this when you want to see your side bets and how they stand. With slug, one market's for one wallet (GET /api/competitions/<slug>/market/me; wallet: which, any Solana wallet whose keypair you hold, on your account or not, default the one the market routes answer for you: your own agent wallet when your key came from agent connect, else your sign-in wallet, else your first): wallets (your accou |
| 5 | CoinCryptoRank MCPqqdd27 · Finance | qqdd27 | Finance | 1 | yes | The user's open positions from our registry (user_positions) — what the agent/bots have open. Params: exchange (optional), symbol (optional). |
| 6 | Vordium MCPvordium · Finance | vordium | Finance | — | yes | An account's open positions as the chain stores them. Ask: "What positions does 0x… hold?" |
| 7 | N2YO (Unofficial)pipeworx-io · APIs & Integrations | pipeworx-io | APIs & Integrations | — | yes | Track where a satellite is right now (or in the next few seconds): get its live latitude, longitude, altitude, and look-angles (azimuth/elevation) from an observer on Earth. Use this to answer "where is the ISS right now?" (NORAD id 25544) or to locate any satellite by NORAD id. Example: get_positions({ norad_id: 25544, lat: 40.71, lon: -74.0 }). |
| 8 | Vectorial Data Terminal: Hyperliquid, Polymarket & yield for AI agentsvectorialdata · Crypto & Web3 | vectorialdata | Crypto & Web3 | — | yes | Open positions (live: venue truth; paper: from your fills). |
| 9 | Hedgehood Options0xhedgehood · Finance | 0xhedgehood | Finance | — | yes | ACTIVE positions: open positions, cost basis and leaderboard row of an account (and its ERC-8004 agent id when it has one). Past activity is get_history; marks / PnL are get_pnl; exit before expiry with close_quote. |
| 10 | WakeTradeswaketrades · Crypto & Web3 | waketrades | Crypto & Web3 | — | yes | Copied positions with their stop and take profit, and openedAt (ms) for their age. |
| 11 | Lucydlucyd-trade · Finance | lucyd-trade | Finance | — | yes | Positions of a wallet: tokens held per market and outcome, average price, current value and profit. Settled markets show the payout. Defaults to the configured wallet. |
| 12 | Leveragespiral-stake · APIs & Integrations | spiral-stake | APIs & Integrations | — | yes | Read a wallet's open/closed Spiral leverage positions from chain state (read-only). For each: collateral/loan, leveraged collateral, net equity, debt, current LTV vs liquidation LTV (with headroom), current leverage, net USD value, and current leveraged APY. No cost-basis / realized P&L (those need off-chain history). Newest first. `equityPositions` lists the wallet's open equity vaults (stock leg |
| 13 | Rubin Exchangerubin-trade · Finance | rubin-trade | Finance | — | yes | Get perpetual POSITIONS with size, side, entryPrice, unrealizedPnl, realizedPnl and netFunding. Defaults to OPEN positions. NOTE: a position is what you HOLD after an order fills — it is NOT an open order. When the user asks loosely "what is open?", check BOTH this and get_open_orders (or call get_portfolio for both at once). |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint.