# Echo Zero

## Docs

- [List trade activities](https://docs.echozero.app/api-reference/activity/list-trade-activities.md): Mirrors GraphQL `activities`. Optional `filterJson` encodes GraphQL `TradeFilterInput`. Response maps to `PaginatedResponse` (`items` + `pagination`).
- [Search bots you have activity with](https://docs.echozero.app/api-reference/activity/search-bots-you-have-activity-with.md): Mirrors GraphQL `searchActivityTradingBots`.
- [Search tokens you have activity with](https://docs.echozero.app/api-reference/activity/search-tokens-you-have-activity-with.md): Mirrors GraphQL `searchActivityTokens`.
- [Confirm destructive admin action](https://docs.echozero.app/api-reference/admin-operations/confirm-destructive-admin-action.md)
- [Create notification segment](https://docs.echozero.app/api-reference/admin-operations/create-notification-segment.md)
- [Find users by id, email, wallet, or cohort filter](https://docs.echozero.app/api-reference/admin-operations/find-users-by-id-email-wallet-or-cohort-filter.md)
- [Force password reset for a user](https://docs.echozero.app/api-reference/admin-operations/force-password-reset-for-a-user.md)
- [Get error dashboard](https://docs.echozero.app/api-reference/admin-operations/get-error-dashboard.md)
- [Get full admin user details](https://docs.echozero.app/api-reference/admin-operations/get-full-admin-user-details.md)
- [Get platform health metrics](https://docs.echozero.app/api-reference/admin-operations/get-platform-health-metrics.md)
- [Get revenue summary by period and source](https://docs.echozero.app/api-reference/admin-operations/get-revenue-summary-by-period-and-source.md)
- [Override KYC tier or verified state](https://docs.echozero.app/api-reference/admin-operations/override-kyc-tier-or-verified-state.md)
- [Propose destructive admin action](https://docs.echozero.app/api-reference/admin-operations/propose-destructive-admin-action.md): Returns dry-run details and a short-lived confirmation token. Call confirm with a reason to execute.
- [Query admin action audit log](https://docs.echozero.app/api-reference/admin-operations/query-admin-action-audit-log.md)
- [Relist a previously flagged public agent](https://docs.echozero.app/api-reference/admin-operations/relist-a-previously-flagged-public-agent.md)
- [Second-admin approval for sensitive action](https://docs.echozero.app/api-reference/admin-operations/second-admin-approval-for-sensitive-action.md)
- [Temporarily delist a public agent](https://docs.echozero.app/api-reference/admin-operations/temporarily-delist-a-public-agent.md)
- [Approve developer agent for beta](https://docs.echozero.app/api-reference/admin/approve-developer-agent-for-beta.md): Transitions agent from pending-review to beta. Creates a review record.
- [List developer agents across all users](https://docs.echozero.app/api-reference/admin/list-developer-agents-across-all-users.md): Returns paginated developer agents across all developers. Supports admin-only filtering by beta status, developer key id, user id, developer name, and agent name.
- [List developer agents pending review](https://docs.echozero.app/api-reference/admin/list-developer-agents-pending-review.md): Returns paginated list of agents with betaStatus "pending-review". Admin only.
- [Promote developer agent from beta to public](https://docs.echozero.app/api-reference/admin/promote-developer-agent-from-beta-to-public.md): Transitions agent from beta to public.
- [Reject developer agent](https://docs.echozero.app/api-reference/admin/reject-developer-agent.md): Transitions agent from pending-review to rejected. Requires rejection notes.
- [Create agent](https://docs.echozero.app/api-reference/agent/create-agent.md): Mirrors GraphQL `createAgent`.
- [Delete agent](https://docs.echozero.app/api-reference/agent/delete-agent.md): Mirrors GraphQL `deleteAgent`.
- [Discord bot-install OAuth callback (browser redirect)](https://docs.echozero.app/api-reference/agent/discord-bot-install-oauth-callback-browser-redirect.md): Validates signed `state`, then redirects to the developer portal with `agentId` and optional `discordGuildId`.
- [Discord bot-install OAuth URL (signed state)](https://docs.echozero.app/api-reference/agent/discord-bot-install-oauth-url-signed-state.md): Returns an invite URL with `state` bound to this agent and developer. Redirect URI is `{MCP_ENDPOINT}/api/v1/agents/discord/oauth/callback`.
- [Discord signal bot metadata (signal-group setup)](https://docs.echozero.app/api-reference/agent/discord-signal-bot-metadata-signal-group-setup.md): Returns application id, bot invite URL, and optional bot username. Requires developer registration.
- [Duplicate agent](https://docs.echozero.app/api-reference/agent/duplicate-agent.md): Mirrors GraphQL `duplicateAgent`: creates a private copy with the same marketplace configuration; separate lifecycle (new strategies only).
- [Explore agents](https://docs.echozero.app/api-reference/agent/explore-agents.md): Mirrors GraphQL `exploreAgents` / `getExploreAgents`.
- [Get agent by id](https://docs.echozero.app/api-reference/agent/get-agent-by-id.md): Mirrors GraphQL `agent` / `getAgent`.
- [Get latest feed persona](https://docs.echozero.app/api-reference/agent/get-latest-feed-persona.md): Returns the latest published persona version for LLM-authored activity feed posts. Agent owner only.
- [List feed persona versions](https://docs.echozero.app/api-reference/agent/list-feed-persona-versions.md): Returns version numbers and timestamps for all published persona versions. Agent owner only.
- [My agents](https://docs.echozero.app/api-reference/agent/my-agents.md): Mirrors GraphQL `myAgents` / `getMyAgents`.
- [Onboarding agents](https://docs.echozero.app/api-reference/agent/onboarding-agents.md): Mirrors GraphQL `onboardingAgents` / `getOnboardingAgents`.
- [Onboarding themes](https://docs.echozero.app/api-reference/agent/onboarding-themes.md): Mirrors GraphQL `onboardingThemes` (BotInterest enum values).
- [Pin agent](https://docs.echozero.app/api-reference/agent/pin-agent.md): Mirrors `pinAgent`.
- [Pinned agents](https://docs.echozero.app/api-reference/agent/pinned-agents.md): Mirrors GraphQL `pinnedAgents` / `getPinnedAgents`.
- [Preview feed posts from draft persona](https://docs.echozero.app/api-reference/agent/preview-feed-posts-from-draft-persona.md): Runs feed post-writer prompts for each update type using your persona text (or optional custom scenarios JSON). Ephemeral — nothing is saved to the activity feed. Rate-limited per agent.
- [Publish new feed persona version](https://docs.echozero.app/api-reference/agent/publish-new-feed-persona-version.md): Creates a new append-only persona version. Publish gate: `persona` and `examples` must be non-empty. Agent owner only.
- [Rollback feed persona](https://docs.echozero.app/api-reference/agent/rollback-feed-persona.md): Creates a new version with the content of an older version (append-only rollback). Agent owner only.
- [Set agent subscription price](https://docs.echozero.app/api-reference/agent/set-agent-subscription-price.md): Creates or updates the Stripe Product + Price for paid marketplace access. Requires Stripe Connect `active` when `monthlyPriceUsd` > 0.
- [Telegram signal bot username (signal-group setup)](https://docs.echozero.app/api-reference/agent/telegram-signal-bot-username-signal-group-setup.md): Returns the Echo Zero bot @username to add as a Telegram channel administrator. Requires developer registration.
- [Unpin agent](https://docs.echozero.app/api-reference/agent/unpin-agent.md): Mirrors `unpinAgent`.
- [Update agent](https://docs.echozero.app/api-reference/agent/update-agent.md): Mirrors GraphQL `updateAgent` (`agentId` from path).
- [Upload agent avatar from base64 image data](https://docs.echozero.app/api-reference/agent/upload-agent-avatar-from-base64-image-data.md): Uploads an agent profile image using the existing storage provider and updates the owned Agent.imageUrl field. Accepts raw base64 with mimeType or a data URL.
- [Verify Discord signal channel (bot access)](https://docs.echozero.app/api-reference/agent/verify-discord-signal-channel-bot-access.md): Resolves the channel via Discord API, checks the Echo Zero bot can read messages, and persists `connectedChannels` + `signalSourceKind` on the agent.
- [Verify Telegram signal channel (bot membership)](https://docs.echozero.app/api-reference/agent/verify-telegram-signal-channel-bot-membership.md): Resolves the channel via Telegram Bot API, checks the Echo Zero bot is present with read access, and persists `connectedChannels` + `signalSourceKind` on the agent.
- [Agent chat history](https://docs.echozero.app/api-reference/ai/agent-chat-history.md): Mirrors GraphQL `agentChatHistory`. `agentId` is set from the path.
- [Agents you have chatted with](https://docs.echozero.app/api-reference/ai/agents-you-have-chatted-with.md): Mirrors GraphQL `myAgentChats`.
- [Chat with a specific internal agent](https://docs.echozero.app/api-reference/ai/chat-with-a-specific-internal-agent.md): Mirrors GraphQL `agentChat`. `agentId` is taken from the path; body is `message` and optional `conversationId`.
- [Confirm agent trade](https://docs.echozero.app/api-reference/ai/confirm-agent-trade.md): Mirrors GraphQL `confirmAgentTrade`.
- [Decline agent trade](https://docs.echozero.app/api-reference/ai/decline-agent-trade.md): Mirrors GraphQL `declineAgentTrade`.
- [Delete agent chat history](https://docs.echozero.app/api-reference/ai/delete-agent-chat-history.md): Mirrors GraphQL `deleteAgentChatHistory`.
- [Delete support chat](https://docs.echozero.app/api-reference/ai/delete-support-chat.md): Mirrors GraphQL `deleteSupportChat`.
- [Execute a structured agent action](https://docs.echozero.app/api-reference/ai/execute-a-structured-agent-action.md): Mirrors GraphQL `executeAgentAction`.
- [Generate strategy idea (AI draft)](https://docs.echozero.app/api-reference/ai/generate-strategy-idea-ai-draft.md): Mirrors GraphQL `generateBotStrategy` — returns a draft config, not a persisted Strategy entity.
- [Global AI chat](https://docs.echozero.app/api-reference/ai/global-ai-chat.md): Mirrors GraphQL `aiChat`.
- [List agent chat histories](https://docs.echozero.app/api-reference/ai/list-agent-chat-histories.md): Mirrors GraphQL `listAgentChatHistories`.
- [List support chats](https://docs.echozero.app/api-reference/ai/list-support-chats.md): Mirrors GraphQL `listSupportChats` (same filter shape as agent histories).
- [Refresh trade quote](https://docs.echozero.app/api-reference/ai/refresh-trade-quote.md): Mirrors GraphQL `refreshTradeQuote`.
- [Save AI draft as trading bot](https://docs.echozero.app/api-reference/ai/save-ai-draft-as-trading-bot.md): Mirrors GraphQL `saveStrategyAsBot` — persists a `CreateTradingBotInput` configuration.
- [Support AI chat](https://docs.echozero.app/api-reference/ai/support-ai-chat.md): Mirrors GraphQL `supportChat`.
- [Support chat detail](https://docs.echozero.app/api-reference/ai/support-chat-detail.md): Mirrors GraphQL `getSupportChat`.
- [Trade quote (estimate)](https://docs.echozero.app/api-reference/ai/trade-quote-estimate.md): Mirrors GraphQL `getTradeQuote`.
- [Generate a new API key + secret key pair](https://docs.echozero.app/api-reference/api-keys/generate-a-new-api-key-+-secret-key-pair.md): Creates a new API key. The raw key and secret are returned only once and cannot be retrieved later. Store them securely.
- [List current user's API keys](https://docs.echozero.app/api-reference/api-keys/list-current-users-api-keys.md): Returns all API keys for the authenticated user. Key hashes and secrets are never exposed.
- [Revoke an API key](https://docs.echozero.app/api-reference/api-keys/revoke-an-api-key.md): Soft-revokes an API key. The key will no longer be accepted for authentication.
- [Check if a username is already registered](https://docs.echozero.app/api-reference/auth/check-if-a-username-is-already-registered.md): Returns `{ exists: boolean }`. Use during signup to pre-validate a desired username before calling `/auth/lookup`.
- [Check if email is registered](https://docs.echozero.app/api-reference/auth/check-if-email-is-registered.md): Mirrors GraphQL `isEmailExists`. No API key.
- [Check if username is taken](https://docs.echozero.app/api-reference/auth/check-if-username-is-taken.md): Mirrors GraphQL `isUsernameExists`. No API key.
- [Exchange a refresh token for a new access token](https://docs.echozero.app/api-reference/auth/exchange-a-refresh-token-for-a-new-access-token.md): Validates the refresh token server-side against the client's user agent and returns a fresh JWT access token.
- [Generate a social provider OAuth URL](https://docs.echozero.app/api-reference/auth/generate-a-social-provider-oauth-url.md): Returns the provider authorization URL the client should redirect the user to. Currently only `GOOGLE` is accepted. The signed `state` is stored server-side and must be echoed back to `/auth/social/verify`.
- [Request an email verification code (login or signup)](https://docs.echozero.app/api-reference/auth/request-an-email-verification-code-login-or-signup.md): Unified login + registration lookup. If the email is already registered, an email login code is sent. Otherwise the optional signup fields are consumed and a registration code is sent.
- [Revoke a refresh token](https://docs.echozero.app/api-reference/auth/revoke-a-refresh-token.md): Marks the session associated with the provided refresh token inactive. Safe to call multiple times -- always returns `{ success: true }` once the backend has processed the request.
- [Verify an OAuth callback and issue tokens](https://docs.echozero.app/api-reference/auth/verify-an-oauth-callback-and-issue-tokens.md): Call this endpoint after the OAuth provider redirects back with `code` and `state`. Returns the same payload as `/auth/verify`.
- [Verify the email code and issue tokens](https://docs.echozero.app/api-reference/auth/verify-the-email-code-and-issue-tokens.md): Completes the login / registration flow started by `/auth/lookup`. On success the response includes `tokens.accessToken` and `tokens.refreshToken`. If the account requires MFA, `mfaRequired` is `true` and `tokens.mfaAccessToken` is issued instead -- clients must then complete an MFA verification flo…
- [Browse developer agents](https://docs.echozero.app/api-reference/developer-agents-marketplace/browse-developer-agents.md): Public. Lists beta and public developer agents with optional filters/sort presets. Accepts optional auth to enrich `isSubscribed`.
- [Developer agent detail](https://docs.echozero.app/api-reference/developer-agents-marketplace/developer-agent-detail.md): Public. Includes subscriber count and latest review when available. Accepts optional auth to enrich `isSubscribed`.
- [Full-text search for developer agents](https://docs.echozero.app/api-reference/developer-agents-marketplace/full-text-search-for-developer-agents.md): Public. Uses MongoDB text index on name, description, and strategy description. Accepts optional auth to enrich `isSubscribed`.
- [List current user subscriptions to developer agents](https://docs.echozero.app/api-reference/developer-agents-marketplace/list-current-user-subscriptions-to-developer-agents.md): Authenticated. Returns a paginated list of developer agents the current user is subscribed to.
- [List editorially featured developer agents](https://docs.echozero.app/api-reference/developer-agents-marketplace/list-editorially-featured-developer-agents.md): Public. Returns agents marked featured that are in beta or public. Accepts optional auth to enrich `isSubscribed`.
- [Subscribe to a developer agent](https://docs.echozero.app/api-reference/developer-agents-marketplace/subscribe-to-a-developer-agent.md): Creates a paid subscription record (pricing snapshot from the listing). Requires API key. Idempotent if already subscribed.
- [Unsubscribe from a developer agent](https://docs.echozero.app/api-reference/developer-agents-marketplace/unsubscribe-from-a-developer-agent.md): Removes the subscription. Idempotent. Requires API key.
- [Agent-scoped signal-trades for the dev-portal Trades tab](https://docs.echozero.app/api-reference/developer-dashboard/agent-scoped-signal-trades-for-the-dev-portal-trades-tab.md): Paginated list of signal-trades (the canonical "trade-the-agent-called") for this developer agent. Theoretical P&L is computed against the parsed entry / SL / TP and the live price feed; rows are independent of subscriber on-chain executions, so an agent with zero subscribers still builds a track re…
- [Detailed performance for a developer agent](https://docs.echozero.app/api-reference/developer-dashboard/detailed-performance-for-a-developer-agent.md): P&L, win rate, drawdown, Sharpe (from `performanceStats`) plus latest review. Owning developer only.
- [List subscribers for a developer agent](https://docs.echozero.app/api-reference/developer-dashboard/list-subscribers-for-a-developer-agent.md): Paginated list of marketplace subscribers with anonymized ids and fee-related stats. Owning developer only.
- [Paginated review history for a developer agent](https://docs.echozero.app/api-reference/developer-dashboard/paginated-review-history-for-a-developer-agent.md): Admin review decisions (approve / reject / promote) for this agent. Owning developer only.
- [Signal ingest audit log (Telegram or Discord channel)](https://docs.echozero.app/api-reference/developer-dashboard/signal-ingest-audit-log-telegram-or-discord-channel.md): Paginated rows from `signal-ingest-logs` for this agent: platform-neutral `externalChannelId` / `externalMessageId`, legacy Telegram fields when present, parse outcome, and optional linked trade summary.
- [Trade signal execution history for a developer agent](https://docs.echozero.app/api-reference/developer-dashboard/trade-signal-execution-history-for-a-developer-agent.md): Paginated signals for this agent; subscriber identifiers are opaque hashes.
- [Analyze pasted signal samples for an owned agent](https://docs.echozero.app/api-reference/developer-signal-corpus/analyze-pasted-signal-samples-for-an-owned-agent.md): Same as analyze-preview but attributes rate limits per agent. Owning developer only.
- [Analyze pasted signal samples (wizard, no agent id)](https://docs.echozero.app/api-reference/developer-signal-corpus/analyze-pasted-signal-samples-wizard-no-agent-id.md): LLM-assisted keyword bootstrap from a pasted channel corpus. Ephemeral — raw text is not stored.
- [Fetch a recent corpus analysis result](https://docs.echozero.app/api-reference/developer-signal-corpus/fetch-a-recent-corpus-analysis-result.md): Returns ephemeral analysis stored in Redis (default 7-day TTL). Developer auth only.
- [Claim strategy success fees for all owned agents](https://docs.echozero.app/api-reference/developer/claim-strategy-success-fees-for-all-owned-agents.md): Deterministic order by agent id; invokes the same per-agent claim path as Main App for each agent you own.
- [Claim strategy success fees for one agent](https://docs.echozero.app/api-reference/developer/claim-strategy-success-fees-for-one-agent.md): Mirrors gql-main `claimAgentFees`. Owner-only; drains success-fee balances (SOL transfer), marks subscription-ledger rows CLAIMED, and supports legacy bot feeEarnings — capped at `CLAIM_MAX_USD` per agent per call.
- [Claim subscription earnings](https://docs.echozero.app/api-reference/developer/claim-subscription-earnings.md): Marks all CLAIMABLE subscription CREATOR earnings as CLAIMED for the authenticated developer. Returns the total USD claimed and number of ledger rows updated. Call GET /v1/developers/earnings first to check `fromSubscriptions.claimableUsd`.
- [Developer earnings summary](https://docs.echozero.app/api-reference/developer/developer-earnings-summary.md): Success-fee totals from recorded weekly payouts (`totals`, `byAgent`, `byPeriod`), plus subscription ledger (`fromSubscriptions`) and claimable balances (`fromTrading.claimableUsd`, `totalClaimableUsd`). Requires developer registration.
- [Developer payout history](https://docs.echozero.app/api-reference/developer/developer-payout-history.md): Paginated weekly payout rows for the authenticated developer (gross, platform fee, net).
- [Get developer profile](https://docs.echozero.app/api-reference/developer/get-developer-profile.md): Returns the developer profile including revenue share, optional legacy payout address, and beta status.
- [Register as a developer](https://docs.echozero.app/api-reference/developer/register-as-a-developer.md): Creates a developer-type API key with profile. Returns raw key and secret once. If already registered, returns 409. `payoutAddress` is optional — agent fee claims credit the Echo Zero in-app wallet.
- [Start Stripe Connect onboarding](https://docs.echozero.app/api-reference/developer/start-stripe-connect-onboarding.md): Creates a Connect Express account when missing, then returns a hosted onboarding URL. Required before paid agent subscriptions can route creator share (80%) via `transfer_data`. Status updates via `account.updated` webhook.
- [Strategy success-fee claim summary (per agent)](https://docs.echozero.app/api-reference/developer/strategy-success-fee-claim-summary-per-agent.md): Aggregates unified per-agent claimable USD (subscriber success fees, `subscription-earnings` CLAIMABLE ledger, legacy `TradingBot.feeEarnings`). Same claim rail as Main App `claimAgentFees`.
- [Stripe Connect payout summary](https://docs.echozero.app/api-reference/developer/stripe-connect-payout-summary.md): Returns Connect account status, USD balances, next payout estimate, lifetime paid payouts, and subscription MRR / churn metrics for the authenticated developer.
- [Stripe Express dashboard login link](https://docs.echozero.app/api-reference/developer/stripe-express-dashboard-login-link.md): Returns a short-lived Stripe Express dashboard URL for the connected account. Requires `stripeConnectStatus=active`.
- [Update developer profile](https://docs.echozero.app/api-reference/developer/update-developer-profile.md): Updates optional legacy payout address and/or developer profile fields (company name, website, contact email). Agent fee claims credit the Echo Zero in-app wallet.
- [Post apidiscovery jobsgenerate community pick](https://docs.echozero.app/api-reference/discoveryjobs/post-apidiscovery-jobsgenerate-community-pick.md)
- [Post apidiscovery jobsgenerate discovery posts](https://docs.echozero.app/api-reference/discoveryjobs/post-apidiscovery-jobsgenerate-discovery-posts.md)
- [Post apidiscovery jobsgenerate top performer](https://docs.echozero.app/api-reference/discoveryjobs/post-apidiscovery-jobsgenerate-top-performer.md)
- [Post apidiscovery jobsgenerate trending agent](https://docs.echozero.app/api-reference/discoveryjobs/post-apidiscovery-jobsgenerate-trending-agent.md)
- [All XP levels](https://docs.echozero.app/api-reference/earn/all-xp-levels.md): Mirrors GraphQL `xpLevels`.
- [Claim rewards](https://docs.echozero.app/api-reference/earn/claim-rewards.md): Mirrors GraphQL `claimReward` mutation.
- [Referral leaderboard](https://docs.echozero.app/api-reference/earn/referral-leaderboard.md): Mirrors GraphQL `leaderboard`.
- [Referral link](https://docs.echozero.app/api-reference/earn/referral-link.md): Mirrors GraphQL `referralLink`.
- [Referral registration page data](https://docs.echozero.app/api-reference/earn/referral-registration-page-data.md): Mirrors GraphQL `referralRegistrationData`. Optional `referralCode` query. No API key.
- [Rewards and XP](https://docs.echozero.app/api-reference/earn/rewards-and-xp.md): Mirrors GraphQL `rewardsData`.
- [Weekly referral progress](https://docs.echozero.app/api-reference/earn/weekly-referral-progress.md): Mirrors GraphQL `weeklyProgress`.
- [X (Twitter) share social proof](https://docs.echozero.app/api-reference/earn/x-twitter-share-social-proof.md): Mirrors GraphQL `totalUsersSharedOnX`.
- [XP level by name](https://docs.echozero.app/api-reference/earn/xp-level-by-name.md): Mirrors GraphQL `xpLevel`. Path uses `LevelName` (e.g. `Wood`, `Gold`).
- [Post apiearn jobsdaily reset](https://docs.echozero.app/api-reference/earnjobs/post-apiearn-jobsdaily-reset.md)
- [Post apiearn jobsexpire price alerts](https://docs.echozero.app/api-reference/earnjobs/post-apiearn-jobsexpire-price-alerts.md)
- [Post apiearn jobsinactivity check](https://docs.echozero.app/api-reference/earnjobs/post-apiearn-jobsinactivity-check.md)
- [Post apiearn jobstier recalculation](https://docs.echozero.app/api-reference/earnjobs/post-apiearn-jobstier-recalculation.md)
- [Post apiearn jobsweekly reset](https://docs.echozero.app/api-reference/earnjobs/post-apiearn-jobsweekly-reset.md)
- [Activity feed](https://docs.echozero.app/api-reference/feed/activity-feed.md): Mirrors GraphQL `activityFeed`. `filter` and `types` are comma-separated enums.
- [Health check](https://docs.echozero.app/api-reference/health/health-check.md): Returns server status. No authentication required.
- [MCP JSON-RPC over Streamable HTTP](https://docs.echozero.app/api-reference/mcp-protocol/mcp-json-rpc-over-streamable-http.md): Requires **Authorize** (`x-api-key`) and a JSON-RPC body. Use **Accept**: `application/json, text/event-stream` and **Content-Type**: `application/json`. First call is usually `initialize`; response includes `mcp-session-id` — send it on later requests as header `mcp-session-id`.
- [MCP SSE stream](https://docs.echozero.app/api-reference/mcp-protocol/mcp-sse-stream.md): Requires **Authorize** and header **mcp-session-id** from `initialize`. **Accept**: `text/event-stream`.
- [Terminate MCP session](https://docs.echozero.app/api-reference/mcp-protocol/terminate-mcp-session.md): Requires **Authorize** and **mcp-session-id** matching the session to close.
- [[local/test] Multipart upload to disk](https://docs.echozero.app/api-reference/misc/[localtest]-multipart-upload-to-disk.md): Query `path` is the relative object key (e.g. `userId/developer_agent_images/uuid.png`). Multipart field `file` is the binary body. Used when `GoogleStorageProvider.getUploadFileSignedUrl` returns an `uploadUrl` pointing at mcp-main instead of hooks/GCS.
- [[local/test] Read uploaded file](https://docs.echozero.app/api-reference/misc/[localtest]-read-uploaded-file.md): Unauthenticated in local/test only so `<img src={avatarUrl}>` works without API keys.
- [Generate signed upload URLs](https://docs.echozero.app/api-reference/misc/generate-signed-upload-urls.md): Mirrors GraphQL `generateUploadUrls`. If `type` is in auth-required types (e.g. AVATAR), `x-api-key` must resolve to a user.
- [Delete notifications](https://docs.echozero.app/api-reference/notification/delete-notifications.md): Mirrors GraphQL `deleteNotifications` (same id-only scope as GraphQL). Request body lists ids — some HTTP clients omit DELETE bodies; use a client that sends JSON if needed.
- [List my notifications](https://docs.echozero.app/api-reference/notification/list-my-notifications.md): Mirrors GraphQL `myNotifications`. Returns `items` + `pagination` (see `PaginatedResponse`) plus `totalUnreadCount` (global unread, not page-only).
- [Mark all notifications as read](https://docs.echozero.app/api-reference/notification/mark-all-notifications-as-read.md): Mirrors GraphQL `markAllNotificationsAsRead`.
- [Mark notifications as read](https://docs.echozero.app/api-reference/notification/mark-notifications-as-read.md): Mirrors GraphQL `markAsReadNotifications`.
- [Notification counts by type](https://docs.echozero.app/api-reference/notification/notification-counts-by-type.md): Mirrors GraphQL `myNotificationCountsByType`.
- [Update notification settings](https://docs.echozero.app/api-reference/notification/update-notification-settings.md): Mirrors GraphQL `updateNotificationSettings` (push/email category toggles).
- [Approve an OAuth request from the Dev Portal](https://docs.echozero.app/api-reference/oauth/approve-an-oauth-request-from-the-dev-portal.md): Used by the Dev Portal consent page to mint an authorization code without putting the user JWT in a URL.
- [Exchange authorization code for OAuth token](https://docs.echozero.app/api-reference/oauth/exchange-authorization-code-for-oauth-token.md)
- [Introspect an EchoZero OAuth token](https://docs.echozero.app/api-reference/oauth/introspect-an-echozero-oauth-token.md)
- [Look up a registered OAuth client](https://docs.echozero.app/api-reference/oauth/look-up-a-registered-oauth-client.md): Used by the Dev Portal consent page to validate client_id and redirect_uri before approval or denial.
- [OAuth 2.1 authorization endpoint](https://docs.echozero.app/api-reference/oauth/oauth-21-authorization-endpoint.md): Authorization-code + PKCE endpoint for AI assistant clients. Accepts a user JWT via Authorization bearer or local consent form.
- [Verify OAuth bearer token](https://docs.echozero.app/api-reference/oauth/verify-oauth-bearer-token.md): Small verification endpoint for CLI and AI setup flows after OAuth login.
- [Post a signed trading signal for a developer agent (webhook ingress)](https://docs.echozero.app/api-reference/public-—-inbound-agent-signals/post-a-signed-trading-signal-for-a-developer-agent-webhook-ingress.md): Authenticates via per-agent signing secret (`X-EZ-*` headers). Accepts natural-language `text`, full structured JSON with `eventType` (#1098), or legacy `action`/`tokenAddress`. See `docs/INBOUND_AGENT_WEBHOOK.md`.
- [List sandbox signal simulations for a strategy](https://docs.echozero.app/api-reference/sandbox/list-sandbox-signal-simulations-for-a-strategy.md): Returns ephemeral dry-run signal history recorded through the sandbox simulator for the selected strategy.
- [Simulate a developer-agent trade](https://docs.echozero.app/api-reference/sandbox/simulate-a-developer-agent-trade.md): Dry-run sandbox endpoint. Validates ownership and returns a simulated trade result without any real execution.
- [Simulate a strategy signal message](https://docs.echozero.app/api-reference/sandbox/simulate-a-strategy-signal-message.md): Dry-run sandbox parser for raw signal text. Stores the simulation in ephemeral sandbox history for the selected strategy.
- [List country codes](https://docs.echozero.app/api-reference/statics/list-country-codes.md): Returns `data` as `string[]` (`CountryCode` values).
- [List language codes](https://docs.echozero.app/api-reference/statics/list-language-codes.md): Returns `data` as `string[]` (`Lang` values).
- [Available strategy tags](https://docs.echozero.app/api-reference/strategy/available-strategy-tags.md): Mirrors GraphQL `getAvailableTags`. Paginated (`items` + `pagination`).
- [Bot status tab counts](https://docs.echozero.app/api-reference/strategy/bot-status-tab-counts.md): Mirrors GraphQL `botStatusCounts` / `getBotStatusCounts`.
- [Bot template detail](https://docs.echozero.app/api-reference/strategy/bot-template-detail.md): Mirrors GraphQL `botTemplateDetail` / `getBotTemplateDetail`.
- [Claim creator fees](https://docs.echozero.app/api-reference/strategy/claim-creator-fees.md): Mirrors `claimFees`.
- [Claim subscription fees](https://docs.echozero.app/api-reference/strategy/claim-subscription-fees.md): Mirrors `claimSubscriptionFees`.
- [Configuration summary (review)](https://docs.echozero.app/api-reference/strategy/configuration-summary-review.md): Mirrors GraphQL `getBotConfigurationSummary`.
- [Create or update strategy](https://docs.echozero.app/api-reference/strategy/create-or-update-strategy.md): Mirrors GraphQL `createOrUpdateBot`.
- [Create-trading input snapshot](https://docs.echozero.app/api-reference/strategy/create-trading-input-snapshot.md): Mirrors GraphQL `getCreateTradingInputSnapshot`.
- [Delete strategy](https://docs.echozero.app/api-reference/strategy/delete-strategy.md): Mirrors `deleteBot`.
- [Fee withdrawal history](https://docs.echozero.app/api-reference/strategy/fee-withdrawal-history.md): Mirrors GraphQL `botWithdrawals` / `getBotWithdrawals`.
- [Get strategy by id](https://docs.echozero.app/api-reference/strategy/get-strategy-by-id.md): Mirrors GraphQL `tradingBot` / `getTradingBotById`.
- [List bot templates](https://docs.echozero.app/api-reference/strategy/list-bot-templates.md): Mirrors GraphQL `botTemplates` / `getBotTemplates`.
- [List strategies (trading bots)](https://docs.echozero.app/api-reference/strategy/list-strategies-trading-bots.md): Mirrors GraphQL `tradingBots` / `getTradingBots`.
- [Pause strategy](https://docs.echozero.app/api-reference/strategy/pause-strategy.md): Mirrors `pauseBot`.
- [Performance tab data](https://docs.echozero.app/api-reference/strategy/performance-tab-data.md): Mirrors GraphQL `getBotPerformance`.
- [Platform fee structure](https://docs.echozero.app/api-reference/strategy/platform-fee-structure.md): Mirrors GraphQL `platformFees` / `getPlatformFees`. No user-scoped resolver args.
- [Resume strategy](https://docs.echozero.app/api-reference/strategy/resume-strategy.md): Mirrors `playBot`.
- [Stop all trades](https://docs.echozero.app/api-reference/strategy/stop-all-trades.md): Mirrors `stopAllTrades`.
- [Strategy details (dashboard)](https://docs.echozero.app/api-reference/strategy/strategy-details-dashboard.md): Mirrors GraphQL `botDetails` / `getBotDetails`.
- [Get token by id or symbol](https://docs.echozero.app/api-reference/token/get-token-by-id-or-symbol.md): Mirrors GraphQL `getToken`. Path may be a MongoDB id or a token symbol (e.g. `SOL`). Public.
- [List tokens](https://docs.echozero.app/api-reference/token/list-tokens.md): Mirrors GraphQL `getTokens`: filters, sort, pagination. Public.
- [Trending tokens](https://docs.echozero.app/api-reference/token/trending-tokens.md): Mirrors GraphQL `trendingTokens`. Sorted by volume/market cap/etc. Public.
- [Record a portal demo trade signal (dev-signals collection)](https://docs.echozero.app/api-reference/trade-signals-dev/record-a-portal-demo-trade-signal-dev-signals-collection.md): Authenticated developer API key. Persists a sandbox row scoped to the agent in the `dev-signals` Mongo collection — isolated from canonical `trade-signals` used by webhooks and live ingest. Same DTO shape as WebSocket `signal` / structured ingest; no HMAC and no execution pipeline.
- [Get a trade signal by signalId](https://docs.echozero.app/api-reference/trade-signals/get-a-trade-signal-by-signalid.md): Returns a single trade signal record. Must be owned by the authenticated developer.
- [List trade signals for a specific developer agent](https://docs.echozero.app/api-reference/trade-signals/list-trade-signals-for-a-specific-developer-agent.md): Returns paginated list of trade signals filtered by developer agent.
- [List trade signals for the authenticated developer](https://docs.echozero.app/api-reference/trade-signals/list-trade-signals-for-the-authenticated-developer.md): Returns paginated list of all trade signals sent by the developer.
- [List trades](https://docs.echozero.app/api-reference/trade/list-trades.md): Mirrors GraphQL `trades` (`getTrades`).
- [Search strategies (trading bots) traded with](https://docs.echozero.app/api-reference/trade/search-strategies-trading-bots-traded-with.md): Mirrors GraphQL `searchTradeTradingBots`.
- [Search tokens traded](https://docs.echozero.app/api-reference/trade/search-tokens-traded.md): Mirrors GraphQL `searchTradeTokens`.
- [Activate a trading bot under a subscribed agent](https://docs.echozero.app/api-reference/user/activate-a-trading-bot-under-a-subscribed-agent.md)
- [Active sessions for the current user](https://docs.echozero.app/api-reference/user/active-sessions-for-the-current-user.md)
- [Check membership in a developer agent signal channel](https://docs.echozero.app/api-reference/user/check-membership-in-a-developer-agent-signal-channel.md): Resolves the agent’s active Discord or Telegram `connectedChannels` row (Discord preferred when both are active) and verifies your linked membership via Discord `getGuildMember` or Telegram `getChatMember`.
- [Current user profile](https://docs.echozero.app/api-reference/user/current-user-profile.md)
- [Deactivate a trading bot](https://docs.echozero.app/api-reference/user/deactivate-a-trading-bot.md): :strategyId is the trading bot id.
- [Internal agent subscriptions (follow)](https://docs.echozero.app/api-reference/user/internal-agent-subscriptions-follow.md): Maps to GraphQL `myAgentSubscriptions`.
- [Link Telegram or Discord channel membership](https://docs.echozero.app/api-reference/user/link-telegram-or-discord-channel-membership.md): Upserts a row keyed by (user, platform, channelId). Telegram requires `telegramUserId`; Discord requires `discordUserId` (snowflake).
- [Linked Twitter / Discord status](https://docs.echozero.app/api-reference/user/linked-twitter-discord-status.md)
- [List linked external channels](https://docs.echozero.app/api-reference/user/list-linked-external-channels.md): Telegram/Discord channel memberships stored for signal-group gating. Telegram rows require `telegramUserId` for live `getChatMember` checks.
- [Onboarding guide agent (if set)](https://docs.echozero.app/api-reference/user/onboarding-guide-agent-if-set.md)
- [Revoke a channel membership link](https://docs.echozero.app/api-reference/user/revoke-a-channel-membership-link.md)
- [Save onboarding guide agent](https://docs.echozero.app/api-reference/user/save-onboarding-guide-agent.md)
- [Save onboarding interests](https://docs.echozero.app/api-reference/user/save-onboarding-interests.md)
- [Subscribe to (follow) an internal agent](https://docs.echozero.app/api-reference/user/subscribe-to-follow-an-internal-agent.md)
- [Trading bot activations for the current user](https://docs.echozero.app/api-reference/user/trading-bot-activations-for-the-current-user.md)
- [Unsubscribe from an internal agent](https://docs.echozero.app/api-reference/user/unsubscribe-from-an-internal-agent.md): Optional query.keepTrade=false closes open trades before unsubscribing (mirrors GraphQL `UnsubscribeFromAgentInput`).
- [Update agent subscription configuration](https://docs.echozero.app/api-reference/user/update-agent-subscription-configuration.md): Request body schema: **McpUpdateAgentSubscriptionBodyDto** — mirrors GraphQL `UpdateAgentSubscriptionInput` (without agentId; taken from path).
- [Update an active bot (mode / allocation)](https://docs.echozero.app/api-reference/user/update-an-active-bot-mode-allocation.md): :strategyId is the trading bot id.
- [Update current user profile](https://docs.echozero.app/api-reference/user/update-current-user-profile.md): Request body schema: **McpPatchUserBodyDto** — mirrors GraphQL `EditUserInput`.
- [Add virtual funds](https://docs.echozero.app/api-reference/wallet/add-virtual-funds.md): Mirrors GraphQL `addFundsToVirtualWallet` (amount in SOL).
- [Buy tokens](https://docs.echozero.app/api-reference/wallet/buy-tokens.md): Mirrors GraphQL `buyTokens`.
- [Deposit funds](https://docs.echozero.app/api-reference/wallet/deposit-funds.md): Mirrors GraphQL `depositFunds`.
- [Get wallet mode](https://docs.echozero.app/api-reference/wallet/get-wallet-mode.md): Mirrors GraphQL `getWalletMode` (real vs virtual trading).
- [Historical chart data](https://docs.echozero.app/api-reference/wallet/historical-chart-data.md): Mirrors GraphQL `historicalChartData` (EchoZero chart: prices, market caps, volumes).
- [Search wallet trades](https://docs.echozero.app/api-reference/wallet/search-wallet-trades.md): Mirrors GraphQL `searchWalletTrades`.
- [Sell tokens](https://docs.echozero.app/api-reference/wallet/sell-tokens.md): Mirrors GraphQL `sellTokens`.
- [Toggle wallet mode](https://docs.echozero.app/api-reference/wallet/toggle-wallet-mode.md): Mirrors GraphQL `toggleWalletMode`.
- [Withdraw funds](https://docs.echozero.app/api-reference/wallet/withdraw-funds.md): Mirrors GraphQL `withdrawFunds`. MFA session verification from JWT is not available via API key; `verified` is passed as `false` (withdrawals that require MFA may return an error — use the main app after MFA when required).
- [Discord signal-bot message ingest (dev / fallback)](https://docs.echozero.app/api-reference/webhooks/discord-signal-bot-message-ingest-dev-fallback.md): Accepts a normalized message payload when Gateway ingest is off or for tests. When `SIGNAL_DISCORD_WEBHOOK_SECRET` is set, send header `X-Discord-Signal-Webhook-Secret`.
- [Telegram signal-bot updates (my_chat_member / chat_member)](https://docs.echozero.app/api-reference/webhooks/telegram-signal-bot-updates-my_chat_member-chat_member.md): Public endpoint for Telegram Bot API webhooks. When `SIGNAL_TELEGRAM_WEBHOOK_SECRET` is set, requests must include header `X-Telegram-Bot-Api-Secret-Token` matching that value (same string passed to Telegram `setWebhook` as `secret_token`).
- [API keys and HMAC signing](https://docs.echozero.app/guides/api-keys-hmac.md): Authenticate REST and MCP requests with API keys and optional request signing.
- [Earnings and payouts](https://docs.echozero.app/guides/earnings.md): Marketplace revenue, subscriber fees, and developer payout flows.
- [Error codes](https://docs.echozero.app/guides/error-codes.md): Common API error shapes, HTTP status codes, and retry guidance.
- [MCP Server](https://docs.echozero.app/guides/mcp.md): Connect AI assistants to Echo Zero via Model Context Protocol (Streamable HTTP).
- [OAuth 2.1](https://docs.echozero.app/guides/oauth.md): Authorization code + PKCE for AI assistant and CLI clients.
- [Sandbox testing](https://docs.echozero.app/guides/sandbox.md): Test integrations against the public Echo Zero API without affecting live subscribers or executing real trades.
- [Signal envelope](https://docs.echozero.app/guides/signal-envelope.md): Structured trade signal events, idempotency keys, and delivery semantics.
- [Webhook security](https://docs.echozero.app/guides/webhook-security.md): Verify inbound provider webhooks with shared secrets, HMAC, and replay protection.
- [Introduction](https://docs.echozero.app/index.md): Build, connect, and operate trading agents on Echo Zero with REST, MCP, and webhooks.
- [Quickstart](https://docs.echozero.app/quickstart.md): Authenticate and call the Echo Zero MCP API in minutes.

## OpenAPI Specs

- [docs-json](https://mcp.echozero.app/api/docs-json)

## Optional

- [GitHub](https://github.com/EchoZeroApp/echozero)