Xpersona
S

simmer-preflight

CLAWHUB · Unverified

Pre-trade readiness check for autonomous agents. One call returns wallet identity, venue status, spendable balance, open exposure, and a structured ok_to_trade verdict. Live real-venue trades auto-run this check and refuse when ok_to_trade is False. Skill: simmer-preflight Owner: simmer Summary: Pre-trade readiness check for autonomous agents. One call returns wallet identity, venue status, spendable balance, open exposure, and a structured ok_to_trade verdict. Live real-venue trades auto-run this check and refuse when ok_to_trade is False. Tags: latest:0.3.6 Version history: v0.3.6 | 2026-09-22T04:14:01.101Z | user Refuses live trades without a preflight ok_to_

62
Rank
84
Safety
976
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 976 downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:simmer-preflight
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-preflight/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

46,050 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: simmer-preflight
version: "0.3.6"
published: true
read_only: true
description: Pre-trade readiness check for autonomous agents. One call returns wallet identity, venue status, spendable balance, open exposure, and a structured ok_to_trade verdict. Live real-venue trades auto-run this check and refuse when ok_to_trade is False.
metadata:
  author: "Simmer (@simmer_markets)"
  version: "0.3.6"
  displayName: Simmer Preflight
  difficulty: beginner
  primaryEnv: SIMMER_API_KEY
  envVars:
    - name: SIMMER_API_KEY
      required: true
      description: "Your Simmer SDK API key."
---

# Simmer Preflight

Live real-money trades now **enforce** this check. `client.trade(..., dry_run=False)` and `client.place_combo(..., dry_run=False)` on a `live=True` client against a real venue (`polymarket` / `kalshi`) auto-run `preflight()` and refuse if `ok_to_trade` is False, surfacing the blocker codes. The auto-gate's exposure cap is opt-in (`EXPOSURE_CAP_USD` set → enforced; unset → cap disabled) and sells are exempt from cap math so an over-cap book can still reduce exposure. Wallet / venue / gas blockers still run. Paper, `venue="sim"`, and `dry_run=True` are unchanged. One-release migrate valve: `skip_preflight=True` or `SIMMER_SKIP_PREFLIGHT=1` (deprecation warning). MCP `simmer_trade` uses the same live gate; `SIMMER_MCP_ALLOW_LIVE` is still required and is not a replacement.

Call `client.preflight()` yourself when you want the full result (wallet, exposure, `client_preflight_id`) before you size or submit. One call returns:

- **Who you are**: agent ID, tier, venue resolved from your API key context
- **Which wallet will sign**: execution wallet, deposit wallet, signer mode (OWS / external key / managed)
- **Spendable balance**: venue-specific USDC or $SIM balance from the briefing
- **Open exposure**: sum of `current_value` across your existing positions (real venues only for USD cap)
- **Cap check**: whether `planned_amount + open_exposure_total` exceeds your `exposure_cap_usd`
- **Risk alerts**: any briefing risk signals (concentration, expiry, reliability)
- **ok_to_trade**: a single boolean — True if no blockers

## When to use

Call preflight before every automated trade, especially:

- Before the first real-money order of a run
- Before scaling into a position beyond your initial size
- When your heartbeat wakes up after a long sleep (state may have changed)

Do not call it on every polling tick — it makes 3 API calls. Once per trade intent is correct.

## Call it

```python
from simmer_sdk import SimmerClient

client = SimmerClient.from_env(venue="polymarket")

result = client.preflight(
    venue="polymarket",       # venue to check (defaults to client.venue)
    planned_amount=5.0,       # USDC you plan to spend on this trade
    exposure_cap_usd=100.0,   # your total cross-venue exposure limit
)

if not result.ok_to_trade:
    print(f"Preflight blocked: {result.blockers}")
    # e.g. ["EXPOSURE_CAP_EXCEEDED"]
    return

# Log for a

_meta.json

{
  "ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x",
  "slug": "simmer-preflight",
  "version": "0.3.6",
  "publishedAt": 1790050441101
}

skill-card.md

## Description:

Pre-trade readiness check for autonomous agents that returns wallet identity, venue status, spendable balance, open exposure, and an ok_to_trade verdict before live real-venue trades proceed.

This skill is ready for commercial/non-commercial use.

## Publisher:

[simmer](https://clawhub.ai/user/simmer)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and autonomous-agent operators use this skill before automated trade submission to check account readiness, wallet identity, balance, exposure, and blocking conditions. It supports pre-trade audit logging and fail-closed handling when a real-venue trade is not ready to proceed.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill requires a Simmer API key and reports trading-account readiness data, including wallet, balance, exposure, blockers, and warnings.

Mitigation: Install only from a trusted publisher, provide the API key through the SIMMER_API_KEY environment variable, and avoid exposing JSON or terminal output where account details should remain private.

Risk: Preflight checks depend on current account, venue, and position data, so stale or failed checks can affect trade readiness decisions.

Mitigation: Run the check once per trade intent, inspect blockers and warnings, and treat configuration or fetch failures as reasons to pause live trading until resolved.

## Reference(s):

- [Simmer API and wallet documentation](https://docs.simmer.markets)
- [ClawHub skill page](https://clawhub.ai/simmer/skills/simmer-preflight)

## Skill Output:

**Output Type(s):** [text, JSON, guidance]

**Output Format:** [Human-readable terminal output or structured JSON]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Uses exit codes 0, 1, and 2 to indicate pass, blocked, or configuration error.]

## Skill Version(s):

0.3.6 (source: server release and skill frontmatter)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

clawhub.json

{
  "emoji": "✅",
  "primaryEnv": "SIMMER_API_KEY",
  "requires": {
    "env": [
      "SIMMER_API_KEY"
    ],
    "pip": [
      "simmer-sdk>=0.17.13"
    ]
  },
  "envVars": [
    {
      "name": "SIMMER_API_KEY",
      "required": true,
      "description": "Your Simmer SDK API key — get from simmer.markets/dashboard"
    },
    {
      "name": "TRADING_VENUE",
      "required": false,
      "description": "Default trading venue (sim / polymarket / kalshi). Overridden by the venue argument to client.preflight()."
    },
    {
      "name": "EXPOSURE_CAP_USD",
      "required": false,
      "description": "Optional live auto-gate cap in USD across real venues. Set to enforce; unset disables the cap (no $100 default). Manual client.preflight() still accepts an explicit exposure_cap_usd."
    }
  ],
  "cron": null,
  "autostart": false,
  "automaton": {
    "managed": true,
    "entrypoint": "preflight.py"
  }
}

Sponsored

Ads related to simmer-preflight and adjacent AI workflows.