AttributionRevenueReporter

gov.attributionrevenuereporter

Governance & Ops planned Spec started frozen

AttributionRevenueReporter reconciles builder-code rebates with internal fill records and publishes a daily auditable SettlementReport.

What it does

AttributionRevenueReporter reconciles builder-code rebates with internal fill records and publishes a daily auditable SettlementReport. Retained 7 years for financial and regulatory compliance.

Pipeline placement

runs after: BuilderAttribution reconciliation cycle → AttributionRevenueReporter → runs before: Nothing — runs daily post-close

Applies to: All builder-code attributed fills within the reporting window

Why it matters

If this fails	Consequence
Rebate not reconciled	Builder-code fee rebates may be under- or over-reported; financial records are inaccurate.
Per-strategy slice missing	Revenue attribution to individual strategies is impossible; resource allocation decisions lack data.

Inputs

Polymarket inputs

Input	Source	Required	Use
Polymarket builder-code volume and rebate report	data	required	Fetch official daily rebate figures for reconciliation.
Internal fill records from attribution log	internal	required	Compare with official report to compute drift.

Internal inputs

Input	Source	Required	Use
BuilderAttribution reconciliation output	gov.builderattribution	required	Source of quarantine status and drift delta for each reconciliation window.
ExecutionReport stream	internal.report_bus	required	Aggregate builder_fee_pusd per strategy and per user for the daily report.

Authority

What this bot is permitted to do

Explain

State

Readiness

Spec started

Status

planned

Class

Governance Service

Default mode

shadow_only

Developer owner

Polytraders core

Capital impact

Indirect

Reason codes emitted

Code	Severity	Meaning	Action
REVENUE_REPORT	INFO	Daily attribution revenue report generated and emitted.	Log and store.
REVENUE_DRIFT_DETECTED	WARN	Drift between internal and official rebate figures exceeds threshold.	Emit alert; quarantine report pending review.
REPORT_DEFERRED	WARN	Data API unavailable at report time; retry scheduled.	Emit WARN; schedule retry.
RETENTION_BELOW_REGULATORY_MINIMUM	WARN	retain_days < 2555.	Emit WARN; refuse config change.
KILL_SWITCH_ACTIVE	WARN	KillSwitch active; report notes trading was halted during window.	Include kill-switch note in report.

Related bots in Governance & Ops

gov.api_degradation_monitor gov.backtester gov.builderattribution

Used by

Reverse index — strategies that currently reference gov.attributionrevenuereporter. If you change this bot's authority or reason codes, these strategies must re-pass shadow.

Strategy	State	Activity
BTC weekly — close-aware quotes	demo-wired	last triggered 31m ago

Showing 1 of 1 · demo-wired ≠ production-live

Why this matters

Governance & Ops bots does NOT propose, approve, or block trades; only observes and reports. Understanding the authority boundary prevents misuse and makes promotion-gate reviews faster and more reliable. View raw spec JSON →

Polytraders Operator UX Mock · INTERNAL · demo-wired ≠ production-live · the plan · reason codes · shadow-mode pipeline