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

# Users

> A wallet's positions and trade history.

## GET /users/:address/positions

```bash theme={null}
curl https://api.signalium.site/users/0x3B4f0135465d444a5bD06Ab90fC59B73916C85F5/positions?rich=1
```

| Query  | Type                                            | Default |
| ------ | ----------------------------------------------- | ------- |
| `rich` | `1` to inline market metadata, `0` for ids only | `0`     |

Rich response:

```json theme={null}
{
  "positions": [
    {
      "user": "0x3b4f…85F5",
      "yesShares": "9900000000000000",
      "noShares": "49500000000000000",
      "claimed": false,
      "claimedAmount": "0",
      "updatedAt": "2026-04-29T15:42:11.000Z",
      "market": {
        "address": "0x1b89…0639",
        "question": "Will State Street launch tokenized fund servicing from Luxembourg by 2026-12-31?",
        "status": 0,
        "outcome": 0
      }
    }
  ]
}
```

## GET /users/:address/trades

Recent trades for one wallet.

| Query   | Type | Default |
| ------- | ---- | ------- |
| `limit` | int  | `50`    |