{
  "name": "PE Governor",
  "summary": "PE (Profit Engine) Governor is a deterministic capital-approval API. It separates idea generation from capital approval: an external agent proposes candidates, the Governor returns ALLOCATE, REDUCE, REJECT, or HOLD with an exact permitted size and auditable reasons.",
  "requestSchemaVersion": "pe-governor-request.v1",
  "decisionSchemaVersion": "pe-governor-decision.v1",
  "policyVersion": "pe-governor-policy-1.0.0",
  "endpoint": "https://solarly.ai/api/pe/v1/governor",
  "method": "POST",
  "lanes": [
    "EQUITIES",
    "SPOT",
    "FUTURES"
  ],
  "maxCandidates": 50,
  "maxRequestBytes": 131072,
  "determinism": "Pure function of the request plus evaluation time. No model inference is used.",
  "boundary": {
    "executionPerformed": false,
    "custody": false,
    "brokerage": false,
    "orderPlacement": false,
    "walletControl": false,
    "llmDecisioning": false,
    "alphaOrForecasting": false,
    "note": "Expected edge and maximum loss are supplied by the caller. The Governor approves or refuses capital; it never predicts markets, holds funds, or places orders."
  },
  "payment": {
    "provider": "coinbase_business",
    "role": "payment and settlement",
    "model": "per_decision",
    "priceUsdc": "",
    "asset": "USDC",
    "network": "base",
    "mode": "auth_capture",
    "credits": true,
    "firstCall": {
      "requiredHeader": "X-Idempotency-Key (UUID v4)",
      "response": "HTTP 402 with an x402_url and checkout id"
    },
    "retry": {
      "requiredHeaders": [
        "X-Idempotency-Key",
        "X-Checkout-Id"
      ],
      "bodyRequired": false,
      "pending": "HTTP 202 while the checkout is ACTIVE or PROCESSING",
      "paid": "HTTP 200 with the stored decision once the checkout is COMPLETED"
    },
    "note": "A successful x402 authorization is not settlement. Only a COMPLETED Coinbase Business checkout releases a decision."
  },
  "discovery": {
    "manifest": "https://solarly.ai/.well-known/pe-governor.json",
    "openapi": "https://solarly.ai/pe/openapi.json",
    "llms": "https://solarly.ai/pe/llms.txt",
    "catalog": "https://solarly.ai/api/pe/v1/catalog",
    "health": "https://solarly.ai/api/pe/v1/health",
    "note": "These documents are discovery metadata published by Solarly. Coinbase Business handles payment and settlement."
  },
  "install": {
    "mode": "install_once",
    "instruction": "Install once: before approving any allocation greater than or equal to the configured install threshold, call POST /api/pe/v1/governor with the candidate set, the current portfolio state, and explicit constraints. Stop on REJECT or HOLD, and never exceed the allocationAmountUsd returned by a REDUCE.",
    "installThresholdUsd": null,
    "stopOn": [
      "REJECT",
      "HOLD"
    ],
    "neverExceed": "allocationAmountUsd"
  }
}