/2/perp/execute-v2 are asynchronous — the most common case is deposit on Lighter, which must observe the underlying bridge/settlement before the user’s margin is usable. When the execute-v2 response includes a processId, poll this endpoint until the process reports a terminal status.
Query Parameters
UUID returned by
/2/perp/execute-v2 in data.processId.Response
UUID of the tracked process.
Process status reported by the execution engine (e.g.,
pending, settled, failed). Terminal values depend on the action; clients should treat any non-pending value as final.Human-readable status message.
Error detail, present only when the process failed.
Errors
| Status | message |
|---|---|
| 404 | Process not found or tracking disabled — unknown processId, or the instance has process tracking disabled |