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

# GET /v2/trade/perps/deposits: Deposits

> The user's Polymarket Perps deposits, or one deposit by deposit_id. Scope perps.read.

> [!NOTE]
>
> Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md).

Two reads: every deposit of the user, or one deposit by the `deposit_id` that [`POST /v2/trade/perps/deposits`](https://docs.bravadotrade.com/api/trade/perps/deposit) answered. Scope `perps.read`.

Deposit states update about once a minute, so polling faster returns the same object.

## List deposits

```text theme={null}
GET https://partner-api.bravadotrade.com/v2/trade/perps/deposits
```

### Query Parameters

**cursor** `string`

Opaque. Pass back the previous page's `next_cursor`.

### Response

The user's deposits. When there are more, pass the page's `next_cursor` back as `cursor`.

After a `504` on a deposit, list deposits before acting again: the request may have acted.

## Get one deposit

```text theme={null}
GET https://partner-api.bravadotrade.com/v2/trade/perps/deposits/{deposit_id}
```

### Path Parameters

**deposit\_id** `string` *required*

The `deposit_id` the `POST` answered, a UUID.

### Response

The deposit, with its `state`. Poll until `state` is `credited`. States are `prepared`, `pending` (sent, not yet confirmed and credited), `confirmed` (on chain, not yet credited by the venue), `credited`, `failed`, `reverted` and `not_found`.

### Errors

| Status | When |
| - | - |
| `404 Not Found` | `NOT_FOUND`: unknown id, or one that belongs to another user |

### Example

```bash cURL theme={null}
curl https://partner-api.bravadotrade.com/v2/trade/perps/deposits/3f2a9c1e-5b7d-4e8f-9a0b-1c2d3e4f5a6b \
  -H "X-BRAVADO-API-KEY: $BRAVADO_API_KEY" \
  -H "X-BRAVADO-TIMESTAMP: <unix-ms>" \
  -H "X-BRAVADO-SIGNATURE: <signature-for-this-request>"
```

## Related

* [`POST /v2/trade/perps/deposits`](https://docs.bravadotrade.com/api/trade/perps/deposit) to make a deposit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.