Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "twapGetById"
user*stringUser wallet address
twapId*stringTWAP order id to fetch

​
Response

Returns the same TWAP object shape as TWAP List Active, or null if the TWAP is not found for that user. 
{
  "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

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

​
Notes

  • 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.