# Open short positions

`POST https://api.cryptohopper.com/v1/hopper/{id}/position/short`

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

Opens short positions from the given open positions by placing sell orders at the current bid, or at market.

OAuth scope: `read`, `manage`, `trade`

market_order 1 places market orders. Positions that already have an open order, or whose coin balance is below the minimum trade amount, are skipped; if only some positions could be shorted, data says so. Not available for exchange arbitrage, market maker, copy, grid and AI 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 -X POST "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/short" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"position_ids":[123456,123457],"market_order":0}'
```

## Response

Example response (illustrative values):

```json
{
    "data": "Sell orders placed for selected positions."
}
```

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.