Skip to main content
GET
/
api
/
v1
/
activities
List trade activities
curl --request GET \
  --url https://mcp.echozero.app/api/v1/activities \
  --header 'x-api-key: <api-key>'
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  }
}

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

​
limit
number
default:20
​
offset
number
default:0
​
order
enum<string>
default:DESC
Available options:
ASC,
DESC
​
sortBy
enum<string>
default:TIMESTAMP
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
​
filterJson
string

JSON string of GraphQL TradeFilterInput

Response

PaginatedResponse: items = activities, pagination from total count.