Transfer Status

HyperliquidPolymarket

Returns the public status of a submitted multi-step transfer in either direction.

Endpoint

POST /info

Request Body

Parameter	Type	Description
`type`*	string	Must be `"protocolTransferStatus"`
`transferId`*	string	Lowercase `0x`-prefixed 32-byte hash, e.g., `"0xbbbbbb...bbbb"`

{
  "type": "protocolTransferStatus",
  "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
}

Response

200: Active
200: Completed
200: Failed
404: Not Found

{
  "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "userAddress": "0x3333333333333333333333333333333333333333",
  "status": "active",
  "steps": [
    {
      "status": "completed",
      "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
      "completedAt": 1785254415000
    },
    {
      "status": "attempt_committed",
      "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
    }
  ]
}

{
  "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "userAddress": "0x3333333333333333333333333333333333333333",
  "status": "completed",
  "steps": [
    {
      "status": "completed",
      "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
      "completedAt": 1785254415000
    },
    {
      "status": "completed",
      "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
      "destinationTransactionHash": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "completedAt": 1785254430000
    }
  ]
}

{
  "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "userAddress": "0x3333333333333333333333333333333333333333",
  "status": "failed",
  "steps": [
    {
      "status": "completed",
      "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
      "completedAt": 1785254415000
    },
    {
      "status": "failed",
      "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
    }
  ]
}

{
  "error": "Protocol transfer not found",
  "code": "NOT_FOUND",
  "timestamp": 1785254400000
}

Transfer Statuses

Status	Meaning
`pending`	Accepted but no step has started
`active`	At least one route step is running
`needs_reconciliation`	The server is still determining a result; keep checking
`completed`	Every step reached the required destination confirmation
`failed`	The transfer failed and will not continue

Step Statuses

Status	Meaning
`pending`	The step has not started
`attempt_committed`	The execution attempt was recorded
`completed`	The step reached its completion condition
`failed`	The step failed
`uncertain`	The result has not been confirmed

Hash and completion timestamp fields appear only when known. A source hash can appear before completion; use the transfer and step statuses to determine whether execution has finished. userAddress, transaction hashes, completedAt, and the optional V2 schemaVersion: 2 remain available for operation identity checks and operational evidence. The signed quote is unchanged. Waiting V2 phases project to step status: "pending"; needs_reconciliation projects to status: "uncertain". An uncertain step must not be interpreted as permission to resubmit.

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

Response

Transfer Statuses

Step Statuses

​Endpoint

​Request Body

​Response

​Transfer Statuses

​Step Statuses

Endpoint

Request Body

Response

Transfer Statuses

Step Statuses