Subscribe to signal | POST /hopper/{id}/signal/{signal_id}

POST https://api.cryptohopper.com/v1/hopper/{id}/signal/{signal_id}

Subscribes the hopper to a signaller. For a paid signaller without an active subscription, an invoice is created and the signals start once it is paid.

OAuth scope: read manage About scopes

The body is optional. With free_only set to true, a paid signaller you have no active subscription for is refused with status 402 instead of creating an invoice. A hopper with copy trading enabled can only subscribe to signallers linked to your own signaller account. Not available for arbitrage, market maker, copy trading, grid and AI bots.

Example request

curl -X POST "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/signal/SIGNAL_ID" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"free_only":true}'

const response = await fetch('https://api.cryptohopper.com/v1/hopper/HOPPER_ID/signal/SIGNAL_ID', {
  method: 'POST',
  headers: {
      "access-token": "YOUR_ACCESS_TOKEN",
      "Content-Type": "application/json"
  },
  body: JSON.stringify({
      "free_only": true
  })
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/signal/SIGNAL_ID",
    headers={
        "access-token": "YOUR_ACCESS_TOKEN"
    },
    json={
        "free_only": True
    },
)
data = response.json()

$ch = curl_init('https://api.cryptohopper.com/v1/hopper/HOPPER_ID/signal/SIGNAL_ID');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'access-token: YOUR_ACCESS_TOKEN',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'free_only' => true,
    ]),
]);
$data = json_decode(curl_exec($ch), true);

Parameters

Headers

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

Path parameters

Name	Type	Required	Description
`signal_id`	string	Required	Signaller ID.
`id`	string	Required	Hopper ID.

Response

Example response (illustrative values)

{
    "data": "Hopper is now subscribed to the signals of Example Signals."
}

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