Help Center/Rewards & Accumulation/Plan Builder: run the economics preview on a real or synthetic cohort
Rewards & Accumulation•Last updated: 2026-10-19•6 min read

Plan Builder: run the economics preview on a real or synthetic cohort

Run the real payout functions and read I8I issued, USD intake, coverage, warnings and traces.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Choose the cohort

Under "Economics preview: choose the cohort" pick "REAL: live members (read-only)" or "SYNTHETIC: generated from parameters". REAL reads actual members, placements and approved purchases and writes nothing.

2

Set the synthetic parameters

Enter Members, Random seed, Share of members who recruit, Active members (%), PREMIUM-tier members (%) and Members who buy a plan (%). Fill the purchase mix: plan code, price in USD, share and paid-in asset (USD, USDT or USDC; shares total 100).

3

Stress a leg

Move the "Leg skew" slider or press a preset. It sets how many new members are recruited under the LEFT leg, and the generated tree changes accordingly.

4

Run it

Press "Run economics preview". The same engines used for real payouts run over the cohort.

5

Read the result

The header shows the cohort source (REAL or SYNTHETIC). Read I8I issued, claimable versus vesting, USD intake, payout over intake, coverage and margin. "How these are defined" explains each metric.

6

Read warnings and traces

Warnings list cap breaches, negative margin, retired or preview-only engines. Sample traces show the top earners line by line; they use SIM-n ids for synthetic cohorts and real DIDs only for REAL.

Expected Operational Outcome

You have a labelled, reproducible estimate of what the plan would issue and cost.

Troubleshooting & Failure Modes

Symptom: Payout over intake shows n/a
Likely Cause: No reference rate or no purchases in the cohort.
Resolution: Set the reference rate and give the cohort purchases.
Symptom: A field error appears under a parameter
Likely Cause: The server rejected a value.
Resolution: Correct the field named in the message and run again.

Was this guide helpful?

Help us refine our platform documentation