Skip to main content
GET
/
api
/
v1
/
developers
/
agents
/
{id}
/
trades
Agent-scoped signal-trades for the dev-portal Trades tab
curl --request GET \
  --url https://mcp.echozero.app/api/v1/developers/agents/{id}/trades \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "signalId": "<string>",
        "action": "<string>",
        "tokenAddress": "<string>",
        "amount": 123,
        "subscriberCount": 123,
        "livePriceSeeded": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "performanceOpen": true,
        "tokenName": "<string>",
        "tokenSymbol": "<string>",
        "status": "<string>",
        "leverage": 123,
        "failureReason": "<string>",
        "failureReasons": [
          {
            "code": "<string>",
            "raw": "<string>",
            "category": "<string>",
            "title": "<string>",
            "message": "<string>",
            "remediation": "<string>"
          }
        ],
        "diagnosticReasons": [
          {
            "code": "<string>",
            "raw": "<string>",
            "category": "<string>",
            "title": "<string>",
            "message": "<string>",
            "remediation": "<string>"
          }
        ],
        "entryPriceUsd": 123,
        "stopLossPriceUsd": 123,
        "takeProfitPriceUsd": 123,
        "currentPriceUsd": 123,
        "unrealizedPnlPercent": 123,
        "realizedPnlPercent": 123,
        "closeReason": "<string>",
        "closedAt": "2023-11-07T05:31:56Z",
        "firstTxHash": "<string>"
      }
    ],
    "pagination": {
      "total": 123,
      "limit": 123,
      "page": 123,
      "totalPages": 123,
      "hasNextPage": true,
      "hasPreviousPage": 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.

Path Parameters

​
id
string
required

Response

Signal-trade rows for the Trades tab.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload