# Get reserved positions

`GET https://api.cryptohopper.com/v1/hopper/{id}/reserved`

Part of [Positions](https://www.cryptohopper.com/api-documentation/api-reference/positions.md) in the Cryptohopper API reference.

Returns the reserved positions of the hopper: coin amounts moved out of the open positions and set aside.

OAuth scope: `read`

base is the pair without the coin, so the quote currency. Numbers keep their full stored precision. Not available for exchange arbitrage, market maker, copy and grid bots.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Hopper ID. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/reserved" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "55501",
            "exchange": "binance",
            "pair": "ETHUSDT",
            "amount": "0.2500000000000000",
            "rate": "3120.4500000000000000",
            "val": "780.1125000000000000",
            "btc": "0.0000000000000000",
            "buy_time": "1758790000",
            "currency": "ETH",
            "base": "USDT"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.