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
assetstringPerp market symbol or spot pair base symbol
sidestring"buy" or "sell"
totalSzstringTotal requested size
filledSzstringAggregate filled size
remainingSzstringRemaining size
reduceOnlybooleanWhether execution is reduce-only
slicesFillednumberCount of fully filled suborders
slicesPartialnumberCount of partially filled suborders
slicesRejectednumberCount of rejected or skipped suborders
totalNotionalstringSum of filledSz * fillPx across completed fills
avgFillPxstringDerived VWAP across filled size
durationMsnumberTotal schedule duration in milliseconds
sliceIntervalMsnumberPlanned interval between suborders
startedAtnumberSchedule start timestamp
expectedEndAtnumberPlanned completion timestamp
currentSliceIndexnumberZero-based index for the latest processed suborder
totalExpectedSlicesnumberPlanned number of suborders
randomizebooleanWhether suborder 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. - 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.