Skip to main content
Developers earn from subscriber success fees and agent subscriptions. There are no trading fees: subscribers are never charged per trade, and you are never paid per trade. Everything is settled and paid in USDC. All routes require developer registration and API key authentication with HMAC signing. See API keys and HMAC.

​
Fee economics

The most a subscriber can pay in success fees is 30% of new profit (your 22% maximum plus EchoZero’s 8%).

​
How the success fee works

EchoZero tracks a high-water mark (HWM) for every subscriber on every agent they follow. The HWM is the subscriber’s best cumulative realized profit on that agent, net of venue costs, adjusted for their deposits and withdrawals.
  • A fee accrues only when realized profit moves above the HWM, and only on the amount above it.
  • No fee is charged on losses or on principal, and none is charged while the subscriber is below their previous peak. Recovering a drawdown is free.
  • Accrued fees are settled weekly from the subscriber’s balance. If a balance cannot cover the fee at settlement, the rest stays owed and is collected at a later settlement (catch-up).
  • Fees also settle immediately when a subscriber withdraws, unsubscribes, or reduces their allocation to the agent.

​
Worked example: success fee

Your successFeePercent is 15%. A subscriber’s realized profit on your agent reaches 2,000∗∗,andtheirprevioushigh−watermarkwas∗∗2,000**, and their previous high-water mark was **0.
  1. Fee base: 2,000−2,000 - 0 = $2,000 of new profit
  2. Your creator fee: 2,000×152,000 × 15% = **300**
  3. EchoZero platform fee: 2,000×82,000 × 8% = **160**
  4. The subscriber pays **460∗∗atthenextweeklysettlement.TheirHWMisnow460** at the next weekly settlement. Their HWM is now 2,000.
The following week, the subscriber’s realized profit drops to 1,500andthenrecoversto1,500 and then recovers to 2,300. Only the **300∗∗abovethe300** above the 2,000 HWM is charged: 45toyouand45 to you and 24 to EchoZero.
Accrued but unsettled fees are visible in your earnings totals but are not claimable until they have been collected at settlement.

​
Worked example: subscription

You set monthlyPrice: 29. Ten subscribers pay for one month.
  1. Gross: $290
  2. Platform fee (20%): $58
  3. Your share: $232, claimable as USDC

​
Monetization models

Set on agent create/update (pricingModel): Values of successFeePercent above 22 are rejected on create, update, and marketplace publish.

​
Getting paid

Every payout lands as USDC in your EchoZero wallet. You claim it; nothing moves automatically. Each weekly settlement also records a payout snapshot (gross, platform fee, net) that you can read from payout history.

​
Key endpoints

​
Earnings summary

Returns (all amounts in USD, paid as USDC):
  • totals, byAgent: success-fee totals, including fees accrued but not yet settled
  • byPeriod: weekly payout snapshots
  • fromTrading.claimableUsd: success fees collected and ready to claim
  • fromSubscriptions.claimableUsd: subscription earnings ready to claim
  • totalClaimableUsd: both combined
  • lifetimeClaimedUsd, fromInstantClaims: what you have already claimed
Check this before claiming. The totalClaimable field is a deprecated alias of totalClaimableUsd.

​
Payout history

Paginated weekly payout rows: gross amount, platform fee, net.

​
Claim success fees

Transfers collected success fees to your wallet as USDC. Each call is capped per agent (CLAIM_MAX_USD); call again to claim any remainder. Returns 404 if the agent is not found or not owned by the caller.

​
Claim subscription earnings

Claims all claimable subscription earnings as USDC into your EchoZero wallet. Returns the total USD claimed and the number of ledger rows updated. Returns 400 when there is nothing to claim. Call GET /earnings first to check fromSubscriptions.claimableUsd.
Stripe Connect payouts are retired. Subscribers still pay subscriptions by card, but your share is paid as USDC through the claim endpoint above. The old /api/v1/developers/stripe-connect/* routes return 410 Gone. You do not need to onboard with Stripe.

​
Typical workflow

1

Register as a developer

Complete developer registration in the Dev Portal or via POST /api/v1/developers/register.
2

Price your agent

Set pricingModel, and successFeePercent (0-22) and/or monthlyPrice, when you create or update the agent.
3

Publish agents

Publish to the marketplace. See Agent lifecycle.
4

Monitor earnings

Poll GET /v1/developers/earnings for claimable balances and GET /v1/developers/payouts for weekly settlement history.
5

Claim balances

  • Success fees: POST /claims/agents/{agentId} or POST /claims/all
  • Subscriptions: POST /claim-subscription-earnings

​
Dashboard analytics

Additional developer dashboard routes (subscribers, performance, signal history) are under the Developer dashboard tag in the API Reference. These complement earnings data for operational monitoring.