Skip to main content
POST
/
api
/
v1
/
developers
/
agents
/
{id}
/
signal-corpus
/
analyze
Analyze pasted signal samples for an owned agent
curl --request POST \
  --url https://mcp.echozero.app/api/v1/developers/agents/{id}/signal-corpus/analyze \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "samplesText": "<string>"
}
'
{
  "success": true,
  "data": {
    "analysisId": "<string>",
    "messageCount": 123,
    "rawLineCount": 123,
    "summary": "<string>",
    "suggestedRule": {
      "buyKeywords": [
        "<string>"
      ],
      "sellKeywords": [
        "<string>"
      ],
      "longKeywords": [
        "<string>"
      ],
      "shortKeywords": [
        "<string>"
      ],
      "tpKeywords": [
        "<string>"
      ],
      "slKeywords": [
        "<string>"
      ],
      "leverageKeywords": [
        "<string>"
      ],
      "tokenPatterns": [
        "<string>"
      ],
      "strategyPrefix": "<string>",
      "cancelKeywords": [
        "<string>"
      ],
      "breakevenKeywords": [
        "<string>"
      ],
      "partialCloseKeywords": [
        "<string>"
      ],
      "breakoutAboveKeywords": [
        "<string>"
      ],
      "breakoutBelowKeywords": [
        "<string>"
      ],
      "entryZoneKeywords": [
        "<string>"
      ]
    },
    "coverage": {
      "keywordGateHitPct": 123,
      "unmatchedLineIndexes": [
        123
      ]
    },
    "riskFlags": [
      {
        "keyword": "<string>",
        "reason": "<string>"
      }
    ],
    "parsePreview": [
      {
        "lineIndex": 123,
        "text": "<string>",
        "ingressHit": true,
        "matched": true,
        "token": "<string>",
        "intent": "<string>",
        "summary": "<string>"
      }
    ],
    "keywordStats": {},
    "corpusMessages": [
      {
        "lineIndex": 123,
        "text": "<string>"
      }
    ],
    "diff": [
      {
        "bucket": "<string>",
        "added": [
          "<string>"
        ],
        "unchanged": [
          "<string>"
        ]
      }
    ],
    "warnings": [
      "<string>"
    ],
    "strategyPrefixRecommendation": {
      "value": "<string>",
      "apply": true,
      "reason": "<string>"
    },
    "expiresAt": "<string>",
    "model": "<string>"
  }
}

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.

Path Parameters

​
id
string
required

Body

application/json
​
samplesText
string
required

Raw pasted channel messages (newline or blank-line separated).

​
messageDelimiter
enum<string>

telegram_export / discord_export merge desktop copy-selected paste; omit to auto-detect.

Available options:
newline,
blankline,
telegram_export,
discord_export
​
existingRule
object

Current rule on the form — used for diff context only in v1.

Response

Suggested detection rule + coverage stats.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload