{
  "components": {
    "schemas": {
      "AddReconciledSetMemberRequest": {
        "description": "Request body for adding a wallet to your set.",
        "properties": {
          "wallet_address": {
            "description": "0x-prefixed 42-character hex Polygon address.",
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "AddReconciledSetMemberRequest",
        "type": "object"
      },
      "AnalyzerInterpretationRequest": {
        "description": "Inputs to an analyzer-interpretation request.\n\nAll numeric fields are optional because the analyzer can\nlegitimately emit nulls when there are too few resolved\npositions. The service picks a safe fallback when a field is\nmissing; it rejects (422) only when a field is present but\nnon-finite (NaN or +/- inf).",
        "properties": {
          "brier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average Brier score (lower is better).",
            "title": "Brier"
          },
          "concentration_pct": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Share of realized PnL from the wallet's largest event, expressed as a percentage (e.g. 42.5 for 42.5%).",
            "title": "Concentration Pct"
          },
          "conviction_percentile": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Conviction (concentration) pillar percentile, 0-100.",
            "title": "Conviction Percentile"
          },
          "discipline_percentile": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Discipline (position count) pillar percentile, 0-100.",
            "title": "Discipline Percentile"
          },
          "edge_score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Overall V3b composite, 0-100.",
            "title": "Edge Score"
          },
          "n_positions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Count of resolved unique positions.",
            "title": "N Positions"
          },
          "oversizing_kelly": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average actual size / reference Kelly fraction.",
            "title": "Oversizing Kelly"
          },
          "posture_percentile": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Posture (calibration) pillar percentile, 0-100.",
            "title": "Posture Percentile"
          },
          "total_pnl_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL in USD (positive or negative).",
            "title": "Total Pnl Usd"
          }
        },
        "title": "AnalyzerInterpretationRequest",
        "type": "object"
      },
      "AnalyzerInterpretationResponse": {
        "properties": {
          "fallback_used": {
            "title": "Fallback Used",
            "type": "boolean"
          },
          "generated_at": {
            "title": "Generated At",
            "type": "string"
          },
          "interpretation": {
            "title": "Interpretation",
            "type": "string"
          },
          "model": {
            "title": "Model",
            "type": "string"
          }
        },
        "required": [
          "interpretation",
          "model",
          "generated_at",
          "fallback_used"
        ],
        "title": "AnalyzerInterpretationResponse",
        "type": "object"
      },
      "ApiUsageResponse": {
        "description": "Current-UTC-day quota consumption for the calling key.\n\nReports the same counter the reservation path enforces, read through that\npath's own no-op branch so the number can never disagree with the gate.\nThis is the visibility half of usage metering: a caller can see\nconsumption before hitting the 429, and a dashboard can render it\nwithout scraping error responses.",
        "properties": {
          "plan": {
            "description": "Plan tier of the calling key.",
            "title": "Plan",
            "type": "string"
          },
          "usage_date": {
            "description": "UTC date (YYYY-MM-DD) the counters cover; resets at 00:00 UTC.",
            "title": "Usage Date",
            "type": "string"
          },
          "wallets_cap": {
            "description": "The key's daily reservation ceiling: the per-customer override when one is provisioned, otherwise the plan default.",
            "title": "Wallets Cap",
            "type": "integer"
          },
          "wallets_cap_published": {
            "description": "The daily wallet quota published for this plan tier, before any per-account arrangement. Equal to wallets_cap unless your account runs on a cap agreed separately, in which case wallets_cap is the one enforced. Published limits are listed at https://www.convexly.app/api-docs.",
            "title": "Wallets Cap Published",
            "type": "integer"
          },
          "wallets_remaining": {
            "description": "max(0, wallets_cap - wallets_used); 0 means further reads 429 today.",
            "title": "Wallets Remaining",
            "type": "integer"
          },
          "wallets_used": {
            "description": "Wallet reads reserved against this key's daily quota so far today, across the verdict, batch, and reconciled-read endpoints. Counts reservations, not distinct wallets: the same address re-requested is re-counted, and a rejected batch reserves nothing.",
            "title": "Wallets Used",
            "type": "integer"
          }
        },
        "required": [
          "plan",
          "usage_date",
          "wallets_used",
          "wallets_cap",
          "wallets_remaining",
          "wallets_cap_published"
        ],
        "title": "ApiUsageResponse",
        "type": "object"
      },
      "CommitForecastRequest": {
        "description": "Request body for registering a forecast commitment.",
        "properties": {
          "commitment_hash": {
            "description": "SHA-256 hex over canonical_json({'payload': payload, 'salt': salt}) per the published canonicalization rules (sorted keys, no whitespace, decimals as strings).",
            "title": "Commitment Hash",
            "type": "string"
          },
          "market_id": {
            "description": "Venue-canonical market identifier (condition_id or slug for Polymarket).",
            "maxLength": 200,
            "minLength": 1,
            "title": "Market Id",
            "type": "string"
          },
          "venue": {
            "description": "Lowercase venue slug, e.g. 'polymarket', 'kalshi', 'manifold'.",
            "title": "Venue",
            "type": "string"
          }
        },
        "required": [
          "venue",
          "market_id",
          "commitment_hash"
        ],
        "title": "CommitForecastRequest",
        "type": "object"
      },
      "CommitForecastResponse": {
        "description": "Server-timestamped commitment receipt.",
        "properties": {
          "commitment_hash": {
            "description": "The submitted hash, echoed.",
            "title": "Commitment Hash",
            "type": "string"
          },
          "commitment_id": {
            "title": "Commitment Id",
            "type": "string"
          },
          "committed_at": {
            "description": "Server-clock receipt timestamp.",
            "title": "Committed At",
            "type": "string"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "market_id": {
            "title": "Market Id",
            "type": "string"
          },
          "methodology_version": {
            "title": "Methodology Version",
            "type": "string"
          },
          "previous_row_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Chain link of the previous ledger row; null at genesis.",
            "title": "Previous Row Hash"
          },
          "receipt": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "Canonical receipt fields; receipt_hash is the SHA-256 of exactly this document's canonical serialization.",
            "title": "Receipt",
            "type": "object"
          },
          "receipt_hash": {
            "title": "Receipt Hash",
            "type": "string"
          },
          "row_hash": {
            "description": "Ledger chain link for this row.",
            "title": "Row Hash",
            "type": "string"
          },
          "venue": {
            "title": "Venue",
            "type": "string"
          }
        },
        "required": [
          "commitment_id",
          "venue",
          "market_id",
          "commitment_hash",
          "committed_at",
          "receipt",
          "receipt_hash",
          "row_hash",
          "previous_row_hash",
          "methodology_version",
          "disclaimer"
        ],
        "title": "CommitForecastResponse",
        "type": "object"
      },
      "CreateCheckoutRequest": {
        "description": "Request body for creating a Stripe Checkout session.",
        "properties": {
          "attribution": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "First-touch marketing attribution (source / utm_* / referrer), set by the client. Carried into the Stripe checkout and subscription metadata. Whitelisted and length-capped before it reaches Stripe; optional, and absent for direct or untagged sessions.",
            "title": "Attribution"
          },
          "billing_period": {
            "default": "monthly",
            "description": "Billing period: monthly or annual",
            "pattern": "^(monthly|annual)$",
            "title": "Billing Period",
            "type": "string"
          },
          "cancel_url": {
            "description": "URL to redirect if user cancels",
            "title": "Cancel Url",
            "type": "string"
          },
          "plan": {
            "description": "Target plan: researcher, trader, or enterprise (current); lite or pro accepted for legacy subscription portal flows",
            "pattern": "^(lite|pro|watchlist|researcher|trader|enterprise)$",
            "title": "Plan",
            "type": "string"
          },
          "success_url": {
            "description": "URL to redirect on successful payment",
            "title": "Success Url",
            "type": "string"
          }
        },
        "required": [
          "plan",
          "success_url",
          "cancel_url"
        ],
        "title": "CreateCheckoutRequest",
        "type": "object"
      },
      "CreateCheckoutResponse": {
        "description": "Response containing the Checkout session URL.",
        "properties": {
          "checkout_url": {
            "title": "Checkout Url",
            "type": "string"
          }
        },
        "required": [
          "checkout_url"
        ],
        "title": "CreateCheckoutResponse",
        "type": "object"
      },
      "CreateKeyRequest": {
        "description": "Request body for generating a new API key.",
        "properties": {
          "label": {
            "default": "default",
            "description": "Human-readable label",
            "maxLength": 100,
            "minLength": 1,
            "title": "Label",
            "type": "string"
          }
        },
        "title": "CreateKeyRequest",
        "type": "object"
      },
      "CreateOneTimeReadRequest": {
        "description": "Request body for the $19 one-time read of ONE named wallet.\n\nA separate model from CreateCheckoutRequest on purpose: this SKU has no\nplan, no billing period, and one field the subscription flow never has,\nwhich is the address being bought. Sharing one model would have meant a\nplan field that must be ignored and an address field that must be\nignored, on the same money path.",
        "properties": {
          "attribution": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "First-touch marketing attribution, carried into Stripe metadata exactly as the subscription checkout carries it.",
            "title": "Attribution"
          },
          "cancel_url": {
            "description": "URL to redirect if the buyer cancels",
            "title": "Cancel Url",
            "type": "string"
          },
          "locale": {
            "default": "en",
            "enum": [
              "en",
              "es",
              "pt",
              "zh-Hans",
              "zh-Hant"
            ],
            "title": "Locale",
            "type": "string"
          },
          "success_url": {
            "description": "URL to redirect on successful payment",
            "title": "Success Url",
            "type": "string"
          },
          "surface": {
            "default": "unknown",
            "enum": [
              "analyzer_result",
              "wallet_page",
              "unknown"
            ],
            "title": "Surface",
            "type": "string"
          },
          "wallet_address": {
            "description": "The single Polygon address this purchase opens.",
            "pattern": "^0x[0-9a-fA-F]{40}$",
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address",
          "success_url",
          "cancel_url"
        ],
        "title": "CreateOneTimeReadRequest",
        "type": "object"
      },
      "CreatePortalRequest": {
        "description": "Request body for creating a Customer Portal session.",
        "properties": {
          "return_url": {
            "description": "URL to redirect back to after the portal session",
            "title": "Return Url",
            "type": "string"
          }
        },
        "required": [
          "return_url"
        ],
        "title": "CreatePortalRequest",
        "type": "object"
      },
      "CreatePortalResponse": {
        "description": "Response containing the Customer Portal session URL.",
        "properties": {
          "portal_url": {
            "title": "Portal Url",
            "type": "string"
          }
        },
        "required": [
          "portal_url"
        ],
        "title": "CreatePortalResponse",
        "type": "object"
      },
      "ForecastStatusResponse": {
        "description": "Public commitment status. Payload is never present before reveal.",
        "properties": {
          "commitment_hash": {
            "title": "Commitment Hash",
            "type": "string"
          },
          "commitment_id": {
            "title": "Commitment Id",
            "type": "string"
          },
          "committed_at": {
            "title": "Committed At",
            "type": "string"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "market_id": {
            "title": "Market Id",
            "type": "string"
          },
          "methodology_version": {
            "title": "Methodology Version",
            "type": "string"
          },
          "outcome": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Outcome"
          },
          "previous_row_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous Row Hash"
          },
          "receipt_hash": {
            "title": "Receipt Hash",
            "type": "string"
          },
          "resolved_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolved At"
          },
          "reveal_failure_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reveal Failure Reason"
          },
          "reveal_valid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reveal Valid"
          },
          "revealed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revealed At"
          },
          "revealed_payload": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present only after reveal; a revealed forecast record is public by design.",
            "title": "Revealed Payload"
          },
          "row_hash": {
            "title": "Row Hash",
            "type": "string"
          },
          "status": {
            "enum": [
              "committed",
              "revealed"
            ],
            "title": "Status",
            "type": "string"
          },
          "venue": {
            "title": "Venue",
            "type": "string"
          }
        },
        "required": [
          "commitment_id",
          "status",
          "venue",
          "market_id",
          "commitment_hash",
          "committed_at",
          "receipt_hash",
          "row_hash",
          "previous_row_hash",
          "revealed_at",
          "reveal_valid",
          "reveal_failure_reason",
          "revealed_payload",
          "resolved_at",
          "outcome",
          "methodology_version",
          "disclaimer"
        ],
        "title": "ForecastStatusResponse",
        "type": "object"
      },
      "FromFeaturesRequest": {
        "description": "Inputs to a feature-based Edge Score request.",
        "properties": {
          "concentration": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "V4 conviction input: bounded [0, 1] share of the wallet's GROSS winnings from its single largest event, i.e. clip(biggest_event_pnl / total_payoff, 0, 1). Values above the cap of 1.0 are clipped. Null or negative triggers median imputation and flags `used_median_concentration`. NOTE: this is NOT the legacy net-PnL ratio biggest_event_pct_of_total.",
            "title": "Concentration"
          },
          "n_positions": {
            "description": "Count of resolved positions. Must be >= 0. Callers should independently gate display on a minimum (typically >= 5) because pillar weights were fit on >=5-position wallets.",
            "minimum": 0.0,
            "title": "N Positions",
            "type": "integer"
          },
          "skill_brier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseline Brier minus observed Brier. Positive values mean the wallet beats its own marginal frequency. Null or NaN triggers median imputation and the response flags `used_median_skill`.",
            "title": "Skill Brier"
          }
        },
        "required": [
          "n_positions"
        ],
        "title": "FromFeaturesRequest",
        "type": "object"
      },
      "FromWalletRequest": {
        "description": "Inputs to a wallet-based Edge Score request.",
        "properties": {
          "wallet_address": {
            "description": "Polymarket proxy wallet address (0x-prefixed, 42 chars).",
            "examples": [
              "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            ],
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "FromWalletRequest",
        "type": "object"
      },
      "FullHistoryRequest": {
        "description": "Request body: the wallet to run the deep full-history read on.",
        "properties": {
          "wallet_address": {
            "description": "Polymarket proxy wallet address (0x-prefixed, 42 chars).",
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "FullHistoryRequest",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "KalshiImportRequest": {
        "properties": {
          "csv_text": {
            "description": "Raw CSV text as exported from kalshi.com portfolio page. Flexible parser handles common column-name variants.",
            "maxLength": 5000000,
            "minLength": 1,
            "title": "Csv Text",
            "type": "string"
          },
          "dry_run": {
            "default": false,
            "description": "If True, parse and transform trades but skip the Supabase write. The response includes a preview list so the caller can verify the parse before committing.",
            "title": "Dry Run",
            "type": "boolean"
          }
        },
        "required": [
          "csv_text"
        ],
        "title": "KalshiImportRequest",
        "type": "object"
      },
      "KalshiImportResponse": {
        "properties": {
          "decisions_written": {
            "title": "Decisions Written",
            "type": "integer"
          },
          "dry_run": {
            "default": false,
            "title": "Dry Run",
            "type": "boolean"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "preview": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Preview",
            "type": "array"
          },
          "resolved_count": {
            "title": "Resolved Count",
            "type": "integer"
          },
          "trades_fetched": {
            "title": "Trades Fetched",
            "type": "integer"
          }
        },
        "required": [
          "trades_fetched",
          "decisions_written",
          "resolved_count",
          "message"
        ],
        "title": "KalshiImportResponse",
        "type": "object"
      },
      "KalshiResolveResponse": {
        "description": "Phase 2 response: counts from a Kalshi resolution sync run.",
        "properties": {
          "checked": {
            "title": "Checked",
            "type": "integer"
          },
          "errors": {
            "title": "Errors",
            "type": "integer"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "resolved_failure": {
            "title": "Resolved Failure",
            "type": "integer"
          },
          "resolved_success": {
            "title": "Resolved Success",
            "type": "integer"
          },
          "still_active": {
            "title": "Still Active",
            "type": "integer"
          }
        },
        "required": [
          "checked",
          "resolved_success",
          "resolved_failure",
          "still_active",
          "errors",
          "message"
        ],
        "title": "KalshiResolveResponse",
        "type": "object"
      },
      "KellyReplayRequest": {
        "description": "Request body: wallet + fractional-Kelly multipliers to simulate.",
        "properties": {
          "address": {
            "description": "Polymarket proxy wallet address (0x-prefixed, 42 chars).",
            "title": "Address",
            "type": "string"
          },
          "fractions": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Kelly fractions to simulate. Defaults to [0.25, 0.5, 1.0]. Each entry must be in (0, 2].",
            "title": "Fractions"
          }
        },
        "required": [
          "address"
        ],
        "title": "KellyReplayRequest",
        "type": "object"
      },
      "MarketIntegrityResponse": {
        "properties": {
          "canary_preview": {
            "default": true,
            "title": "Canary Preview",
            "type": "boolean"
          },
          "concentration": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Concentration"
          },
          "concentration_ex_infra": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Concentration Ex Infra"
          },
          "condition_id": {
            "title": "Condition Id",
            "type": "string"
          },
          "generated_at": {
            "title": "Generated At",
            "type": "string"
          },
          "method_hash": {
            "title": "Method Hash",
            "type": "string"
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Note"
          },
          "round_trip_churn": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Round Trip Churn"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "venue": {
            "title": "Venue",
            "type": "string"
          }
        },
        "required": [
          "condition_id",
          "venue",
          "generated_at",
          "source",
          "method_hash"
        ],
        "title": "MarketIntegrityResponse",
        "type": "object"
      },
      "NotificationPreferences": {
        "description": "User notification preference settings.",
        "properties": {
          "monthly_summary": {
            "default": true,
            "title": "Monthly Summary",
            "type": "boolean"
          },
          "review_reminders": {
            "default": true,
            "title": "Review Reminders",
            "type": "boolean"
          },
          "streak_milestones": {
            "default": true,
            "title": "Streak Milestones",
            "type": "boolean"
          },
          "weekly_digest": {
            "default": true,
            "title": "Weekly Digest",
            "type": "boolean"
          }
        },
        "title": "NotificationPreferences",
        "type": "object"
      },
      "OwnerVerification": {
        "description": "Public owner-claim status for a wallet.\n\nReflects only rows the owner explicitly made public\n(cross_venue_identities.is_public = true); private claims are never\nexposed through this API.",
        "properties": {
          "claimed": {
            "description": "A public owner-claim row exists for this wallet.",
            "title": "Claimed",
            "type": "boolean"
          },
          "verification_expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Verification expiry (90 days after verified_at).",
            "title": "Verification Expires At"
          },
          "verified": {
            "description": "The public claim is signature-verified (EIP-4361 LINKED or CERTIFIED tier) and the verification has not expired.",
            "title": "Verified",
            "type": "boolean"
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Timestamp of the verifying signature.",
            "title": "Verified At"
          }
        },
        "required": [
          "claimed",
          "verified"
        ],
        "title": "OwnerVerification",
        "type": "object"
      },
      "PolymarketConnectRequest": {
        "properties": {
          "dry_run": {
            "default": false,
            "description": "If True, fetch and transform trades but skip the Supabase write. The response includes a preview list so the caller can verify the transform against any wallet (including whale wallets they don't own) without polluting their decisions table.",
            "title": "Dry Run",
            "type": "boolean"
          },
          "label": {
            "anyOf": [
              {
                "maxLength": 100,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional human-readable label for the wallet.",
            "title": "Label"
          },
          "wallet_address": {
            "description": "42-character Polygon wallet address (0x-prefixed hex).",
            "examples": [
              "0x1234567890123456789012345678901234567890"
            ],
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "PolymarketConnectRequest",
        "type": "object"
      },
      "PolymarketConnectResponse": {
        "properties": {
          "decisions_written": {
            "title": "Decisions Written",
            "type": "integer"
          },
          "dry_run": {
            "default": false,
            "title": "Dry Run",
            "type": "boolean"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "preview": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Preview",
            "type": "array"
          },
          "resolved_count": {
            "title": "Resolved Count",
            "type": "integer"
          },
          "trades_fetched": {
            "title": "Trades Fetched",
            "type": "integer"
          },
          "wallet_address": {
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address",
          "trades_fetched",
          "decisions_written",
          "resolved_count",
          "message"
        ],
        "title": "PolymarketConnectResponse",
        "type": "object"
      },
      "PolymarketPublicPreviewRequest": {
        "properties": {
          "wallet_address": {
            "description": "42-character Polygon wallet address (0x-prefixed hex). No authentication required \u2014 this endpoint is public so unauthenticated visitors from social media links can try the product before signing up.",
            "examples": [
              "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            ],
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "PolymarketPublicPreviewRequest",
        "type": "object"
      },
      "PolymarketPublicPreviewResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "preview": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Preview",
            "type": "array"
          },
          "trades_fetched": {
            "title": "Trades Fetched",
            "type": "integer"
          },
          "wallet_address": {
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address",
          "trades_fetched",
          "message"
        ],
        "title": "PolymarketPublicPreviewResponse",
        "type": "object"
      },
      "PolymarketResolveResponse": {
        "description": "Phase 2 response: counts from a resolution sync run.",
        "properties": {
          "checked": {
            "title": "Checked",
            "type": "integer"
          },
          "errors": {
            "title": "Errors",
            "type": "integer"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "resolved_failure": {
            "title": "Resolved Failure",
            "type": "integer"
          },
          "resolved_success": {
            "title": "Resolved Success",
            "type": "integer"
          },
          "still_active": {
            "title": "Still Active",
            "type": "integer"
          }
        },
        "required": [
          "checked",
          "resolved_success",
          "resolved_failure",
          "still_active",
          "errors",
          "message"
        ],
        "title": "PolymarketResolveResponse",
        "type": "object"
      },
      "RateLimitDetail": {
        "description": "The object every limited response carries under ``detail``.\n\nOne shape for every limit on this surface, so a client writes the branch\nonce. Which limit was hit is carried by ``code``; the numbers describe that\nlimit and nothing else.",
        "properties": {
          "code": {
            "description": "Machine-readable reason. Branch on this, never on the sentence.",
            "title": "Code",
            "type": "string"
          },
          "error": {
            "description": "A sentence naming the limit that refused this call.",
            "title": "Error",
            "type": "string"
          },
          "limit": {
            "description": "The value of the limit that was reached.",
            "title": "Limit",
            "type": "integer"
          },
          "limit_unit": {
            "description": "What the limit counts, for example requests, wallet reads, or new addresses.",
            "title": "Limit Unit",
            "type": "string"
          },
          "retry_after_seconds": {
            "description": "Seconds to wait before the same call can succeed. Mirrored in the Retry-After header.",
            "title": "Retry After Seconds",
            "type": "integer"
          },
          "scope": {
            "description": "Who the limit is counted against.",
            "title": "Scope",
            "type": "string"
          },
          "window_description": {
            "description": "The same window written for a human reader.",
            "title": "Window Description",
            "type": "string"
          },
          "window_seconds": {
            "description": "Length of the window the limit applies over, in seconds. A UTC day is reported as 86400.",
            "title": "Window Seconds",
            "type": "integer"
          }
        },
        "required": [
          "error",
          "code",
          "limit",
          "limit_unit",
          "window_seconds",
          "window_description",
          "scope",
          "retry_after_seconds"
        ],
        "title": "RateLimitDetail",
        "type": "object"
      },
      "RateLimitErrorResponse": {
        "description": "The full body of a 429 on this surface.",
        "properties": {
          "detail": {
            "$ref": "#/components/schemas/RateLimitDetail"
          }
        },
        "required": [
          "detail"
        ],
        "title": "RateLimitErrorResponse",
        "type": "object"
      },
      "ReconciledReadMember": {
        "description": "The caller's membership record for the requested wallet.",
        "properties": {
          "added_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the wallet joined the set.",
            "title": "Added At"
          },
          "last_read_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When this member's most recent read completed. Null means it has never been read, which is never treated as up to date.",
            "title": "Last Read At"
          },
          "next_refresh_due_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the worker next re-reads this member.",
            "title": "Next Refresh Due At"
          },
          "read_state": {
            "description": "Where this member sits in the refresh lifecycle: queued (waiting for its turn), running (a read is in flight), ready (a read has landed), failed (the last attempt did not finish; it retries on its own schedule), or not_scoreable (TERMINAL: we could not produce a full-history read for this wallet that meets the conditions this set requires, nothing further is queued for it, and it does not consume a wallet slot). Set by the refresh worker, never by you. Any state this API does not recognize reports as queued.",
            "enum": [
              "queued",
              "running",
              "ready",
              "failed",
              "not_scoreable"
            ],
            "title": "Read State",
            "type": "string"
          },
          "refresh_days": {
            "description": "Your plan's refresh cadence in days. Staleness is derived from this plus last_read_at; it is deliberately not duplicated as a server-computed label so the rule has exactly one definition.",
            "title": "Refresh Days",
            "type": "integer"
          }
        },
        "required": [
          "read_state",
          "added_at",
          "last_read_at",
          "next_refresh_due_at",
          "refresh_days"
        ],
        "title": "ReconciledReadMember",
        "type": "object"
      },
      "ReconciledSetAddResponse": {
        "description": "Response for a successful add.",
        "properties": {
          "count": {
            "description": "Wallets in your set after this add.",
            "title": "Count",
            "type": "integer"
          },
          "limit": {
            "description": "Your plan's wallet cap at the time of this add.",
            "title": "Limit",
            "type": "integer"
          },
          "member": {
            "$ref": "#/components/schemas/ReconciledSetMember"
          }
        },
        "required": [
          "member",
          "limit",
          "count"
        ],
        "title": "ReconciledSetAddResponse",
        "type": "object"
      },
      "ReconciledSetListResponse": {
        "description": "The caller's full set, plus the plan context needed to render it.",
        "properties": {
          "can_add": {
            "description": "True when count is below limit AND total is below total_limit.",
            "title": "Can Add",
            "type": "boolean"
          },
          "count": {
            "description": "Wallets in your set that CONSUME your allowance. Since 2026-08-10 this excludes members whose read_state is not_scoreable: we cannot produce a number for them, so they do not spend a slot. Use `total` for the raw row count.",
            "title": "Count",
            "type": "integer"
          },
          "limit": {
            "description": "Your plan's wallet cap (including any entitlement override).",
            "title": "Limit",
            "type": "integer"
          },
          "members": {
            "items": {
              "$ref": "#/components/schemas/ReconciledSetMember"
            },
            "title": "Members",
            "type": "array"
          },
          "not_counted": {
            "description": "Members present but not consuming a slot (total minus count).",
            "title": "Not Counted",
            "type": "integer"
          },
          "plan": {
            "description": "Plan tier of the calling key.",
            "title": "Plan",
            "type": "string"
          },
          "refresh_days": {
            "description": "Your plan's refresh cadence in days.",
            "title": "Refresh Days",
            "type": "integer"
          },
          "rolling_window": {
            "$ref": "#/components/schemas/RollingWindow",
            "description": "The separate rate governing how fast NEW addresses may be taken on, and where you currently sit in it. Always present, so this rule can be read and paced against before an add is refused by it; its `usage` is null when your position could not be read."
          },
          "total": {
            "description": "All members, whatever their state, including not_scoreable.",
            "title": "Total",
            "type": "integer"
          },
          "total_limit": {
            "description": "The maximum number of member rows you may hold, whatever their state: twice your wallet cap. Exempting unreadable wallets from `count` would otherwise let a set accumulate them without bound, and each one costs a real chain read to diagnose.",
            "title": "Total Limit",
            "type": "integer"
          }
        },
        "required": [
          "plan",
          "limit",
          "count",
          "total",
          "not_counted",
          "total_limit",
          "can_add",
          "refresh_days",
          "rolling_window",
          "members"
        ],
        "title": "ReconciledSetListResponse",
        "type": "object"
      },
      "ReconciledSetMember": {
        "description": "One wallet in the caller's set, with its lifecycle + staleness state.",
        "properties": {
          "added_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the wallet joined your set.",
            "title": "Added At"
          },
          "last_read_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When this member's most recent read completed. Null means it has never been read, which is never treated as up to date.",
            "title": "Last Read At"
          },
          "next_refresh_due_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the worker next re-reads this member.",
            "title": "Next Refresh Due At"
          },
          "read_age_days": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Days since the last read. Null when there has never been one.",
            "title": "Read Age Days"
          },
          "read_staleness": {
            "description": "Cadence-relative freshness of last_read_at. A member that has never been read is always overdue, never fresh.",
            "enum": [
              "fresh",
              "due",
              "overdue"
            ],
            "title": "Read Staleness",
            "type": "string"
          },
          "read_state": {
            "description": "Where this member sits in the refresh lifecycle: queued (waiting for its turn), running (a read is in flight), ready (a read has landed), failed (the last attempt did not finish; it retries on its own schedule), or not_scoreable (TERMINAL: we could not produce a full-history read for this wallet that meets the conditions this set requires, nothing further is queued for it, and it does not consume a wallet slot). Set by the refresh worker, never by you.",
            "enum": [
              "queued",
              "running",
              "ready",
              "failed",
              "not_scoreable"
            ],
            "title": "Read State",
            "type": "string"
          },
          "refresh_days": {
            "description": "Your plan's refresh cadence in days.",
            "title": "Refresh Days",
            "type": "integer"
          },
          "wallet_address": {
            "description": "Normalized (lowercased) wallet address.",
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address",
          "read_state",
          "added_at",
          "last_read_at",
          "next_refresh_due_at",
          "refresh_days",
          "read_staleness",
          "read_age_days"
        ],
        "title": "ReconciledSetMember",
        "type": "object"
      },
      "ReconciledSetRemoveResponse": {
        "description": "Response for a successful removal.",
        "properties": {
          "success": {
            "title": "Success",
            "type": "boolean"
          },
          "wallet_address": {
            "description": "Normalized (lowercased) wallet address.",
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "success",
          "wallet_address"
        ],
        "title": "ReconciledSetRemoveResponse",
        "type": "object"
      },
      "ResolverBond": {
        "properties": {
          "bond_raw": {
            "description": "Exact raw units as a decimal string.",
            "pattern": "^\\d+$",
            "title": "Bond Raw",
            "type": "string"
          },
          "count": {
            "minimum": 0.0,
            "title": "Count",
            "type": "integer"
          },
          "currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Currency"
          }
        },
        "required": [
          "currency",
          "bond_raw",
          "count"
        ],
        "title": "ResolverBond",
        "type": "object"
      },
      "ResolverBonds": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ResolverBond"
            },
            "maxItems": 100,
            "title": "Items",
            "type": "array"
          },
          "known_bond_observations": {
            "description": "Observations represented in the returned bond groups; a lower bound if truncated.",
            "minimum": 0.0,
            "title": "Known Bond Observations",
            "type": "integer"
          },
          "limit": {
            "const": 100,
            "title": "Limit",
            "type": "integer"
          },
          "meaning": {
            "title": "Meaning",
            "type": "string"
          },
          "truncated": {
            "title": "Truncated",
            "type": "boolean"
          },
          "unknown_bond_observations": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Observed actions without a known bond; null when groups are truncated or the actor has no stored record. These are requirements, not capital locked or lost.",
            "title": "Unknown Bond Observations"
          }
        },
        "required": [
          "items",
          "truncated",
          "limit",
          "meaning",
          "known_bond_observations",
          "unknown_bond_observations"
        ],
        "title": "ResolverBonds",
        "type": "object"
      },
      "ResolverComparison": {
        "properties": {
          "actor": {
            "$ref": "#/components/schemas/ResolverRecord"
          },
          "other_actors": {
            "$ref": "#/components/schemas/ResolverRecord",
            "description": "Other observed actors on this requester route, excluding the selected actor."
          },
          "requester": {
            "title": "Requester",
            "type": "string"
          },
          "status": {
            "enum": [
              "ready",
              "initializing"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "requester",
          "actor",
          "other_actors",
          "status"
        ],
        "title": "ResolverComparison",
        "type": "object"
      },
      "ResolverCounts": {
        "properties": {
          "agreement": {
            "minimum": 0.0,
            "title": "Agreement",
            "type": "integer"
          },
          "comparable_settlement": {
            "minimum": 0.0,
            "title": "Comparable Settlement",
            "type": "integer"
          },
          "disagreement": {
            "minimum": 0.0,
            "title": "Disagreement",
            "type": "integer"
          },
          "disputed_agreement": {
            "minimum": 0.0,
            "title": "Disputed Agreement",
            "type": "integer"
          },
          "disputed_comparable_settlement": {
            "minimum": 0.0,
            "title": "Disputed Comparable Settlement",
            "type": "integer"
          },
          "disputed_disagreement": {
            "minimum": 0.0,
            "title": "Disputed Disagreement",
            "type": "integer"
          },
          "disputes_received": {
            "minimum": 0.0,
            "title": "Disputes Received",
            "type": "integer"
          },
          "observed_dispute": {
            "minimum": 0.0,
            "title": "Observed Dispute",
            "type": "integer"
          },
          "observed_proposal": {
            "minimum": 0.0,
            "title": "Observed Proposal",
            "type": "integer"
          },
          "settled_disputes_received": {
            "minimum": 0.0,
            "title": "Settled Disputes Received",
            "type": "integer"
          },
          "settled_proposal": {
            "description": "Settled observed proposals with adequate dispute-status receipts.",
            "minimum": 0.0,
            "title": "Settled Proposal",
            "type": "integer"
          },
          "tie_or_invalid": {
            "minimum": 0.0,
            "title": "Tie Or Invalid",
            "type": "integer"
          },
          "undisputed_agreement": {
            "description": "Mechanical agreement on undisputed settlements, not independent validation.",
            "minimum": 0.0,
            "title": "Undisputed Agreement",
            "type": "integer"
          },
          "undisputed_comparable_settlement": {
            "minimum": 0.0,
            "title": "Undisputed Comparable Settlement",
            "type": "integer"
          },
          "unsettled": {
            "minimum": 0.0,
            "title": "Unsettled",
            "type": "integer"
          }
        },
        "required": [
          "observed_proposal",
          "observed_dispute",
          "disputes_received",
          "settled_proposal",
          "settled_disputes_received",
          "comparable_settlement",
          "agreement",
          "disagreement",
          "tie_or_invalid",
          "unsettled",
          "disputed_comparable_settlement",
          "disputed_agreement",
          "disputed_disagreement",
          "undisputed_comparable_settlement",
          "undisputed_agreement"
        ],
        "title": "ResolverCounts",
        "type": "object"
      },
      "ResolverCoverage": {
        "properties": {
          "all_actor_history": {
            "const": false,
            "title": "All Actor History",
            "type": "boolean"
          },
          "observed_through_block": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Slowest discovery cursor, not a strict maximum event block. Full captured histories of questions discovered in the stated ranges may extend beyond this block.",
            "title": "Observed Through Block"
          },
          "scope_description": {
            "title": "Scope Description",
            "type": "string"
          },
          "sources": {
            "items": {
              "$ref": "#/components/schemas/ResolverSourceProgress"
            },
            "title": "Sources",
            "type": "array"
          },
          "status": {
            "enum": [
              "ready",
              "initializing"
            ],
            "title": "Status",
            "type": "string"
          },
          "store_excluded_evidence_records": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Store-wide excluded evidence records, not unique questions and not an exclusion count for this actor. Actor attribution may be unknown.",
            "title": "Store Excluded Evidence Records"
          }
        },
        "required": [
          "status",
          "observed_through_block",
          "sources",
          "scope_description",
          "all_actor_history",
          "store_excluded_evidence_records"
        ],
        "title": "ResolverCoverage",
        "type": "object"
      },
      "ResolverEvent": {
        "properties": {
          "action_block": {
            "minimum": 0.0,
            "title": "Action Block",
            "type": "integer"
          },
          "action_timestamp": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix time in seconds, when captured.",
            "title": "Action Timestamp"
          },
          "address": {
            "title": "Address",
            "type": "string"
          },
          "bond_raw": {
            "anyOf": [
              {
                "pattern": "^\\d+$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exact raw currency units.",
            "title": "Bond Raw"
          },
          "bond_receipt": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResolverReceipt"
              },
              {
                "type": "null"
              }
            ]
          },
          "bond_source": {
            "anyOf": [
              {
                "const": "QuestionInitialized",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bond Source"
          },
          "currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Currency"
          },
          "evidence": {
            "$ref": "#/components/schemas/ResolverEvidence"
          },
          "history_position": {
            "description": "Opaque ordering value; paginate with next_cursor.",
            "title": "History Position",
            "type": "string"
          },
          "log_index": {
            "minimum": 0.0,
            "title": "Log Index",
            "type": "integer"
          },
          "method_version": {
            "const": "resolver_record_v1",
            "title": "Method Version",
            "type": "string"
          },
          "observation_key": {
            "title": "Observation Key",
            "type": "string"
          },
          "onchain_id": {
            "title": "Onchain Id",
            "type": "string"
          },
          "oracle_address": {
            "title": "Oracle Address",
            "type": "string"
          },
          "proposed_price": {
            "anyOf": [
              {
                "pattern": "^-?\\d+$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exact raw price units.",
            "title": "Proposed Price"
          },
          "question_id": {
            "title": "Question Id",
            "type": "string"
          },
          "requester": {
            "title": "Requester",
            "type": "string"
          },
          "role": {
            "enum": [
              "proposer",
              "disputer"
            ],
            "title": "Role",
            "type": "string"
          },
          "round_key": {
            "title": "Round Key",
            "type": "string"
          },
          "settled_block": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Settled Block"
          },
          "settled_price": {
            "anyOf": [
              {
                "pattern": "^-?\\d+$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Exact raw price units.",
            "title": "Settled Price"
          },
          "source": {
            "enum": [
              "ProposePrice",
              "DisputePrice"
            ],
            "title": "Source",
            "type": "string"
          },
          "tx_hash": {
            "title": "Tx Hash",
            "type": "string"
          }
        },
        "required": [
          "method_version",
          "observation_key",
          "address",
          "role",
          "question_id",
          "round_key",
          "requester",
          "oracle_address",
          "action_block",
          "action_timestamp",
          "settled_block",
          "tx_hash",
          "log_index",
          "onchain_id",
          "proposed_price",
          "settled_price",
          "currency",
          "bond_raw",
          "bond_source",
          "bond_receipt",
          "evidence",
          "history_position",
          "source"
        ],
        "title": "ResolverEvent",
        "type": "object"
      },
      "ResolverEventsResponse": {
        "properties": {
          "address": {
            "title": "Address",
            "type": "string"
          },
          "coverage": {
            "$ref": "#/components/schemas/ResolverCoverage"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ResolverEvent"
            },
            "maxItems": 50,
            "title": "Events",
            "type": "array"
          },
          "generation": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Record revision. Combine summary and history only when generations match; refresh both if either changes. Null means initialization has not produced a revision.",
            "title": "Generation"
          },
          "has_more": {
            "title": "Has More",
            "type": "boolean"
          },
          "limit": {
            "maximum": 50.0,
            "minimum": 1.0,
            "title": "Limit",
            "type": "integer"
          },
          "method_version": {
            "const": "resolver_record_v1",
            "title": "Method Version",
            "type": "string"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Opaque continuation token bound to address, role and generation. If has_more is true but no cursor is available, continuation is unavailable; do not treat that as the end of the history.",
            "title": "Next Cursor"
          },
          "role": {
            "enum": [
              "proposer",
              "disputer"
            ],
            "title": "Role",
            "type": "string"
          },
          "scope": {
            "const": "current_retrospective",
            "description": "Full captured histories of questions touched in the declared discovery ranges, as of this read. May include the selected question; not a prior track record or all actor history.",
            "title": "Scope",
            "type": "string"
          },
          "status": {
            "enum": [
              "ready",
              "initializing"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "method_version",
          "generation",
          "scope",
          "address",
          "role",
          "coverage",
          "status",
          "events",
          "limit",
          "has_more",
          "next_cursor"
        ],
        "title": "ResolverEventsResponse",
        "type": "object"
      },
      "ResolverEvidence": {
        "properties": {
          "dispute": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResolverReceipt"
              },
              {
                "type": "null"
              }
            ]
          },
          "proposal": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResolverReceipt"
              },
              {
                "type": "null"
              }
            ]
          },
          "settlement": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResolverReceipt"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "ResolverEvidence",
        "type": "object"
      },
      "ResolverRate": {
        "description": "Observed proportion with a 95% Wilson interval, all scaled per 10,000.\n\nThe estimate and both bounds are null when the denominator is below 20 or\nsource coverage is incomplete. Counts remain available in either case.\nThese descriptive rates do not establish accuracy, skill or safety.",
        "properties": {
          "denominator": {
            "minimum": 0.0,
            "title": "Denominator",
            "type": "integer"
          },
          "numerator": {
            "minimum": 0.0,
            "title": "Numerator",
            "type": "integer"
          },
          "per_10000": {
            "anyOf": [
              {
                "maximum": 10000.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Per 10000"
          },
          "status": {
            "enum": [
              "ok",
              "insufficient_history",
              "coverage_incomplete"
            ],
            "title": "Status",
            "type": "string"
          },
          "wilson95_high": {
            "anyOf": [
              {
                "maximum": 10000.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Upper bound per 10,000.",
            "title": "Wilson95 High"
          },
          "wilson95_low": {
            "anyOf": [
              {
                "maximum": 10000.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lower bound per 10,000.",
            "title": "Wilson95 Low"
          }
        },
        "required": [
          "numerator",
          "denominator",
          "per_10000",
          "wilson95_low",
          "wilson95_high",
          "status"
        ],
        "title": "ResolverRate",
        "type": "object"
      },
      "ResolverRates": {
        "properties": {
          "disputed_settlement_agreement": {
            "$ref": "#/components/schemas/ResolverRate",
            "description": "Agreement between the challenged proposal and its same-round settlement, among comparable disputed rounds. This is not disputer correctness or a win rate."
          },
          "disputes_received": {
            "$ref": "#/components/schemas/ResolverRate",
            "description": "Challenges among settled observed proposals with adequate receipts. Excludes pending disputes; not a rate over all proposals. Not applicable to disputer roles."
          }
        },
        "required": [
          "disputes_received",
          "disputed_settlement_agreement"
        ],
        "title": "ResolverRates",
        "type": "object"
      },
      "ResolverReceipt": {
        "properties": {
          "block_number": {
            "minimum": 0.0,
            "title": "Block Number",
            "type": "integer"
          },
          "log_index": {
            "minimum": 0.0,
            "title": "Log Index",
            "type": "integer"
          },
          "onchain_id": {
            "title": "Onchain Id",
            "type": "string"
          },
          "tx_hash": {
            "title": "Tx Hash",
            "type": "string"
          }
        },
        "required": [
          "onchain_id",
          "tx_hash",
          "log_index",
          "block_number"
        ],
        "title": "ResolverReceipt",
        "type": "object"
      },
      "ResolverRecord": {
        "properties": {
          "counts": {
            "$ref": "#/components/schemas/ResolverCounts"
          },
          "rates": {
            "$ref": "#/components/schemas/ResolverRates"
          }
        },
        "required": [
          "counts",
          "rates"
        ],
        "title": "ResolverRecord",
        "type": "object"
      },
      "ResolverRecordResponse": {
        "properties": {
          "address": {
            "title": "Address",
            "type": "string"
          },
          "bonds": {
            "$ref": "#/components/schemas/ResolverBonds"
          },
          "comparisons": {
            "items": {
              "$ref": "#/components/schemas/ResolverComparison"
            },
            "title": "Comparisons",
            "type": "array"
          },
          "coverage": {
            "$ref": "#/components/schemas/ResolverCoverage"
          },
          "generation": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Record revision. Combine summary and history only when generations match; refresh both if either changes. Null means initialization has not produced a revision.",
            "title": "Generation"
          },
          "method_version": {
            "const": "resolver_record_v1",
            "title": "Method Version",
            "type": "string"
          },
          "record": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResolverRecord"
              },
              {
                "type": "null"
              }
            ],
            "description": "Null means no stored actor record; absence is not proof of zero activity. Counts can be shown during initialization, but all rates remain withheld."
          },
          "role": {
            "enum": [
              "proposer",
              "disputer"
            ],
            "title": "Role",
            "type": "string"
          },
          "scope": {
            "const": "current_retrospective",
            "description": "Full captured histories of questions touched in the declared discovery ranges, as of this read. May include the selected question; not a prior track record or all actor history.",
            "title": "Scope",
            "type": "string"
          },
          "status": {
            "enum": [
              "ready",
              "initializing",
              "absent"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "method_version",
          "generation",
          "scope",
          "address",
          "role",
          "coverage",
          "status",
          "record",
          "comparisons",
          "bonds"
        ],
        "title": "ResolverRecordResponse",
        "type": "object"
      },
      "ResolverSourceProgress": {
        "properties": {
          "from_block": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Block"
          },
          "observed_through_block": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed Through Block"
          },
          "raw_through_block": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Raw Through Block"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "title": "Reasons",
            "type": "array"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "status": {
            "enum": [
              "ready",
              "initializing"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "source",
          "from_block",
          "observed_through_block",
          "raw_through_block",
          "status",
          "reasons"
        ],
        "title": "ResolverSourceProgress",
        "type": "object"
      },
      "RevealForecastRequest": {
        "description": "Request body for revealing a committed forecast.",
        "properties": {
          "payload": {
            "additionalProperties": true,
            "description": "The exact forecast payload that was hashed at commit time. Required fields: venue, market_id, probability (decimal string in [0, 1]). Extra disclosure fields are preserved.",
            "title": "Payload",
            "type": "object"
          },
          "salt": {
            "description": "The client salt used at commit time (min 16 chars).",
            "maxLength": 128,
            "minLength": 16,
            "title": "Salt",
            "type": "string"
          }
        },
        "required": [
          "payload",
          "salt"
        ],
        "title": "RevealForecastRequest",
        "type": "object"
      },
      "RevealForecastResponse": {
        "description": "Reveal verdict: hash recomputation result.",
        "properties": {
          "commitment_hash": {
            "title": "Commitment Hash",
            "type": "string"
          },
          "commitment_id": {
            "title": "Commitment Id",
            "type": "string"
          },
          "committed_at": {
            "title": "Committed At",
            "type": "string"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "methodology_version": {
            "title": "Methodology Version",
            "type": "string"
          },
          "recomputed_hash": {
            "title": "Recomputed Hash",
            "type": "string"
          },
          "reveal_failure_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reveal Failure Reason"
          },
          "reveal_valid": {
            "title": "Reveal Valid",
            "type": "boolean"
          },
          "revealed_at": {
            "title": "Revealed At",
            "type": "string"
          },
          "status": {
            "const": "revealed",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "commitment_id",
          "status",
          "reveal_valid",
          "reveal_failure_reason",
          "commitment_hash",
          "recomputed_hash",
          "committed_at",
          "revealed_at",
          "methodology_version",
          "disclaimer"
        ],
        "title": "RevealForecastResponse",
        "type": "object"
      },
      "RollingWindow": {
        "description": "The rate at which NEW addresses may be taken on, and this account's\nposition in it.\n\nA different bound from the wallet cap. The cap limits how many wallets are\nkept current at once and is reported by `limit` and `count`; this limits\nhow fast new ones are taken on, because an address never read before costs\na complete on-chain walk. Removing a wallet is free and immediate against\nboth, and re-adding an address this account has held before draws on\nneither.",
        "properties": {
          "allowance": {
            "description": "Distinct new addresses admitted per window. Resolved for this account when `usage` is present; resolved from the plan tier alone when `usage` is null, which can differ from the enforced figure where a bespoke rate applies.",
            "title": "Allowance",
            "type": "integer"
          },
          "usage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RollingWindowUsage"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position in the window, or null when it could not be read. Null means UNKNOWN, never a full allowance and never a spent one: the rule above still stands and adds are still enforced against it."
          },
          "window_days": {
            "description": "Length of the trailing window, in days.",
            "title": "Window Days",
            "type": "integer"
          }
        },
        "required": [
          "window_days",
          "allowance",
          "usage"
        ],
        "title": "RollingWindow",
        "type": "object"
      },
      "RollingWindowUsage": {
        "description": "Where this account currently sits inside its rolling allowance.",
        "properties": {
          "first_fill_remaining": {
            "description": "Distinct addresses that can still be added before the allowance binds at all. While this is above zero the rate is not in force, because the account is still filling the set its plan covers, and `remaining` describes a rule that is not yet applying. Reported by the database, never derived from the other counts: whether an add consumed one of these turns on facts about the address that no other field here carries.",
            "title": "First Fill Remaining",
            "type": "integer"
          },
          "remaining": {
            "description": "New addresses that can still be taken on before an add is refused with `wallet_set_window_limit_reached`. Never negative. Not a statement about any particular address: re-adding one this account has held before is exempt and costs none of this.",
            "title": "Remaining",
            "type": "integer"
          },
          "resets_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the oldest add counted against the window ages out and one unit of `remaining` returns. Null when nothing is currently counted against the window.",
            "title": "Resets At"
          },
          "used": {
            "description": "Distinct new addresses taken on inside the trailing window. May exceed `allowance` after a plan change that lowered the rate; `remaining` is zero in that case and never negative.",
            "title": "Used",
            "type": "integer"
          }
        },
        "required": [
          "used",
          "remaining",
          "first_fill_remaining",
          "resets_at"
        ],
        "title": "RollingWindowUsage",
        "type": "object"
      },
      "SetEntitlementRequest": {
        "description": "Stamp a per-customer entitlement override.\n\nAll three numeric caps are REQUIRED: a NULL cap floors to the researcher\nlevel at read time, so an omitted cap would silently under-provision.\nRequiring all three turns a missing field into a rejected request rather\nthan a wrong cap.",
        "properties": {
          "batch_cap": {
            "description": "Per-batch distinct-wallet cap.",
            "minimum": 0.0,
            "title": "Batch Cap",
            "type": "integer"
          },
          "daily_verdict_quota": {
            "description": "Per-UTC-day wallet-verdict quota override.",
            "minimum": 0.0,
            "title": "Daily Verdict Quota",
            "type": "integer"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deal reference.",
            "title": "Notes"
          },
          "package": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Display/audit label.",
            "title": "Package"
          },
          "rescore_cadence": {
            "default": "monthly",
            "description": "Only 'monthly' is deliverable today.",
            "title": "Rescore Cadence",
            "type": "string"
          },
          "user_id": {
            "description": "Customer's auth.users id.",
            "title": "User Id",
            "type": "string"
          },
          "wallet_cap": {
            "description": "Watchlist breadth override.",
            "minimum": 0.0,
            "title": "Wallet Cap",
            "type": "integer"
          }
        },
        "required": [
          "user_id",
          "wallet_cap",
          "daily_verdict_quota",
          "batch_cap"
        ],
        "title": "SetEntitlementRequest",
        "type": "object"
      },
      "SubscriptionResponse": {
        "description": "Current subscription information.",
        "properties": {
          "cancel_at_period_end": {
            "default": false,
            "title": "Cancel At Period End",
            "type": "boolean"
          },
          "current_period_end": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period End"
          },
          "plan": {
            "title": "Plan",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "subscription_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subscription Id"
          }
        },
        "required": [
          "plan",
          "status"
        ],
        "title": "SubscriptionResponse",
        "type": "object"
      },
      "SyncSubscriptionResponse": {
        "description": "Result of the self-healing subscription sync (2026-06-10).",
        "properties": {
          "plan": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plan"
          },
          "subscription_status": {
            "title": "Subscription Status",
            "type": "string"
          },
          "synced": {
            "title": "Synced",
            "type": "boolean"
          }
        },
        "required": [
          "synced",
          "plan",
          "subscription_status"
        ],
        "title": "SyncSubscriptionResponse",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      },
      "WalletAnalysisFeatures": {
        "description": "Inputs lifted from the Polymarket wallet analyzer response.\n\nThe analyzer already computes everything we need to build a rough\nforward simulation: the wallet's historical category win rate is a\nproxy for per-position probability; n_unique_positions is the portfolio\nbreadth; total_risked is the starting bankroll; kelly_sizing efficiency\nis the oversizing multiplier applied to each decision's payoff spread.\n\nClients (the analyzer page) should post the fields they have. Missing\nor invalid fields get safe defaults so the simulation still runs.",
        "properties": {
          "address": {
            "description": "Polymarket wallet address (0x-prefixed).",
            "title": "Address",
            "type": "string"
          },
          "avg_stake_pct": {
            "anyOf": [
              {
                "maximum": 1.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Mean fraction of bankroll per position.",
            "title": "Avg Stake Pct"
          },
          "concentration": {
            "anyOf": [
              {
                "maximum": 1.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Biggest event pct-of-total. Drives tail risk.",
            "title": "Concentration"
          },
          "kelly_sizing_efficiency": {
            "anyOf": [
              {
                "maximum": 10.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "actual_fraction / kelly_fraction ratio.",
            "title": "Kelly Sizing Efficiency"
          },
          "n_iterations": {
            "default": 10000,
            "maximum": 100000.0,
            "minimum": 1000.0,
            "title": "N Iterations",
            "type": "integer"
          },
          "n_unique_positions": {
            "anyOf": [
              {
                "maximum": 100.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Deduped positions used to size the portfolio.",
            "title": "N Unique Positions"
          },
          "seed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seed"
          },
          "skill_brier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Baseline - actual Brier. Positive = skilled.",
            "title": "Skill Brier"
          },
          "total_risked": {
            "anyOf": [
              {
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total USD risked across resolved history.",
            "title": "Total Risked"
          },
          "win_rate": {
            "anyOf": [
              {
                "maximum": 1.0,
                "minimum": 0.0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized win rate across resolved positions.",
            "title": "Win Rate"
          }
        },
        "required": [
          "address"
        ],
        "title": "WalletAnalysisFeatures",
        "type": "object"
      },
      "WalletAnalysisRequest": {
        "description": "Request body: just the wallet address.",
        "properties": {
          "source_surface": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Client surface that initiated the analysis, for funnel analytics.",
            "title": "Source Surface"
          },
          "traffic_audience": {
            "default": "unclassified",
            "maxLength": 32,
            "title": "Traffic Audience",
            "type": "string"
          },
          "utm_campaign": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Utm Campaign"
          },
          "utm_medium": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Utm Medium"
          },
          "utm_source": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Utm Source"
          },
          "visitor_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Visitor Id"
          },
          "wallet_address": {
            "description": "Polymarket proxy wallet address (0x-prefixed, 42 chars).",
            "examples": [
              "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
            ],
            "title": "Wallet Address",
            "type": "string"
          }
        },
        "required": [
          "wallet_address"
        ],
        "title": "WalletAnalysisRequest",
        "type": "object"
      },
      "WalletProofOfRecordResponse": {
        "description": "The portable record object for a wallet in the caller's set, or the\nexplicit withheld state naming the gate that stopped issuance.\n\nClaim guardrails, identical to the sibling read endpoints: the estimate\nonly ever appears inside a record that also carries its 95% interval and\nBOTH denominators; the ``edge_disclosure`` string restates them in one\nsentence; the disclaimer is fixed. When ``issued`` is false there is no\nrecord, no hash, and no number of any kind.",
        "properties": {
          "address": {
            "description": "Normalized (lowercased) wallet address.",
            "title": "Address",
            "type": "string"
          },
          "completeness_proof": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Verbatim echo of the read's chain-anchored proof block (see the reconciled-read endpoint). Packaging, not a verdict.",
            "title": "Completeness Proof"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "edge_disclosure": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The estimate, its 95% interval, and both denominators in one sentence. The record never travels as a bare number.",
            "title": "Edge Disclosure"
          },
          "generated_at": {
            "description": "When this object was generated (UTC ISO). The object's own as-of, alongside reconciled_at_block; neither stands in for the other.",
            "title": "Generated At",
            "type": "string"
          },
          "issued": {
            "description": "True only when every issuance gate passed and a record object was built. False carries withheld_gate + withheld_detail and no numbers.",
            "title": "Issued",
            "type": "boolean"
          },
          "member": {
            "$ref": "#/components/schemas/ReconciledReadMember"
          },
          "method_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Hash of the frozen methodology the record was computed and gated under, same value the promotion gate enforces. Pin it to detect method changes between objects.",
            "title": "Method Version"
          },
          "reconciled_at_block": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The Polygon block the record's completeness was checked against; the starting point of the chain check in verification. Null when issued is false, never 0.",
            "title": "Reconciled At Block"
          },
          "record": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "The exact field set the record hash covers: address, reconciled_at_block, reconciled_as_of, method_version, realized_edge, realized_edge_ci_bca, realized_edge_n, n_resolved_complete, n_priced, n_unpriced. Recompute the hash from this object with the served recipe; it must equal record_hash.",
            "title": "Record"
          },
          "record_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "sha256:<hex> over the canonical JSON serialization of record (key-sorted, compact separators). Content-addresses this record so a copy can be checked for tampering offline.",
            "title": "Record Hash"
          },
          "verification": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Copyable third-party checks: chain_check_command (one curl against any Polygon archive RPC; empty results in both halves mean the address moved no outcome token after reconciled_at_block) and record_hash_recipe (recompute the hash from the served record with stdlib Python).",
            "title": "Verification"
          },
          "withheld_detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixed prose for the failing gate. Null when issued.",
            "title": "Withheld Detail"
          },
          "withheld_gate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The FIRST failing issuance gate, in the payload's own vocabulary (e.g. not_reconciled, windowed, record_moved, chain_stale, pricing_insufficient). Null when issued. 'record_moved' is the one to expect on an active address: the read itself is served bounded by the reconciled-read and verdict endpoints, and only the portable object is withheld, because an object is copied and checked long after the request and carries no field a bound could travel in.",
            "title": "Withheld Gate"
          }
        },
        "required": [
          "address",
          "issued",
          "member",
          "generated_at",
          "disclaimer"
        ],
        "title": "WalletProofOfRecordResponse",
        "type": "object"
      },
      "WalletReconciledReadResponse": {
        "description": "On-chain-reconciled full-history read, or the honest unavailable state.\n\nClaim guardrails, identical to the verdict payload's: ``realized_edge`` is\nnever present without ``realized_edge_ci_bca``, the sub-sample bound\ntravels in the SAME string as the estimate (``edge_disclosure``, built by\nthe one shared formatter), and the disclaimer is fixed. When ``available``\nis false EVERY estimate field is null: a partial or windowed number is\nnever returned in place of a complete read.",
        "properties": {
          "address": {
            "description": "Normalized (lowercased) wallet address.",
            "title": "Address",
            "type": "string"
          },
          "available": {
            "description": "True only when a complete on-chain-reconciled read served.",
            "title": "Available",
            "type": "boolean"
          },
          "bound": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "What this read covers, as one sentence you can print beside any number in it: 'through block N (walked T)', followed on a moved read by the sentence naming the movement. One string on purpose, so a consumer that renders it cannot keep the block and drop the movement. The same wording convexly.app/w renders for the same read. Null when available is false, and null on the fail-closed case of a served read whose block could not be read back.",
            "title": "Bound"
          },
          "completeness_proof": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Chain-anchored completeness proof for this read: the basis, the reconciliation block and timestamp, the serve-time answer to whether the address moved an outcome token since that block, whether the read proved itself complete, and a verification instruction you can run against Polygon yourself. It echoes stamps this response already carries; the block of fields is packaging, not a verdict, and it is null when available is false.",
            "title": "Completeness Proof"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "edge_disclosure": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The edge, its 95% interval, and BOTH denominators (priced of complete resolved, plus the un-priceable remainder) in one string, followed on a moved read by the block the figure holds through. The record never travels as a bare number, and since 2026-09-05 it never travels without its bound either.",
            "title": "Edge Disclosure"
          },
          "member": {
            "$ref": "#/components/schemas/ReconciledReadMember"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present when available is false.",
            "title": "Message"
          },
          "method_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Hash of the frozen methodology this read was computed and gated under; the promotion gate checks the same value. Pin it to detect method changes between reads. Null when available is false.",
            "title": "Method Hash"
          },
          "moved_since_block": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The chain's serve-time answer to whether this address moved an outcome token after reconciled_at_block. False means it did not, so the read covers the record up to that block and nothing has happened since. True means it did, so the read is served bounded to that block and positions taken after it are not in these counts; the read is not withheld for it, because a walk takes longer than an active address's gap between trades and a read of such an address would otherwise never be servable. Null when available is false. It is never absent on a served read: a payload whose bound cannot be established is reported unavailable rather than served without one.",
            "title": "Moved Since Block"
          },
          "n_priced": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Positions priced at their own entry fills.",
            "title": "N Priced"
          },
          "n_resolved_complete": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Markets resolved to completion.",
            "title": "N Resolved Complete"
          },
          "n_unpriced": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Positions counted but not priced (no entry price was recovered for them in this read).",
            "title": "N Unpriced"
          },
          "realized_edge": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized edge per priced position, on the probability scale. Never returned without realized_edge_ci_bca.",
            "title": "Realized Edge"
          },
          "realized_edge_ci_bca": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Event-clustered BCa 95% interval [lo, hi], paired with the edge.",
            "title": "Realized Edge Ci Bca"
          },
          "receipt_available": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether GET /v1/wallets/{address}/proof-of-record would issue the portable, hash-addressed record object for THIS read, answered by that endpoint's own builder rather than restated from it. False most often because the address has moved an outcome token since the block (see moved_since_block): the read is still served, bounded, but a durable artifact has nowhere to carry a bound, so the object is withheld. Read receipt_note for the reason in words. Null when no read is served.",
            "title": "Receipt Available"
          },
          "receipt_note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Why the proof-of-record object is withheld for this read, in the same sentence convexly.app shows beside its receipt link. Null when receipt_available is true, and null when no read is served.",
            "title": "Receipt Note"
          },
          "reconciled_as_of": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the reconciliation proof was taken.",
            "title": "Reconciled As Of"
          },
          "reconciled_at_block": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The Polygon block this read's completeness was checked against: at that block the reconstructed record matched the wallet's on-chain settlement history in full. It exists so you can check currency yourself instead of taking it on trust: ask the chain whether this address moved an outcome token after this block, and if it did, the read no longer covers the whole record. It does NOT say the read is current now; it says where an independent currency check must start. Null when available is false, never 0.",
            "title": "Reconciled At Block"
          },
          "state": {
            "anyOf": [
              {
                "enum": [
                  "skilled",
                  "luck",
                  "insufficient",
                  "flagged"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Four-state read of the resolved record.",
            "title": "State"
          },
          "state_definition": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixed definition of the returned state.",
            "title": "State Definition"
          },
          "styles": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Descriptive style tags for HOW the edge is earned (arbitrage, concentrated, favorite_tilt, directional). Labels, never gates: a structural style does not demote the state, it discloses it.",
            "title": "Styles"
          },
          "unavailable_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "'not_reconciled' when no complete read has landed for this wallet; 'bound_unknown' when one has landed but the chain answer that bounds it could not be read; 'record_moved' when one has landed, the address has moved outcome tokens since the block it covers, and that block itself could not be read, so there is nothing to pin the read to. A moved read WITH a readable block is served, bounded: see moved_since_block.",
            "title": "Unavailable Reason"
          }
        },
        "required": [
          "address",
          "available",
          "member",
          "disclaimer"
        ],
        "title": "WalletReconciledReadResponse",
        "type": "object"
      },
      "WalletScreenResponse": {
        "description": "Matches, plus the denominator they were drawn from.\n\n`screened` is the field that makes the rest interpretable. There are two\nwallet universes and they are not the same: the wallets Convexly has READ,\nand every wallet on the venue. This endpoint can only filter the first, so\nit publishes how many wallets the filter actually ran over. Without it, \"0\nmatches\" reads as a fact about the market rather than about our coverage.",
        "properties": {
          "has_more": {
            "title": "Has More",
            "type": "boolean"
          },
          "matched": {
            "description": "Wallets that matched, before the page cut.",
            "title": "Matched",
            "type": "integer"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pass as `after_wallet` for the next page.",
            "title": "Next Cursor"
          },
          "rows": {
            "items": {
              "$ref": "#/components/schemas/WalletScreenRow"
            },
            "title": "Rows",
            "type": "array"
          },
          "screened": {
            "description": "Wallets this filter ran over. The denominator, including wallets the filters excluded. NOT a count of every wallet that exists.",
            "title": "Screened",
            "type": "integer"
          },
          "universe": {
            "description": "What `screened` is a denominator of, in words.",
            "title": "Universe",
            "type": "string"
          }
        },
        "required": [
          "rows",
          "screened",
          "matched",
          "has_more",
          "universe"
        ],
        "title": "WalletScreenResponse",
        "type": "object"
      },
      "WalletScreenRow": {
        "description": "One matching wallet, carrying the same certification shape as the screen.",
        "properties": {
          "certification": {
            "additionalProperties": true,
            "title": "Certification",
            "type": "object"
          },
          "wallet": {
            "title": "Wallet",
            "type": "string"
          }
        },
        "required": [
          "wallet",
          "certification"
        ],
        "title": "WalletScreenRow",
        "type": "object"
      },
      "WalletVerdictBatchItem": {
        "description": "One address's result inside a batch response.",
        "properties": {
          "address": {
            "title": "Address",
            "type": "string"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present when ok is false.",
            "title": "Error"
          },
          "ok": {
            "description": "True when a verdict was computed.",
            "title": "Ok",
            "type": "boolean"
          },
          "verdict": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WalletVerdictResponse"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "address",
          "ok"
        ],
        "title": "WalletVerdictBatchItem",
        "type": "object"
      },
      "WalletVerdictBatchRequest": {
        "description": "Request body for the batch verdict endpoint.",
        "properties": {
          "addresses": {
            "description": "Wallet addresses to score (0x + 40 hex). Deduplicated; the number of DISTINCT addresses must not exceed your plan's per-batch cap.",
            "items": {
              "type": "string"
            },
            "maxItems": 250,
            "minItems": 1,
            "title": "Addresses",
            "type": "array"
          }
        },
        "required": [
          "addresses"
        ],
        "title": "WalletVerdictBatchRequest",
        "type": "object"
      },
      "WalletVerdictBatchResponse": {
        "description": "Batch verdict response: one item per distinct requested address.",
        "properties": {
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "max_for_plan": {
            "description": "Per-batch distinct-address cap for this plan.",
            "title": "Max For Plan",
            "type": "integer"
          },
          "plan": {
            "description": "Plan tier of the calling key.",
            "title": "Plan",
            "type": "string"
          },
          "requested": {
            "description": "Distinct addresses requested.",
            "title": "Requested",
            "type": "integer"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/WalletVerdictBatchItem"
            },
            "title": "Results",
            "type": "array"
          },
          "returned": {
            "description": "Addresses with a computed verdict.",
            "title": "Returned",
            "type": "integer"
          }
        },
        "required": [
          "requested",
          "returned",
          "plan",
          "max_for_plan",
          "results",
          "disclaimer"
        ],
        "title": "WalletVerdictBatchResponse",
        "type": "object"
      },
      "WalletVerdictResponse": {
        "description": "Verdict payload: state-machine outputs only, never prose judgments.\n\nConstraint (binding; this docstring is published in the public\nOpenAPI spec, so registry names stay out of it too): no dollar PnL\nfields, no external pre-registration registry IDs, and realized_edge\nis never present without realized_edge_ci_bca. Methodology links\nbelong on convexly.app/research, not in payloads.",
        "properties": {
          "address": {
            "description": "Normalized (lowercased) wallet address.",
            "title": "Address",
            "type": "string"
          },
          "as_of": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the on-chain reconciliation proof behind this read was taken. Null when no complete read is on file.",
            "title": "As Of"
          },
          "bound": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "What this state and its numbers cover, as one sentence you can print beside any of them: 'through block N (walked T)', followed on a moved read by the sentence naming the movement. One string on purpose, so a consumer that renders it cannot keep the block and drop the movement. Null when no complete read served.",
            "title": "Bound"
          },
          "completeness_proof": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Chain-anchored completeness proof for this read: the basis, the reconciliation block and timestamp, the serve-time answer to whether the address moved an outcome token since that block, whether the read proved itself complete, and a verification instruction you can run against Polygon yourself. It echoes stamps this response already carries; the block of fields is packaging, not a verdict, and it is null when no complete read served.",
            "title": "Completeness Proof"
          },
          "concentration": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "biggest_event_pnl / net_realized_pnl. Not bounded to [0, 1]; null when not computable.",
            "title": "Concentration"
          },
          "disclaimer": {
            "description": "Fixed; cannot be disabled.",
            "title": "Disclaimer",
            "type": "string"
          },
          "edge_disclosure": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The edge, its 95% interval, and BOTH denominators (priced of complete resolved, plus the un-priceable remainder) in one string, followed on a moved read by the block the figure holds through. Null when no complete read served.",
            "title": "Edge Disclosure"
          },
          "method_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Hash of the frozen methodology this read was computed and gated under; the promotion gate checks the same value. Pin it to detect method changes between reads. Null when no complete read served.",
            "title": "Method Hash"
          },
          "methodology_version": {
            "title": "Methodology Version",
            "type": "string"
          },
          "moved_since_block": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "The chain's serve-time answer to whether this address moved an outcome token after reconciled_at_block. False means it did not. True means it did, so this state and its numbers are bounded to that block and positions taken after it are not in them; the state is not withheld for it, because a walk takes longer than an active address's gap between trades and such an address would otherwise never get a state at all. Null when no complete read served. It is never absent on a served read: a payload whose bound cannot be established is reported as no read rather than served without one.",
            "title": "Moved Since Block"
          },
          "n_priced": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Positions priced at their own entry fills; equals n_resolved (kept under both names so this payload and the reconciled-read payload can be diffed field for field). Null when no complete read served.",
            "title": "N Priced"
          },
          "n_resolved": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Resolved positions the edge and its interval were computed over. THIS IS THE PRICED SUBSET: the part of the complete resolved record for which an on-chain entry price was recoverable in this read. It is not the size of that record and is normally smaller than it; n_resolved_complete in this same response is that size, and n_priced repeats this count under the name the reconciled-read endpoint uses, so the two endpoints disclose the same denominators. A POSITIVE integer when a complete read served, and NULL when none did. Null means nothing here was counted, not that a count came to zero: the two are different claims and only one of them is something this API ever knows. Zero is not in the contract and is never emitted.",
            "title": "N Resolved"
          },
          "n_resolved_complete": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Markets resolved to completion in the full on-chain record: the denominator n_resolved is a subset of. Null when no complete read served.",
            "title": "N Resolved Complete"
          },
          "n_unpriced": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Positions counted but not priced (no entry price was recovered for them in this read). Null when no complete read served.",
            "title": "N Unpriced"
          },
          "owner_verified": {
            "$ref": "#/components/schemas/OwnerVerification"
          },
          "realized_edge": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized edge on the probability scale. Null whenever the BCa interval is unavailable; never returned alone.",
            "title": "Realized Edge"
          },
          "realized_edge_ci_bca": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "BCa bootstrap 95% interval [lo, hi]; paired with the edge.",
            "title": "Realized Edge Ci Bca"
          },
          "receipt_available": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether GET /v1/wallets/{address}/proof-of-record would issue the portable, hash-addressed record object for THIS read, answered by that endpoint's own builder rather than restated from it. False most often because the address has moved an outcome token since the block (see moved_since_block): the read is still served, bounded, but a durable artifact has nowhere to carry a bound, so the object is withheld. Read receipt_note for the reason in words. Null when no read is served.",
            "title": "Receipt Available"
          },
          "receipt_note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Why the proof-of-record object is withheld for this read, in the same sentence convexly.app shows beside its receipt link. Null when receipt_available is true, and null when no read is served.",
            "title": "Receipt Note"
          },
          "reconciled_at_block": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "The Polygon block this read's completeness was checked against: at that block the reconstructed record matched the wallet's on-chain settlement history in full. It exists so you can check currency yourself instead of taking it on trust: ask the chain whether this address moved an outcome token after this block, and if it did, the read no longer covers the whole record. It does NOT say the read is current now; it says where an independent currency check must start. Null when no complete read served, never 0.",
            "title": "Reconciled At Block"
          },
          "state": {
            "description": "Four-state badge machine output.",
            "enum": [
              "skilled",
              "luck",
              "insufficient",
              "flagged"
            ],
            "title": "State",
            "type": "string"
          },
          "state_definition": {
            "description": "Fixed definition of the returned state, with a style clause appended when a structural style is present.",
            "title": "State Definition",
            "type": "string"
          },
          "styles": {
            "description": "Descriptive style tags (2026-07-15 realized-edge reframe): how the edge is earned and its payoff shape (arbitrage / concentrated / favorite_tilt / directional). NEVER changes the state; a structural style on a skilled record means the edge is not forecasting. ['directional'] when no structural style fires.",
            "items": {
              "type": "string"
            },
            "title": "Styles",
            "type": "array"
          },
          "verdict_sentence": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The state as a sentence, bounded by the block, in the same words convexly.app renders for the same read. It names the TEST rather than the trader: 'Outside the luck range on the resolved record through block N (walked T).' Prefer it over composing your own sentence from `state`: the bare token names a person's competence with no interval, no denominator and no scope, and this field is the wording the claim audit passed. Null when no complete read served.",
            "title": "Verdict Sentence"
          }
        },
        "required": [
          "address",
          "state",
          "state_definition",
          "realized_edge",
          "realized_edge_ci_bca",
          "n_resolved",
          "edge_disclosure",
          "n_resolved_complete",
          "n_priced",
          "n_unpriced",
          "concentration",
          "owner_verified",
          "as_of",
          "reconciled_at_block",
          "methodology_version",
          "disclaimer"
        ],
        "title": "WalletVerdictResponse",
        "type": "object"
      },
      "WebhookResponse": {
        "description": "Result of webhook processing.",
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "WebhookResponse",
        "type": "object"
      }
    },
    "securitySchemes": {
      "APIKeyHeader": {
        "description": "Mint at https://www.convexly.app/settings. 32-byte hex token. Treat it as a secret: anyone with the key has the same access as your account.",
        "in": "header",
        "name": "X-API-Key",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "contact": {
      "name": "Convexly Engineering",
      "url": "https://www.convexly.app/api-docs"
    },
    "description": "Public REST surface for external integrations. Authentication is via the `X-API-Key` header; mint keys at https://www.convexly.app/settings. Available on the Researcher, Trader and Enterprise plans.\n\nThis is the customer-facing contract. Anything not published here is outside it and subject to breaking change without notice. Ask at research@convexly.app if you need an endpoint published here.",
    "license": {
      "name": "All rights reserved",
      "url": "https://convexly.app/terms"
    },
    "title": "Convexly Public API",
    "version": "0.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/v1/public/forecasts/commit": {
      "post": {
        "description": "Register a salted forecast hash before the outcome is knowable.\n\nConvexly stores the hash with a server-clock timestamp and returns a\nreceipt whose receipt_hash the issuer can recompute independently to\nprove what was attested. The forecast content itself is NOT\ntransmitted at commit time; it stays with the forecaster until\nreveal.",
        "operationId": "commit_forecast_api_v1_public_forecasts_commit_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommitForecastRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommitForecastResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Register a forecast commitment (hash only)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/forecasts/{commitment_id}": {
      "get": {
        "description": "Read the public status of a commitment.\n\nBefore reveal only the hash, the market binding, the receipt fields,\nand the chain links are visible; the forecast payload is NEVER\nreturned before reveal. After reveal the payload is public by design;\nthat is what a public track record means.",
        "operationId": "get_forecast_status_api_v1_public_forecasts__commitment_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "commitment_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Commitment Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ForecastStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [],
        "summary": "Public commitment status",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/forecasts/{commitment_id}/reveal": {
      "post": {
        "description": "Reveal the payload + salt behind a commitment.\n\nThe server recomputes the canonical hash and stores the verdict:\nreveal_valid is true only when the recomputed hash equals the\ncommitted hash AND the payload's market binding matches the committed\nmarket AND the payload schema is valid. The reveal is single-shot and\npermanent: byte-identical re-reveals are idempotent (200 with the\nstored verdict); any different content is rejected with 409. An\ninvalid reveal is stored as evidence and cannot be replaced.",
        "operationId": "reveal_forecast_api_v1_public_forecasts__commitment_id__reveal_post",
        "parameters": [
          {
            "in": "path",
            "name": "commitment_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Commitment Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RevealForecastRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RevealForecastResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Reveal a committed forecast (payload + salt)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/resolvers/{address}": {
      "get": {
        "description": "Requires an X-API-Key on Researcher or above and uses the shared row allowance.\n\nReturns stored chain observations, comparisons with other actors on each requester\nroute, and observed configured bonds. Missing history is not zero activity. Rates\nrequire complete source coverage and at least 20 eligible observations; agreement\ndescribes same-round settlement mechanics, not independent truth, skill or safety.\nThis is a current retrospective record, not a ranking or a prior track record.\nThe 120/minute pre-auth limit is separate from the shared key budget of 30 requests\nper minute and the key's daily row allowance. The read reserves up to 113 rows,\nthen attempts to release unused capacity on a best-effort basis.",
        "operationId": "public_record_api_v1_public_resolvers__address__get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "role",
            "required": false,
            "schema": {
              "default": "proposer",
              "enum": [
                "proposer",
                "disputer"
              ],
              "title": "Role",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResolverRecordResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "description": "Invalid nonzero EVM address or malformed history cursor."
          },
          "401": {
            "description": "Missing or invalid X-API-Key."
          },
          "403": {
            "description": "Researcher or above is required."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          },
          "503": {
            "description": "Record or quota state unavailable. History is unknown; retry later."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Read a current retrospective resolver record",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/resolvers/{address}/events": {
      "get": {
        "description": "Requires an X-API-Key on Researcher or above and uses the shared row allowance.\n\nReturns up to 50 observed actions, newest first, with transaction and log receipts.\nContinue with next_cursor using the same address and role. A changed generation\ninvalidates the cursor: refresh summary and history together after a 409 response.\nEmpty history is not proof that an actor has never proposed or disputed a resolution.\nA separate shared key budget allows 30 requests per minute. The requested limit is\nreserved against the daily row allowance; unused capacity is released on a\nbest-effort basis.",
        "operationId": "public_events_api_v1_public_resolvers__address__events_get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "role",
            "required": false,
            "schema": {
              "default": "proposer",
              "enum": [
                "proposer",
                "disputer"
              ],
              "title": "Role",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 50,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 2048,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResolverEventsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "description": "Invalid nonzero EVM address or malformed history cursor."
          },
          "401": {
            "description": "Missing or invalid X-API-Key."
          },
          "403": {
            "description": "Researcher or above is required."
          },
          "409": {
            "description": "Cursor belongs to another record or revision. Refresh both reads."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          },
          "503": {
            "description": "Record or quota state unavailable. History is unknown; retry later."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Read observed resolver actions and receipts",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/usage": {
      "get": {
        "description": "Report the calling key's wallet-read consumption for the current UTC day.\n\nCosts no quota. Reads through the reservation RPC's no-op branch so the\nreported number is the enforced number, never a parallel count that can\ndrift from it.",
        "operationId": "get_api_usage_api_v1_public_usage_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiUsageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Current-day quota usage for the calling key",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/reconciled-set": {
      "get": {
        "description": "List every wallet in the calling key owner's set.\n\nYour plan buys a bounded number of distinct wallets kept current on a\nper-tier cadence (see ``refresh_days``), not a number of reads. This\nalways returns 200, even for a plan or entitlement resolving to a cap of\nzero (``limit: 0, can_add: false``) -- listing your own resource state is\nnever refused, only adding past it is.\n\n``rolling_window`` reports the SECOND bound, which is a rate rather than a\nholding: how many distinct new addresses may be taken on per window, and\nhow much of that is left. Read it to pace adds rather than discovering the\nrate through a 429. Two things never draw on it, so neither shows up in\nthese counts: re-adding an address that has been in your set before, and\nany add made while ``usage.first_fill_remaining`` is above zero. Removing\na wallet is free against this rate and takes effect immediately.\n\n``rolling_window.usage`` is null when your position in the window could\nnot be read. That is UNKNOWN, not zero and not full; the rule beside it\nstill stands and adds are still enforced against it.",
        "operationId": "list_reconciled_set_api_v1_public_wallets_reconciled_set_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReconciledSetListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "List your wallet set",
        "tags": [
          "public-api"
        ]
      },
      "post": {
        "description": "Add one wallet to the calling key owner's set, enforcing the plan cap.\n\nChecked against the address format and lowercased before any write,\nexactly like every other wallet-address input in this module. The add is\nserialized through an advisory-locked database reservation, so\nconcurrent adds for the same owner -- across multiple keys, multiple\nprocesses, or a mix of this API and the dashboard -- cannot race past\nthe cap: the count-and-insert happens under one lock keyed on the owner.\n\nThe effective cap is your plan's default wallet allowance unless a\nbespoke per-customer override applies, resolved fail-closed exactly\nlike every other per-customer cap in this module (an override present\nbut blank floors to the researcher-tier cap, never your plan default\nand never the enterprise ceiling).\n\nReturns 409 for a wallet already in your set, or 403 for a set that has\nno room; both name the limit and (for the 403s) the current count so a\ncaller never has to make a second call to find out why. There are TWO\n403s with distinct codes: `wallet_set_cap_reached` when your allowance is\nfull, and `wallet_set_total_rows_reached` when your allowance has room\nbut the set is holding its maximum number of rows (which only happens by\naccumulating wallets that cannot be read).\n\nA THIRD refusal, `wallet_set_window_limit_reached`, is a 429 rather than a\n403 because it is a rate and not an entitlement: new addresses may be\ntaken on only so fast, since each one that has never been read before\ntriggers a complete on-chain walk. Two things never draw on that rate, and\nthe response says when the next slot frees up:\n\n* re-adding an address that has previously been in your set, however long\n  ago and whether or not its first read had finished; and\n* any add made while you are still filling the set for the first time, up\n  to your plan's wallet allowance.\n\nRemoving a wallet is always free and takes effect immediately. It costs no\npart of this rate and never has to be waited out.",
        "operationId": "add_reconciled_set_member_api_v1_public_wallets_reconciled_set_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddReconciledSetMemberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReconciledSetAddResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Add a wallet to your set",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/reconciled-set/{address}": {
      "delete": {
        "description": "Remove one wallet from the calling key owner's set.\n\nScoped to the authenticated user id (the service role bypasses RLS, so\nthis filter IS the ownership gate, same posture as every other query in\nthis module): a wallet that is not in YOUR set is a 404 regardless of\nwhether it is in someone else's, and nothing about another customer's\nset is revealed by the response.\n\nRemoving a wallet does not consume or refund any quota; it only ever\nfrees a slot under your plan's cap. No concurrency primitive is needed\nhere (unlike the add path): two concurrent deletes of the same row are\nnaturally safe, since at most one of them can ever find a row to remove.",
        "operationId": "remove_reconciled_set_member_api_v1_public_wallets_reconciled_set__address__delete",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReconciledSetRemoveResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Remove a wallet from your set",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/screen": {
      "get": {
        "description": "Filter the wallets Convexly has read on chain, ordered by address.\n\nAnswers the question a caller actually has before spending a set slot:\nwhich wallets clear the floor, and which already carry a certified read.\nEvery response publishes `screened`, the number of wallets the filter ran\nover, because this endpoint can only screen wallets we have READ and a\ncaller must be able to tell that apart from a statement about the market.\n\n`min_resolved_positions` filters on the CHAIN count, not the venue trade\nwindow. Those are different quantities and neither bounds the other.\n\nPaging is keyset (`after_wallet`), not offset: the read lane writes\ncontinuously, so an offset would silently skip or repeat a wallet.\n\nGated on the same plan allowance as the set itself; a plan that cannot hold\nwallets cannot screen for them.",
        "operationId": "screen_wallets_api_v1_public_wallets_screen_get",
        "parameters": [
          {
            "in": "query",
            "name": "min_resolved_positions",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Min Resolved Positions"
            }
          },
          {
            "in": "query",
            "name": "certified",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Certified"
            }
          },
          {
            "in": "query",
            "name": "include_not_scoreable",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Not Scoreable",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "after_wallet",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After Wallet"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletScreenResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Screen the wallets we have read (filterable, with a denominator)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/verdict/batch": {
      "post": {
        "description": "Score up to a plan-capped number of distinct wallets in one call.\n\nSame per-wallet schema and claim guardrails as the single verdict\nendpoint. The number of DISTINCT addresses is capped by the calling\nkey's plan (BATCH_VERDICT_MAX_BY_PLAN), so no tier gets cohort-scale\naccess beyond what it paid for; exceeding the cap is a 403. Invalid\naddresses return a per-item error rather than failing the batch, and\nconcurrency is bounded so a large batch cannot stampede the upstream.",
        "operationId": "post_wallet_verdict_batch_api_v1_public_wallets_verdict_batch_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WalletVerdictBatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletVerdictBatchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Batch wallet skill verdicts (tier-capped)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/{address}/badge": {
      "get": {
        "description": "302 to the Next.js badge SVG so embedders get one stable URL family.\n\nNo API key required: the destination\n(https://www.convexly.app/api/badge/wallet/{address}) is itself\npublic and consent-gated. It renders a neutral tile (no verdict)\nunless the skill badge is enabled AND the wallet owner has\nsignature-claimed the wallet and made the claim public; only then\ndoes it render the compact non-attesting verdict tile. The same\nvocabulary as convexly.app/skill travels with the badge.\n\nArgs:\n    address: Polymarket wallet address (0x-prefixed, 42 chars).\n    style: Optional \"light\" for the light badge theme; any other\n        value falls through to the default dark theme downstream.",
        "operationId": "get_wallet_badge_api_v1_public_wallets__address__badge_get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "style",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Style"
            }
          }
        ],
        "responses": {
          "302": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [],
        "summary": "Wallet badge (redirect to the embeddable SVG)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/{address}/proof-of-record": {
      "get": {
        "description": "Return the portable record object for a wallet in your set.\n\nThe object packages the on-chain-reconciled read's anchors into a\nthird-party-verifiable primitive: a canonical record subset, a sha256\ncontent hash over exactly that subset, the block anchor, the frozen\nmethod hash, and two copyable verification commands. The chain check is\nthe api-docs posture made executable: ask Polygon whether this address\nmoved an outcome token after reconciled_at_block; an empty answer is the\nclaim that the record is still complete, and no venue API response can\ncarry an equivalent check.\n\nFail-closed, in order: a plan with no wallet allowance is refused; a\nwallet outside your set is a 404 and costs no quota; and a read that\ndoes not clear every issuance gate (complete-read stamp, serve-time\nchain currency, pricing sufficiency, interval and denominators present,\nblock anchor, method hash) returns ``issued: false`` with the first\nfailing gate named. No partial object is ever issued.\n\nUsage is metered against the same per-key daily wallet quota as the\nother wallet-read endpoints, reserved AFTER the membership gate.",
        "operationId": "get_wallet_proof_of_record_api_v1_public_wallets__address__proof_of_record_get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletProofOfRecordResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Portable proof-of-record object (wallets in your set)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/{address}/reconciled-read": {
      "get": {
        "description": "Return the reconciled full-history read for a wallet in your set.\n\nYour plan buys a bounded set of distinct wallets kept current on a\nper-tier cadence, not a number of reads. This endpoint serves the read for\none member of that set; wallets outside it return 404.\n\nFail-closed, in order: a plan whose wallet allowance is zero is refused; a\nwallet the calling key's owner does not have in their set is a 404 and\ncosts no quota; and a wallet whose stored read does not prove complete\nreturns ``available: false`` with every estimate field null rather than the\nwindowed estimate.\n\nUsage is metered against the same per-key daily wallet quota as the verdict\nendpoints, reserved AFTER the membership gate so a 404 never spends it.",
        "operationId": "get_wallet_reconciled_read_api_v1_public_wallets__address__reconciled_read_get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletReconciledReadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "On-chain-reconciled full-history read (wallets in your set)",
        "tags": [
          "public-api"
        ]
      }
    },
    "/api/v1/public/wallets/{address}/verdict": {
      "get": {
        "description": "Return the four-state skill verdict for a Polymarket wallet.\n\nServed from the on-chain-reconciled record only. A wallet gets a state\nwhen a complete read has been reconciled for it and that read is still\ncurrent (nothing moved on chain since the block it was reconciled at);\notherwise the response is \"insufficient\" with both estimate fields null\nand a state_definition saying there is no current complete read. The\nstate itself is the binding badge machine mirrored from\napps/web/src/lib/skill-badge.ts via app/engine/skill_badge.py, run over\nthe complete resolved record at reconciliation time.\n\nUsage is metered: one public_verdict_served row per call with the\nsha256 of the API key id and of the wallet address (never the raw\nvalues).",
        "operationId": "get_wallet_verdict_api_v1_public_wallets__address__verdict_get",
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "schema": {
              "title": "Address",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletVerdictResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            },
            "description": "A limit was reached. The body names which one, the window it applies over, and how long to wait; Retry-After carries the same delay. The published limits are listed at https://www.convexly.app/api-docs."
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "summary": "Wallet skill verdict (four-state machine)",
        "tags": [
          "public-api"
        ]
      }
    }
  },
  "security": [
    {
      "APIKeyHeader": []
    }
  ],
  "servers": [
    {
      "description": "Production",
      "url": "https://www.convexly.app/api/engine"
    }
  ],
  "tags": []
}
