Skip to main content
POST

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-ez-mcp-client
string
required
x-signature
string
required

Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.

x-timestamp
string
required

Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.

Body

application/json

JSON body — OpenAPI schema McpCreateAgentBodyDto (also listed under Schemas). Pick an example below or compose from the schema; optional nested objects are personalization and **feeConfiguration**.

name
string
required

Display name (max 20 characters)

Maximum string length: 20
Example:

"My trading agent"

description
string
Example:

"Momentum strategies on Solana memecoins"

imageUrl
string
Example:

"avatars/my-agent.png"

tags
string[]
Example:
personalization
object
isPublic
boolean

true asks to list the agent: an approved agent is listed now; otherwise it stays private and goes to staff review (listingStatus pending-review). false makes it private (and cancels a pending review).

Example:

false

feeConfiguration
object
isDraft
boolean

When true, agent is saved as draft (not fully activated)

Example:

true

strategyDescription
string
marketplacePricingModel
enum<string>
Available options:
subscription,
success-fee,
both,
free
marketplaceMonthlyPrice
number
Required range: x >= 0
marketplaceSuccessFeePercent
number
default:20
Required range: 0 <= x <= 22
listingStatus
enum<string>

Staff only. A change is rejected (LISTING_STATUS_STAFF_ONLY); the current value is ignored. To list the agent send isPublic: true, which starts a staff review.

Available options:
pending-review,
beta,
public,
rejected,
shadow-monitoring
betaStartDate
string<date-time>

Ignored. The agent beta stage was removed.

maxBetaUsers
number
Required range: x >= 1
maxCohortEntryNotionalUsd
number | null

Creator ceiling on total entry notional for one signal, owner included. On Hyperliquid this is margin times leverage. Omit for no creator ceiling. Null clears it. Zero is rejected.

Required range: x > 0
riskLevel
enum<string>
Available options:
low,
medium,
high
performanceStats
object

Ignored. Performance numbers come from real trades only.

Ignored. Featured is set by EchoZero staff.

Ignored. Featured order is set by EchoZero staff.

inboundWebhookUrl
string
signalSourceKind
enum<string>
Available options:
webhook,
signal_group
connectedChannels
object[]
signalDetectionRule
object
signalExecutionDefaults
object

Agent trading defaults (whole object, replaces the stored value). Trade-card fields (tradeType, tradeMode, defaultTradeAllocationUsd, takeProfitLadder, timeStopMins) are validated on save.

parserAiMode
enum<string>

Per-agent hybrid parser: inherit (server env), off, shadow, or fallback.

Available options:
inherit,
off,
shadow,
fallback
membershipGated
boolean
gatedPlatform
enum<string>

Required when membershipGated is true. Telegram or Discord. Independent of connected channels.

Available options:
telegram,
discord
externalSignupUrl
string
agentVenue
enum<string>

Venue lock (Jupiter, Hyperliquid, or OneInch). Immutable after create. All Platforms is rejected until enabled.

Available options:
JUPITER,
HYPERLIQUID,
ONEINCH,
ALL_PLATFORMS
agentChain
enum<string>

Required only for OneInch agents (BASE or ARBITRUM).

Available options:
SOLANA,
CHILIZ,
FLOW,
ARBITRUM,
BASE,
HYPERLIQUID
maxConcurrentPositions
number
default:4

Max concurrent open positions. Default 4.

Required range: x >= 1
maxEntriesPerTrade
number
default:3

Max DCA entries per open trade. Default 3.

Required range: x >= 1
tradeVisibility
enum<string>

Who sees this agent's live trades, and when. New agents default to PUBLIC_IMMEDIATELY.

Available options:
PUBLIC_IMMEDIATELY,
SUBSCRIBERS_FIRST,
SUBSCRIBERS_ONLY
tradeRevealDelaySeconds
enum<number> | null

Seconds before non-subscribers see live trades (30, 60, 300, 900 or 3600). Only with SUBSCRIBERS_FIRST; null uses the 60s default.

Available options:
30,
60,
300,
900,
3600

Response

Created agent.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload