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

Returns one hopper with its subscription, status, exchange, base currency, open position count and start balance.

OAuth scope: read About scopes

last_loaded_config is a boolean that tells whether the hopper has a loaded config name, not the name itself.

Example request

curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID" \
  -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": {
        "hopper": {
            "id": "123456",
            "name": "My BTC bot",
            "hopper_id": "123456",
            "subscription_id": "456789",
            "plan_id": "2",
            "payment_term": "month",
            "payment_method_id": "1",
            "start_time": "2026-09-01 10:00:00",
            "end_time": "2026-10-01 10:00:00",
            "subscription_status": "Active",
            "auto_renewal": "Yes",
            "subscription": "Adventure",
            "plan_name": "Adventure",
            "plan_description": "Adventure plan",
            "product_id": "None",
            "open_positions_count": "3",
            "bot_type": "0",
            "last_loaded_config": true,
            "exchange": "binance",
            "image": "https://cdn.cryptohopper.com/images/hoppers/binance-usdt.jpg",
            "base_currency": "USDT",
            "buying_enabled": 1,
            "selling_enabled": 1,
            "enabled": 1,
            "set_default": "1",
            "error_message": null,
            "last_signal": "",
            "allowed_coins": [
                "BTC",
                "ETH"
            ],
            "last_signal_encoding": "ASCII",
            "config_error": "0",
            "created": "2025-03-14 09:21:07",
            "total_cur": "1523.45000000",
            "user_id": "654321",
            "paper_trading": 0,
            "copy_manager": 0,
            "start_balance": "1000.00000000"
        }
    }
}

Status codes: 200, 400, 401, 403, 404, 429, 500, 501. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.