curl --request PATCH \
--url https://mcp.echozero.app/api/v1/users/me/activations/{strategyId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"executionMode": "ALERTS_ONLY",
"allocationMode": "PERCENTAGE_RANGE"
}
'{
"success": true,
"data": {
"success": true,
"message": "<string>",
"activation": {
"agentId": "<string>",
"tradingBotId": "<string>",
"executionMode": "AUTO_TRADING",
"activatedAt": "2023-11-07T05:31:56Z",
"allocationMode": "PERCENTAGE_RANGE",
"allocationPercentageMin": 123,
"allocationPercentageMax": 123,
"allocationAmountUsd": 123,
"allocationAmountSol": 123,
"allocationAmount": 123,
"allocationPercentage": 123,
"isPaused": true,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"balance": {
"balanceSol": 123,
"balanceUsd": 123,
"hasInsufficientBalance": true
}
}
}Update an active bot (mode / allocation)
:strategyId is the trading bot id. closeAllTrades: true only closes positions when executionMode is ALERTS_ONLY; ignored otherwise.
curl --request PATCH \
--url https://mcp.echozero.app/api/v1/users/me/activations/{strategyId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"executionMode": "ALERTS_ONLY",
"allocationMode": "PERCENTAGE_RANGE"
}
'{
"success": true,
"data": {
"success": true,
"message": "<string>",
"activation": {
"agentId": "<string>",
"tradingBotId": "<string>",
"executionMode": "AUTO_TRADING",
"activatedAt": "2023-11-07T05:31:56Z",
"allocationMode": "PERCENTAGE_RANGE",
"allocationPercentageMin": 123,
"allocationPercentageMax": 123,
"allocationAmountUsd": 123,
"allocationAmountSol": 123,
"allocationAmount": 123,
"allocationPercentage": 123,
"isPaused": true,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"balance": {
"balanceSol": 123,
"balanceUsd": 123,
"hasInsufficientBalance": true
}
}
}Authorizations
User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.
Headers
Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.
Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.
Path Parameters
Body
AUTO_TRADING, ALERTS_ONLY, TEST_TRADING, FULL_TRADING PERCENTAGE_RANGE, USD_AMOUNT, SOL_AMOUNT When true and executionMode is ALERTS_ONLY, close all open trades for this agent in the current wallet context. Ignored for any other mode. Same keep-open semantics as PATCH subscription closeAllTrades on FULL → ALERTS.