> ## Documentation Index
> Fetch the complete documentation index at: https://docs.probalytics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Positions

> Lifetime share balance, cash, fees, and volume per Polymarket wallet and token

> [!NOTE]
>
> This is an **early access** dataset available through [SQL](https://docs.probalytics.io/docs/sql-guide/overview.md). To request access, email [support@probalytics.io](mailto:support@probalytics.io).

Lifetime totals per wallet and token, summed from the [wallet ledger](https://docs.probalytics.io/docs/datasets/polymarket-wallet-ledger.md). Older history comes from a daily snapshot, and recent blocks are added live, so the view is current to the chain head. Amounts are raw 6-decimal integers.

| Field | Type | Values and meaning |
| - | - | - |
| `wallet` | `string` | Wallet address. |
| `token_contract` | `string` | `ConditionalTokens` or `PositionManager`. Empty for cash-only rows. |
| `token_id` | `string` | Outcome token ID. Empty for cash-only rows (splits, merges, redemptions, transfers). |
| `shares` | `Int128` | Current token balance. |
| `cash` | `Int128` | Net USDC from trades, splits, merges, conversions, and redemptions. |
| `fees` | `Int128` | Net fees paid. |
| `transfers` | `Int128` | Net collateral moved in by plain transfers. Not part of PnL. |
| `share_volume` | `Int128` | Shares traded. |
| `usdc_volume` | `Int128` | USDC traded. |
| `trades` | `UInt64` | Number of trade rows. |

Always filter by `wallet`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.