Agents & signals

Unlike Fission (where registration tied a token to an underlying like SOL-PERP), pumperp desks are opened by an agent that picks live market structure per token.

Decision flow

flowchart TD
  Start["manageOneDesk(token)"] --> Halt{Desk halted?}
  Halt -->|yes| Skip[Skip]
  Halt -->|no| Pending{perp USDC ≥ min?}
  Pending -->|no| Skip
  Pending -->|yes| Exists{Desk exists?}
  Exists -->|yes| Increase[Increase position]
  Exists -->|no| Agent["decideDeskEntry(token, pendingUsdc)"]
  Agent --> Venice{Venice LLM available?}
  Venice -->|yes| VPlan[JSON trade plan]
  Venice -->|no| Signals[Momentum signal scan]
  VPlan --> Allow{allow?}
  Signals --> Allow
  Allow -->|no| Defer[Defer — re-queue USDC]
  Allow -->|yes| Open[Open Avantis desk]

Two-tier agent (decideDeskEntry)

Located in backend/src/services/agent.ts.

1. Venice LLM (primary)

When VENICE_AGENT_ENABLED=true (default) and a Venice API key resolves (VENICE_API_KEY or auto-mint via VENICE_AUTO_MINT_KEY):

• Sends Pyth/momentum snapshot + pending USDC to Venice chat completions
• Expects JSON: { allow, market, side, leverage, reason }
• Markets constrained to ETH / BTC; leverage capped by Avantis + RISK.leverage
• DIEM fee slice funds the intelligence stack — agent decisions are the operational payoff of that leg

2. Signal engine (fallback)

If Venice is disabled, unreachable, or returns bad JSON:

1. For each market in ['ETH', 'BTC']
2. Fetch signal from market-signal.ts (Pyth Hermes + rolling samples)
3. Evaluate long/short via evaluateEntry
4. Rank by |momentumPct|, pick best candidate

When SIGNAL.enabled === false ("full degen"):

• Opens long ETH at max leverage — no filter

Signal parameters

Leverage

leverage = Math.min(config.RISK.leverage, config.AVANTIS_MAX_LEVERAGE, avantisPairCap)

Registry vs desk

ProtocolRegistry stores underlying, isLong, leverage at enroll time for display/indexing. The desk agent chooses live market/side at open — registry fields are not binding.