Compare source-reported trading-style wallet cohorts by metrics window and minimum trade count, using wallet counts, USD realized P&L, trading volume and fees.
Up to 0.01122 credits / call
The final charge is based on confirmed usage. Unused reserved credits return to your available balance.
BlockRun
Polymarket Wallet Cohort Statistics | BlockRun
Compare source-reported trading-style wallet cohorts by metrics window and minimum trade count, using wallet counts, USD realized P&L, trading volume and fees.
You receive
Get aggregate statistics for the wallet trading-style groups the source returns, including wallet counts, realized P&L totals and averages, an approximate median, volume and available fee values. Your Agent can compare these groups using the same window and inclusion threshold.
Start with your task
Compare Polymarket wallets by trading style. For each group, show the number of wallets and their past profit or loss in total, on average, and at a value near the middle.
What to know
This returns cohort aggregates without wallet-address lookup, custom label filters or arbitrary dates. Group names and coverage follow the source; some ratio scales are unspecified, and past cohort metrics cannot predict a wallet’s future returns.
Inputs & outputs
Inspect the current inputs, availability, and maximum charge before starting.
Input schema
Input schema
Field / Path
Type
Requirement
Meaning
Metrics window and inclusion thresholdqueryParams
object
Optional
Optional open container. Put window and min_trades directly here. window accepts 1d, 7d, 30d or all_time (default all_time); min_trades accepts an integer at least 1 or null (default 10). Null does not establish that filtering is disabled.
Nested query objectqueryParams.query
object
Optional
Optional nested object in the input contract. The exact endpoint controls belong directly in queryParams; this nested object is not flattened, and limit is not an available control.
No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.
Result schema
Field / Path
Type
Meaning
Reported metrics windowresult.window
string
The metrics window reported by the source. It is not a data-update timestamp, and an all_time label does not prove complete platform-wide history.
Cohort aggregatesresult.cohorts
array
Aggregate rows for the source-defined wallet groups returned by this request. The response contains no wallet-address rows and promises no fixed group count.
Source average ROIresult.cohorts[].avg_roi
number
Average ROI as supplied. Its scale, denominator and averaging formula are unspecified by this response definition; preserve the raw value without automatic percent conversion.
Average trade countresult.cohorts[].avg_trades
number
Average number of trades in the cohort. A mean can be fractional; it is not an integer count for one wallet or a USD amount.
Source cohort nameresult.cohorts[].cohort_name
string
The group label returned by the source. Preserve it rather than assigning a new style or assuming every advertised label is present; it does not identify verified people.
Source average win rateresult.cohorts[].avg_win_rate
number
Average win rate as supplied. Its numeric scale and aggregation basis are not stated by the exact cohort model; keep the raw number rather than inventing a percentage.
Cohort volume in USDresult.cohorts[].total_volume
number
Source-reported total trading volume in USD for this cohort. It is separate from realized P&L, fees and wallet balance.
Wallets in the cohortresult.cohorts[].wallet_count
number
The source-reported number of wallets in this group. It is not a transaction count or a count of independently verified people.
Average taker fees in USDresult.cohorts[].avg_fees_paid
number
Average taker fees paid per wallet in USD. The source already nets refunds into paid-fee values; do not apply a second refund adjustment.
Total taker fees in USDresult.cohorts[].total_fees_paid
number
Total taker fees paid by the cohort in USD. Refunds are already netted by the source, and no separate realized-P&L fee formula is declared here.
Average realized P&L in USDresult.cohorts[].avg_realized_pnl
number
Average realized P&L per wallet in USD. Compare it separately from the cohort total and approximate median; it does not include an invented unrealized-P&L figure.
Deprecated average refund fieldresult.cohorts[].avg_fees_refunded
number
Deprecated field documented as zero because refunds are already netted into fees_paid. Preserve the returned value; zero is not proof that no refunds occurred.
Source average profit factorresult.cohorts[].avg_profit_factor
number
Average profit factor as supplied. Its formula, averaging weights and zero-loss handling are unspecified; do not replace it with a ratio of cohort totals.
Total realized P&L in USDresult.cohorts[].total_realized_pnl
number
Source total realized P&L in USD for the cohort. Preserve its sign; it is distinct from total P&L including unrealized positions or a future return.
Approximate median P&L in USDresult.cohorts[].median_realized_pnl
number
Approximated median realized P&L in USD. This is not the mean or an exact median; the approximation method and precision are unstated.
Deprecated total refund fieldresult.cohorts[].total_fees_refunded
number
Deprecated field documented as zero because refunds are netted into paid fees. Keep the actual value without subtracting it again from fees or P&L.
Share of wallets with positive P&Lresult.cohorts[].profitable_wallet_pct
number
Source fraction of wallets with positive P&L, on the documented 0–1 scale. Its positive-P&L basis is not explicitly realized versus total P&L; a labeled percentage may multiply the raw fraction by 100.
Total wallets across cohortsresult.total_wallets
number
Source-reported total wallets across the cohorts. Inclusion may depend on the minimum-trade threshold; it is not all platform users, verified people or a pagination count.
Additional notes
Reading the source groups
The source classifies wallet behavior rather than verified people. Its primary trading styles follow a documented priority, while entry-price labels such as CONTRARIAN are independent and can overlap with a primary style. Read the group names actually returned; no fixed list or group count is guaranteed.
Use the same metrics window and inclusion threshold for a like-for-like comparison. The source does not specify whether the minimum trade count is measured within that window or whether labels are recalculated for it. A null threshold is allowed without a defined filter-disabling meaning, and the reported wallet total is not a census of every Polymarket user.
Comparing totals, averages and fees
USD realized P&L totals reflect the size of a group. Average realized P&L per wallet and the approximate median answer different questions about its distribution. The median is an estimate with an unspecified approximation method; keep these figures separate from unrealized P&L and avoid treating one mean as the result for every wallet.
Paid-fee totals and averages are source-reported USD taker fees. Refunds are already netted into those values. The deprecated refund fields are documented as zero, which does not prove that no refunds occurred; do not subtract them again or invent an additional realized-P&L calculation.
Interpreting the source ratios
Only profitable_wallet_pct has a documented 0–1 scale: the share of wallets with positive P&L. The source does not specify whether that positivity uses realized or total P&L. Keep avg_roi and avg_win_rate as raw source numbers because their scales are undeclared here. The formula and zero-loss convention for avg_profit_factor are also unspecified; it is not a ratio to reconstruct from cohort totals or a forecast.
You do not need to enter a wallet address or account details. The comparison uses all available history and includes wallets with at least 10 trades.
Compare Polymarket wallets by trading style. For each group, show the number of wallets and their past profit or loss in total, on average, and at a value near the middle.
Understand the numbers
Each row groups wallets with a preset trading style. The total adds up past profit or loss across the group; the average is per wallet. The middle figure is roughly the result near the center after ordering the wallets from lowest to highest. A few unusually large results can move the average. Past results do not predict future performance.