Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "twapListActive"
user*stringUser wallet address

​
Response

[
  {
    "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

FieldTypeDescription
twapIdstringTWAP order id
statusstringCurrent TWAP status
assetstringVenue asset symbol
sidestring"buy" or "sell"
totalSzstringTotal requested size
filledSzstringAggregate filled size
remainingSzstringRemaining size
reduceOnlybooleanWhether execution is reduce-only
slicesFillednumberCount of fully filled slices
slicesPartialnumberCount of partially filled slices
slicesRejectednumberCount of rejected or skipped slices
totalNotionalstringSum of filledSz * fillPx across completed fills
avgFillPxstringDerived VWAP across filled size
durationMsnumberTotal schedule duration in milliseconds
sliceIntervalMsnumberPlanned interval between slices
startedAtnumberSchedule start timestamp
expectedEndAtnumberPlanned completion timestamp
currentSliceIndexnumberZero-based index for the latest processed slice
totalExpectedSlicesnumberPlanned number of slices
randomizebooleanWhether slice timing is randomized
createdAtnumberInitial creation timestamp
updatedAtnumberLast TWAP state update
completedAtnumber | nullCompletion timestamp for terminal completed states
canceledAtnumber | nullCancellation timestamp for canceled states
reasonstring | nullOptional terminal or error context

​
Notes

  • 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. - avgFillPx is derived server-side from totalNotional / filledSz, or "0" when nothing has filled yet.