Skip to main content
GET
/
api
/
v1
/
trades
List trades
curl --request GET \
  --url https://mcp.echozero.app/api/v1/trades \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "agentName": "<string>"
      }
    ],
    "pagination": {
      "total": 123,
      "limit": 123,
      "page": 123,
      "totalPages": 123,
      "hasNextPage": true,
      "hasPreviousPage": true
    }
  }
}

Authorizations

x-api-key
string
header
required

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.

Query Parameters

tradingBotId
string

Trading bot id filter

agentId
string

Agent id: returns trades from all trading bots under this agent

orderBy
enum<string>
Available options:
TIMESTAMP,
AMOUNT,
FEE,
SLOT,
CREATED_AT,
UPDATED_AT,
STATUS,
TYPE,
CHAIN,
PROFIT_AMOUNT,
PROFIT_PERCENTAGE,
POSITION_VALUE,
FIRST_OPENED,
FIRST_CLOSED,
RUNTIME,
PNL,
PNL_PERCENTAGE,
TRADE_STATE,
TIME,
TOKEN_SYMBOL,
TOKEN_NAME,
BOT_NAME,
SIGNATURE,
WALLET_ADDRESS,
IS_BOT_TRADE,
IS_VIRTUAL,
TRADING_BOT_ID,
TRADE_ID,
TOKEN_MINT
order
enum<string>
Available options:
ASC,
DESC
limit
object
offset
object
filter
object

Response

Paginated trades.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload