Skip to main content
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' \
  --data '
{
  "agentId": "507f1f77bcf86cd799439011",
  "tradingBotId": "507f1f77bcf86cd799439012",
  "executionMode": "AUTO_TRADING",
  "allocationMode": "USD_AMOUNT"
}
'
{
  "success": true,
  "data": {
    "success": true,
    "message": "<string>",
    "activation": {
      "agentId": "<string>",
      "tradingBotId": "<string>",
      "activatedAt": "2023-11-07T05:31:56Z",
      "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

​
Authorization
string
header
required

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

​
x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Optional -- when omitted, HMAC verification is skipped.

​
x-timestamp
string

Request timestamp in epoch milliseconds. Required when x-signature is provided. Rejected if drift exceeds 5 minutes.

Body

application/json
​
agentId
string
required

Subscribed internal agent id

​
tradingBotId
string
required

Trading bot (strategy) id to activate

​
executionMode
enum<string>
required
Available options:
AUTO_TRADING,
ALERTS_ONLY,
TEST_TRADING,
FULL_TRADING
​
allocationMode
enum<string>
required
Available options:
PERCENTAGE_RANGE,
USD_AMOUNT,
SOL_AMOUNT
​
allocationPercentageMin
number
​
allocationPercentageMax
number
​
allocationAmountUsd
number
​
allocationAmountSol
number
​
allocationAmount
number
​
allocationPercentage
number

Response

200 - application/json

Activation result.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload