PE · Profit Engine · Governor v1

Idea generation is not capital approval.The Governor decides how much is permitted — deterministically.

Your agent proposes candidates. PE Governor validates portfolio freshness, reconciliation, kill switch, evidence, expiry, loss and drawdown limits, capital reserve, notional caps and concurrency — then returns one verdict with an exact permitted size and every observed value next to its limit.

POST/api/pe/v1/governor
GET/.well-known/pe-governor.json
GET/pe/openapi.json
Pure deterministic policy — no model inference Canonical request + decision SHA-256 Paid per decision in USDC via Coinbase Business

Four verdicts. Nothing ambiguous.

ALLOCATE

The full requested notional is permitted. allocationAmountUsd equals the request.

REDUCE

Permitted, but smaller. Never exceed the returned allocationAmountUsd.

REJECT

A hard candidate failure: rejected evidence, expiry, loss above notional, below threshold or lane edge.

HOLD

A temporary blocker: stale or unreconciled state, kill switch, evidence collecting, capacity or concurrency full.

Deterministic demo

Same request in, same decision out — including the hashes. Nothing here is a forecast.

SPOT · basis-carry · BTC-USDREDUCE
Requested
$45,000.00
Permitted
$30,000.00
Caller edge
60 bps
After-cost profit at size
$156.00
  • portfolioAgeSeconds 0 ≤ 300 · reconciled · kill switch off
  • capitalReserveCap $65,000 · dailyNotionalCap $60,000 · candidateNotionalCap $30,000
  • laneOpenPositions 1 < 4 · maximumLossUsd $1,200 ≤ notional

Expected edge and maximum loss are values your system supplied. The Governor approves capital; it does not forecast outcomes.

Install policy
# Install once, then obey the Governor.
if allocation_usd >= INSTALL_THRESHOLD_USD:
    d = post("/api/pe/v1/governor", request)     # pays per decision in USDC
    if d["decision"] in ("REJECT", "HOLD"):
        stand_down()                              # no capital moves
    else:
        size = d["allocationAmountUsd"]           # never exceed a REDUCE
        submit_to_your_own_execution_venue(size)  # PE never executes

Three steps

  1. 1POST candidates, portfolio state and constraints with an X-Idempotency-Key UUID v4. You receive HTTP 402 with a Coinbase Business x402 URL.
  2. 2Pay in USDC on Base. Retry with the same key plus X-Checkout-Id: 202 while the checkout is ACTIVE or PROCESSING.
  3. 3Once COMPLETED you get 200 with the stored decision. Repeats replay the identical decision — an authorization alone is not settlement.

Wire format

Strict JSON. Unknown fields, duplicate candidate identities, non-finite numbers and bodies over 128 KiB are rejected before any billing decision.

pe-governor-request.v1
{
  "schemaVersion": "pe-governor-request.v1",
  "portfolio": {
    "asOf": "2026-08-11T22:00:00.000Z",
    "reconciled": true,
    "killSwitchEngaged": false,
    "equityUsd": 250000,
    "cashUsd": 90000,
    "openNotionalUsd": 120000,
    "dailyNotionalUsd": 40000,
    "dailyRealizedLossUsd": 500,
    "drawdownPct": 2.1,
    "laneOpenPositions": { "EQUITIES": 2, "SPOT": 1, "FUTURES": 0 },
    "openPositions": [{ "assetId": "ETH-USD", "lane": "SPOT", "notionalUsd": 20000 }]
  },
  "constraints": {
    "installThresholdUsd": 1000,
    "capitalReserveUsd": 25000,
    "maxCandidateNotionalUsd": 30000,
    "maxPositionNotionalUsd": 40000,
    "maxPortfolioNotionalUsd": 200000,
    "maxDailyNotionalUsd": 100000,
    "maxDailyLossUsd": 5000,
    "maxDrawdownPct": 10,
    "maxPortfolioConcurrentPositions": 8,
    "portfolioStalenessSeconds": 300,
    "costBps": 8,
    "laneLimits": {
      "EQUITIES": { "minimumEdgeBps": 20, "maxConcurrentPositions": 4 },
      "SPOT":     { "minimumEdgeBps": 25, "maxConcurrentPositions": 4 },
      "FUTURES":  { "minimumEdgeBps": 35, "maxConcurrentPositions": 2 }
    }
  },
  "candidates": [
    {
      "candidateId": "cand-a",
      "sourceLane": "SPOT",
      "strategyId": "basis-carry",
      "assetId": "BTC-USD",
      "side": "BUY",
      "reduceOnly": false,
      "requestedNotionalUsd": 45000,
      "maximumLossUsd": 1200,
      "expectedNetEdgeBps": 60,
      "evidenceStatus": "READY",
      "createdAt": "2026-08-11T21:59:00.000Z",
      "expiresAt": "2026-08-11T22:05:00.000Z"
    }
  ]
}
pe-governor-decision.v1
{
  "schemaVersion": "pe-governor-decision.v1",
  "decision": "REDUCE",
  "allocationAmountUsd": 30000,
  "selectedCandidateId": "cand-a",
  "candidates": [
    {
      "candidateId": "cand-a",
      "action": "REDUCE",
      "requestedNotionalUsd": 45000,
      "allocationAmountUsd": 30000,
      "expectedAfterCostProfitUsd": 156,
      "rank": 1,
      "reasons": [
        {
          "code": "constrained_by_limit",
          "kind": "informational",
          "message": "Permitted size constrained by candidateNotionalCap.",
          "checks": [{ "name": "candidateNotionalCap", "observed": 30000, "limit": 30000 }]
        }
      ]
    }
  ],
  "policyVersion": "pe-governor-policy-1.0.0",
  "execution": {
    "executionPerformed": false,
    "custody": false,
    "brokerage": false,
    "orderPlacement": false,
    "walletControl": false,
    "llmDecisioning": false
  },
  "audit": {
    "requestSha256": "…",
    "decisionSha256": "…",
    "policyVersion": "pe-governor-policy-1.0.0",
    "evaluatedAt": "2026-08-11T22:00:00.000Z",
    "candidateCount": 1,
    "eligibleCount": 1,
    "deterministic": true
  }
}

Coinbase Business settlement

Payment and settlement run on Coinbase Business Checkouts: USDC on Base, auth-capture, one checkout per idempotency key. Prepaid credit credentials are supported and consumed exactly once per request. Our manifest and OpenAPI documents are discovery metadata only.

GET/api/pe/v1/catalog
GET/pe/llms.txt

Boundary: no alpha, no execution

  • No custody, wallet control, or brokerage.
  • No order placement or trade execution — ever.
  • No LLM decisioning inside the policy.
  • No alpha, signal, or forecasting claim. Expected edge and maximum loss are caller supplied.

Every response sets executionPerformed, custody, brokerage, orderPlacement, walletControl and llmDecisioning to false. PE Governor is risk governance software, not investment advice.