NYYU Logo
APIStatistics

Get Round Chance

Retrieve win rate and failure rate statistics for comprehensive auction round success tracking

SUCCESS METRICS

Round Success Rates

Track win rates and failure rates across auction rounds for success analysis and outcome prediction.

Success Analytics

This query provides outcome metrics essential for tracking round success rates, identifying trends, and optimizing auction strategies.

Overview

The getRoundChance query retrieves success metrics for each auction round, specifically win rate and failed rate. These percentage-based metrics help you understand auction performance, participant success, and round outcomes for strategic planning and analysis.


GraphQL Schema

query {
  getRoundChance: [RoundChance]
}

Return Type

RoundChance Object

roundNumberInt!

The unique identifier for the auction round. Sequential numbering starting from 1.

winRateFloat!

Percentage of successful outcomes in the round. Represents winning bids or positive results (0-100).

failedRateFloat!

Percentage of unsuccessful outcomes in the round. Represents losing bids or negative results (0-100).

Rate Calculation

Win rate and failed rate should typically sum to 100% for each round, though edge cases may exist depending on your business logic.


Example Usage

Query Request

query GetSuccessRates {
  getRoundChance {
    roundNumber
    winRate
    failedRate
  }
}

Successful Response

{
  "data": {
    "getRoundChance": [
      {
        "roundNumber": 1,
        "winRate": 65.5,
        "failedRate": 34.5
      },
      {
        "roundNumber": 2,
        "winRate": 58.2,
        "failedRate": 41.8
      },
      {
        "roundNumber": 3,
        "winRate": 52.7,
        "failedRate": 47.3
      },
      {
        "roundNumber": 4,
        "winRate": 48.3,
        "failedRate": 51.7
      },
      {
        "roundNumber": 5,
        "winRate": 42.1,
        "failedRate": 57.9
      }
    ]
  }
}

Success Trend Insights

The example shows declining win rates over rounds, suggesting increasing competition or difficulty. This pattern is common as auctions progress.


Chart Integration Examples

Success Rate Visualization Techniques

🥧

Pie/Donut Chart per Round

Visualize win vs. fail distribution for individual rounds using pie or donut charts for instant ratio understanding.

Chart.js PieRecharts PieChartVictory VictoryPie

📊

Stacked Bar Chart

Display win and fail rates as stacked bars totaling 100% to compare success distribution across rounds.

Chart.js Stacked BarRecharts BarChart

📈

Win Rate Trend Line

Plot win rate as a line chart over rounds to visualize success trends and identify improving or declining patterns.

Chart.js LineRecharts LineChart

🎯

Gauge/Progress Indicator

Use gauge charts or progress bars to show win rate percentage with color-coded success thresholds.

Recharts RadialBarChartGauge Component

📉

Area Chart Comparison

Use stacked area charts to show proportional success/failure evolution over time.

Recharts AreaChartChart.js Area

Implementation Examples

React + Recharts Win Rate Line Chart

import { LineChart, Line, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ReferenceLine } from 'recharts';
import { useQuery, gql } from '@apollo/client';

const GET_ROUND_CHANCE = gql`
  query GetSuccessRates {
    getRoundChance {
      roundNumber
      winRate
      failedRate
    }
  }
`;

function WinRateTrendChart() {
  const { data, loading } = useQuery(GET_ROUND_CHANCE);

  if (loading) return <div>Loading success rates...</div>;

  const chartData = data.getRoundChance.map(round => ({
    round: `Round ${round.roundNumber}`,
    roundNum: round.roundNumber,
    winRate: round.winRate,
    failedRate: round.failedRate
  }));

  return (
    <LineChart width={800} height={400} data={chartData}>
      <CartesianGrid strokeDasharray="3 3" />
      <XAxis dataKey="round" />
      <YAxis label={{ value: 'Percentage (%)', angle: -90, position: 'insideLeft' }} domain={[0, 100]} />
      <Tooltip formatter={(value) => `${value.toFixed(1)}%`} />
      <Legend />

      {/* Reference line at 50% */}
      <ReferenceLine y={50} stroke="#888" strokeDasharray="3 3" label="50% Threshold" />

      {/* Win rate line in green */}
      <Line
        type="monotone"
        dataKey="winRate"
        stroke="#10b981"
        strokeWidth={3}
        name="Win Rate"
        dot={{ r: 5 }}
      />

      {/* Fail rate line in red */}
      <Line
        type="monotone"
        dataKey="failedRate"
        stroke="#ef4444"
        strokeWidth={3}
        name="Failure Rate"
        dot={{ r: 5 }}
      />
    </LineChart>
  );
}

Chart.js Stacked Bar Chart

import { Bar } from 'react-chartjs-2';

function SuccessDistributionChart({ data }) {
  const chartData = {
    labels: data.getRoundChance.map(r => `Round ${r.roundNumber}`),
    datasets: [
      {
        label: 'Win Rate (%)',
        data: data.getRoundChance.map(r => r.winRate),
        backgroundColor: 'rgba(16, 185, 129, 0.7)',
        borderColor: 'rgb(16, 185, 129)',
        borderWidth: 1
      },
      {
        label: 'Failure Rate (%)',
        data: data.getRoundChance.map(r => r.failedRate),
        backgroundColor: 'rgba(239, 68, 68, 0.7)',
        borderColor: 'rgb(239, 68, 68)',
        borderWidth: 1
      }
    ]
  };

  const options = {
    responsive: true,
    plugins: {
      title: {
        display: true,
        text: 'Success vs Failure Distribution by Round'
      },
      tooltip: {
        callbacks: {
          label: (context) => {
            return `${context.dataset.label}: ${context.parsed.y.toFixed(1)}%`;
          }
        }
      }
    },
    scales: {
      x: {
        stacked: true
      },
      y: {
        stacked: true,
        max: 100,
        title: {
          display: true,
          text: 'Percentage (%)'
        }
      }
    }
  };

  return <Bar data={chartData} options={options} />;
}

Use Cases

🎯

Success Tracking Dashboard

Monitor auction performance with real-time success rate indicators and trend visualizations

📊

Strategy Optimization

Analyze win/fail patterns to optimize bidding strategies and auction configurations

💡

Predictive Analytics

Use historical success rates to forecast future round outcomes and participant behavior

📈

Performance Reports

Generate automated reports showing success metrics, trends, and comparative analysis


Success Rate Analysis

Interpreting Success Metrics

High Win Rate (>60%)

Indicates favorable conditions for participants:

  • Good market conditions or pricing
  • High participant satisfaction
  • May indicate rounds are too easy or predictable

Action: Consider increasing difficulty or adjusting incentives

⚖️

Balanced Rate (40-60%)

Optimal balance between success and failure:

  • Fair competition and well-calibrated difficulty
  • Sustainable engagement levels
  • Healthy marketplace dynamics

Action: Maintain current configuration and monitor for changes

⚠️

Low Win Rate (<40%)

Challenging conditions requiring attention:

  • High competition or difficult requirements
  • Potential participant frustration
  • Risk of reduced engagement over time

Action: Review and adjust difficulty or provide additional support


Advanced Analytics Tips

📊 Success Rate Delta

Calculate change: delta = currentWinRate - previousWinRate to detect trends

🎯 Average Success Rate

Track overall platform health: avgWinRate = sum(winRates) / totalRounds

📈 Trend Detection

Use linear regression on win rates to identify upward or downward success trends over multiple rounds

🔔 Threshold Alerts

Set up alerts when win rate falls below 35% or exceeds 75% to trigger manual review


Best Practices

🎨 Color Coding

Use green for win rates, red for fail rates to create intuitive, scannable visualizations

📊 Contextual Display

Always show both win and fail rates together for complete context and validation (should sum to ~100%)

🎯 Reference Lines

Add 50% reference line to charts to quickly identify above/below average performance

💾 Historical Comparison

Compare current round success rates with historical averages to detect anomalies

🔍 Data Validation

Validate that winRate + failedRate ≈ 100% to ensure data integrity