> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notional.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Deposit Status

<div className="venue-tags" aria-label="Supported venues">
  <span className="venue-tag">Hyperliquid</span>
  <span className="venue-tag">Polymarket</span>
</div>

Returns the public status of a submitted multi-step deposit.

## Endpoint

```text theme={null}
POST /info
```

## Request Body

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

```json theme={null}
{
  "type": "protocolTransferStatus",
  "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
}
```

## Response

<Tabs sync={false}>
  <Tab title="200: Active">
    ```json theme={null}
    {
      "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "userAddress": "0x3333333333333333333333333333333333333333",
      "requestedAt": 1785254405000,
      "status": "active",
      "activeStep": 1,
      "steps": [
        {
          "status": "completed",
          "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
          "committedAt": 1785254406000,
          "completedAt": 1785254415000
        },
        {
          "status": "attempt_committed",
          "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
          "committedAt": 1785254416000
        }
      ]
    }
    ```
  </Tab>

  <Tab title="200: Completed">
    ```json theme={null}
    {
      "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "userAddress": "0x3333333333333333333333333333333333333333",
      "requestedAt": 1785254405000,
      "status": "completed",
      "steps": [
        {
          "status": "completed",
          "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
          "committedAt": 1785254406000,
          "completedAt": 1785254415000
        },
        {
          "status": "completed",
          "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
          "destinationTransactionHash": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "committedAt": 1785254416000,
          "completedAt": 1785254430000
        }
      ]
    }
    ```
  </Tab>

  <Tab title="200: Failed">
    ```json theme={null}
    {
      "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "userAddress": "0x3333333333333333333333333333333333333333",
      "requestedAt": 1785254405000,
      "status": "failed",
      "activeStep": 1,
      "steps": [
        {
          "status": "completed",
          "sourceTransactionHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "destinationTransactionHash": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
          "committedAt": 1785254406000,
          "completedAt": 1785254415000
        },
        {
          "status": "failed",
          "sourceTransactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
          "committedAt": 1785254416000
        }
      ]
    }
    ```
  </Tab>

  <Tab title="404: Not Found">
    ```json theme={null}
    {
      "error": "Protocol transfer not found",
      "code": "NOT_FOUND",
      "timestamp": 1785254400000
    }
    ```
  </Tab>
</Tabs>

## 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 timestamp fields appear only when known. `activeStep` is zero-based and is omitted when no
step is active. A missing transfer returns `404`.
