SKILL: trading-integration

Purpose

Integrate trading infrastructure safely (hummingbot and/or MCP Axodus Trading) with paper-first execution, full logging/auditability, and strict risk gating.

When to Use

• Adding or updating connectors for hummingbot.
• Wiring execution to MCP Axodus Trading interfaces.
• Building market data ingestion, order routing, or strategy execution surfaces.

Inputs

• targets (required, string[]): e.g., ["hummingbot", "mcp-axodus-trading"]
• mode (optional, enum: paper|live, default: paper)
• markets (optional, string[]): symbols/venues to support.
• risk_limits (optional, object): max risk per trade, max drawdown, exposure caps, kill-switch.
• logging_requirements (optional, string[]): required audit events.

Steps

1. Confirm non-negotiables:
• no profit guarantees
• paper mode default
• full logs for signal/decision/execution/result
2. Map integration points:
• market data feeds
• execution endpoints
• capital allocation interface
3. Implement configuration surfaces:
• env/config references (no secrets in repo)
• explicit mode flag for live
4. Implement deterministic execution flow:
• preflight checks (risk limits, connectivity)
• order submission
• order state tracking
• post-trade recording
5. Implement failure handling:
• bounded retries
• fallback to safe stop
• kill-switch triggers on abnormal loss
6. Validate in paper mode:
• dry-run order lifecycle
• audit logs produced
• risk gating blocks unsafe actions

Validation

• Live mode cannot run without an explicit flag and passing preflight checks.
• All actions emit audit logs (no silent decisions).
• Risk limits are enforced before order placement.
• Secrets are not printed or committed.

Output

• Integration summary (what’s wired)
• Config contract (required env vars, mode flags)
• Validation commands/runbook (paper test loop)

Safety Rules

• Never enable live trading by default.
• Never request or store exchange API keys in plaintext.
• Never frame outcomes as guaranteed profit; treat as experimental systems with controlled risk.

Example

Paper-first integration:

• targets: ["hummingbot"]
• mode: paper
• Output: runbook describing simulated order placement and expected audit log entries.