DÉVELOPPEURS
POST
https://api.cryptohopper.com/v1/hopper/{id}/position/setshortsetting
Changes one or more settings on the given short positions: take profit, auto close time, auto remove time, stop-loss on or off, stop-loss percentage, trailing stop-loss on or off, trailing arm percentage and trailing percentage.
OAuth scope:
read manage About scopes
position_ids are short position IDs. setting must be an object of setting names and values. Allowed names: take_profit, auto_close_time and auto_remove_time (Unix timestamp in seconds in the future, or 0 to turn off), stop_loss_enabled, stop_loss_percentage, trailing_enabled, trailing_arm_percentage, trailing_percentage. data is a list with one message per setting. Not available for exchange arbitrage, market maker, copy, grid and AI bots.
Example request
curl -X POST "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/setshortsetting" \
-H "access-token: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"position_ids":[223344],"setting":{"take_profit":2.5,"auto_close_time":1759000000}}'const response = await fetch('https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/setshortsetting', {
method: 'POST',
headers: {
"access-token": "YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"position_ids": [
223344
],
"setting": {
"take_profit": 2.5,
"auto_close_time": 1759000000
}
})
});
const data = await response.json();import requests
response = requests.post(
"https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/setshortsetting",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
json={
"position_ids": [
223344
],
"setting": {
"take_profit": 2.5,
"auto_close_time": 1759000000
}
},
)
data = response.json()$ch = curl_init('https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/setshortsetting');
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([
'position_ids' => [
223344,
],
'setting' => [
'take_profit' => 2.5,
'auto_close_time' => 1759000000,
],
]),
]);
$data = json_decode(curl_exec($ch), true);Parameters
Headers
| Name | Type | Required | Description |
|---|---|---|---|
access-token |
string | Optional | The OAuth access token of the user. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | Required | Hopper ID. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
position_ids | array of integer | Optional | |
setting | object | Optional | |
take_profit | number | Optional | Minimum 0. |
auto_close_time | number | Optional | Minimum 0. |
auto_remove_time | number | Optional | Minimum 0. |
stop_loss_percentage | number | Optional | Minimum 0. |
stop_loss_enabled | integer | Optional | |
trailing_enabled | integer | Optional | |
trailing_arm_percentage | number | Optional | Minimum 0. |
trailing_percentage | number | Optional | Minimum 0. |
Response
{
"data": [
"Position percentage profit has been set.",
"Auto close time has been set for position(s)."
]
}