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

Returns all open short positions of the hopper, each with its effective take profit, stop-loss, trailing stop-loss, auto close and auto remove settings.

OAuth scope: read About scopes

Scalar values are returned as strings; amount, rate and val keep their full stored precision. config is the short's own settings as an object, or null. stop_loss_percentage is left out when stop-loss is off, and trailing_arm and trailing_arm_percentage when trailing stop-loss is off. Not available for exchange arbitrage, market maker, copy, grid and AI bots.

Example request

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

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Path parameters

NameTypeRequiredDescription
id string Required Hopper ID.

Response

Example response (illustrative values)

{
    "data": [
        {
            "id": "223344",
            "exchange": "binance",
            "pair": "ETHUSDT",
            "currency": "ETH",
            "amount": "0.2500000000000000",
            "rate": "3120.4500000000000000",
            "val": "780.1125000000000000",
            "config": null,
            "btc": "0.0000000000000000",
            "start_profit": "0.0000000000000000",
            "start_rate": "3080.0000000000000000",
            "buy_trigger": null,
            "sell_trigger": "strategy",
            "percentage_profit": "2",
            "stop_loss": "0",
            "sell_rate": null,
            "trailing_percentage": "0.0000000000000000",
            "sell_time": "1758790000",
            "auto_close_time": "0",
            "auto_remove_time": "0",
            "hold": "0",
            "cost": "780.1125",
            "trailing_stop_loss_enabled": "0",
            "trailing_stop_loss_only": "0",
            "stop_loss_enabled": "0",
            "auto_close_enabled": "0",
            "auto_remove_enabled": "0"
        }
    ]
}

Status codes: 200. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.