> ## 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 Get By ID

## Endpoint

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

## Request Body

| Parameter  | Type   | Description             |
| ---------- | ------ | ----------------------- |
| `type`\*   | string | Must be `"twapGetById"` |
| `user`\*   | string | User wallet address     |
| `twapId`\* | string | TWAP order id to fetch  |

## Response

Returns the same TWAP object shape as [TWAP List Active](/api-reference/info-endpoints/twap-list-active), or `null` if the TWAP is not found for that user.

```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
}
```

## Example Request

```bash theme={null}
curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "twapGetById",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "twapId": "0x1a2b3c4d5e6f7890..."
  }'
```

## Notes

<Note>
  * Lookup is scoped to the provided user, so requesting another user’s TWAP id returns `null`. -
    This endpoint returns active and terminal TWAPs alike when they exist for that user.
</Note>