curl --request POST \
--url https://mcp.echozero.app/api/v1/users/me/activations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"agentId": "507f1f77bcf86cd799439011",
"tradingBotId": "507f1f77bcf86cd799439012",
"executionMode": "FULL_TRADING",
"allocationMode": "USD_AMOUNT"
}
'{
"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
}
}
}User
Activate a trading bot under a subscribed agent
POST
/
api
/
v1
/
users
/
me
/
activations
curl --request POST \
--url https://mcp.echozero.app/api/v1/users/me/activations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"agentId": "507f1f77bcf86cd799439011",
"tradingBotId": "507f1f77bcf86cd799439012",
"executionMode": "FULL_TRADING",
"allocationMode": "USD_AMOUNT"
}
'{
"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
bearer-jwtapi-key
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.
Body
application/json
Subscribed internal agent id
Trading bot (strategy) id to activate
Available options:
AUTO_TRADING, ALERTS_ONLY, TEST_TRADING, FULL_TRADING Available options:
PERCENTAGE_RANGE, USD_AMOUNT, SOL_AMOUNT