`polymarket_wallet_positions`

Pack: polymarket · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/polymarket_wallet_positions for the schema, then POST the same URL with its arguments for the data.

One Polymarket wallet’s open and closed positions, with exposure, entry basis, and P&L per position.

Tool description as the model sees it

Open and closed positions for one Polymarket wallet — size, entry basis, current mark, and realized/unrealized P&L per position, plus portfolio-level exposure and concentration (how much of the wallet’s capital sits in its single largest position — a concentration measure, not a measure of trading skill). Wallet addresses are public on-chain identifiers (0x…), looked up directly — no name/ENS resolution. Omit status to get OPEN + CLOSED together in one call; pass a specific status to filter. Use for “what is this wallet holding”, “how exposed is this wallet to market X”, “is this wallet up or down overall”.

Parameters

Name	Type	Required	Description
`wallet`	string	yes	Polymarket proxy wallet address, 0x-prefixed (40 hex chars). Get one from polymarket_holders or polymarket_trades on a market of interest.
`status`	string	no	OPEN \| CLOSED \| REDEEMABLE \| REDEEMABLE_LOST \| MERGEABLE — filter to one lifecycle state. Omit to fetch OPEN and CLOSED together (default).
`limit`	number	no	Rows per page, 1-500 (default 50).
`cursor`	string	no	Opaque pagination cursor from a previous call’s `next_cursor` — omit for the first page.

Example call

Arguments

{
  "wallet": "0x2cc8cc54f50dbb45fe346612821ca93b6e93262b",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/polymarket/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"polymarket_wallet_positions","arguments":{"wallet":"0x2cc8cc54f50dbb45fe346612821ca93b6e93262b","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('polymarket_wallet_positions', {
  "wallet": "0x2cc8cc54f50dbb45fe346612821ca93b6e93262b",
  "limit": 20
});

More examples

{
  "wallet": "0x2cc8cc54f50dbb45fe346612821ca93b6e93262b",
  "status": "CLOSED",
  "limit": 10
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the polymarket pack

{
  "mcpServers": {
    "polymarket": {
      "url": "https://gateway.pipeworx.io/polymarket/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

polymarket_wallet_positions