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

# TWAP List Active

## Endpoint

```text theme={null}
POST /info
```

## Request Body

| Parameter | Type   | Description                |
| --------- | ------ | -------------------------- |
| `type`\*  | string | Must be `"twapListActive"` |
| `user`\*  | string | User wallet address        |

## Response

```json theme={null}
[
  {
    "twapId": "0x1a2b3c...",
    "status": "active",
    "asset": "BTC",
    "side": "buy",
    "totalSz": "0.25",
    "filledSz": "0.10",
    "remainingSz": "0.15",
    "reduceOnly": false,
    "slicesFilled": 2,
    "slicesPartial": 0,
    "slicesRejected": 0,
    "totalNotional": "5030.000000",
    "avgFillPx": "50300.000000",
    "durationMs": 1800000,
    "sliceIntervalMs": 300000,
    "startedAt": 1701234567890,
    "expectedEndAt": 1701236367890,
    "currentSliceIndex": 2,
    "totalExpectedSlices": 7,
    "randomize": true,
    "createdAt": 1701234567890,
    "updatedAt": 1701235167890,
    "completedAt": null,
    "canceledAt": null,
    "reason": null
  }
]
```

### Response Fields

| Field                 | Type           | Description                                        |
| --------------------- | -------------- | -------------------------------------------------- |
| `twapId`              | string         | TWAP order id                                      |
| `status`              | string         | Current TWAP status                                |
| `asset`               | string         | Perp market symbol or spot pair base symbol        |
| `side`                | string         | `"buy"` or `"sell"`                                |
| `totalSz`             | string         | Total requested size                               |
| `filledSz`            | string         | Aggregate filled size                              |
| `remainingSz`         | string         | Remaining size                                     |
| `reduceOnly`          | boolean        | Whether execution is reduce-only                   |
| `slicesFilled`        | number         | Count of fully filled suborders                    |
| `slicesPartial`       | number         | Count of partially filled suborders                |
| `slicesRejected`      | number         | Count of rejected or skipped suborders             |
| `totalNotional`       | string         | Sum of `filledSz * fillPx` across completed fills  |
| `avgFillPx`           | string         | Derived VWAP across filled size                    |
| `durationMs`          | number         | Total schedule duration in milliseconds            |
| `sliceIntervalMs`     | number         | Planned interval between suborders                 |
| `startedAt`           | number         | Schedule start timestamp                           |
| `expectedEndAt`       | number         | Planned completion timestamp                       |
| `currentSliceIndex`   | number         | Zero-based index for the latest processed suborder |
| `totalExpectedSlices` | number         | Planned number of suborders                        |
| `randomize`           | boolean        | Whether suborder timing is randomized              |
| `createdAt`           | number         | Initial creation timestamp                         |
| `updatedAt`           | number         | Last TWAP state update                             |
| `completedAt`         | number \| null | Completion timestamp for terminal completed states |
| `canceledAt`          | number \| null | Cancellation timestamp for canceled states         |
| `reason`              | string \| null | Optional terminal or error context                 |

## Notes

<Note>
  * This endpoint reads the active-TWAP user index and only returns non-terminal TWAPs. - The
    response shape matches the TWAP update payload used by the WebSocket API. - Spot TWAPs return the
    spot pair's display label in `asset`; child order history carries `twapOrderId` and
    `twapSliceIndex` for grouping. - `avgFillPx` is derived server-side from `totalNotional /
      filledSz`, or `"0"` when nothing has filled yet.
</Note>