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

# Market Positions (Token)

> Get all wallets holding positions in a specific outcome token, sorted by P&L or size.

Returns all wallets that hold or have held positions in a specific outcome token.

## Request

```
GET /v3/markets/{token_id}/positions
```

### Query parameters

| Parameter | Type    | Default | Description                        |
| --------- | ------- | ------- | ---------------------------------- |
| `sort`    | string  | `pnl`   | Sort by: `pnl`, `amount`, `volume` |
| `limit`   | integer | 100     | Max 300                            |
| `offset`  | integer | 0       | Pagination offset                  |

## Example

```bash theme={null}
curl https://api.polynode.dev/v3/markets/75783394880030392863380883800697645018418815910449662777195626260206142035810/positions?limit=1
```

```json theme={null}
{
  "data": [
    {
      "amount": "0",
      "avg_price": "490000",
      "realized_pnl": "9999999",
      "total_bought": "19607842",
      "user": "0xa435d9eb84bf50f5d72d88023a77e8c7fd1d572d"
    }
  ],
  "elapsed_ms": 204,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1
}
```

## Response columns

| Column         | Type   | Description                              |
| -------------- | ------ | ---------------------------------------- |
| `user`         | string | Wallet address                           |
| `amount`       | string | Current shares held (6-decimal)          |
| `avg_price`    | string | Weighted-average entry price (6-decimal) |
| `realized_pnl` | string | Realized P\&L (6-decimal USDC)           |
| `total_bought` | string | Total volume bought (6-decimal USDC)     |