> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simmer.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# WC Copy Leaders

> Returns the cached curated World Cup copy-leader set.

Leaders are ranked by aggregated WC-market totalPnl (Phase 2), with
copyability screened via the PolyNode copy-pnl leaderboard (excludes toxic
wallets and MM-bot-scale traders).

When forming=true the leaderboard is still gathering data (fewer than the
minimum qualified leaders). The payload still contains whatever leaders have
qualified so far — clients should display the partial set with a note that
the leaderboard is forming.

The set is kept warm two ways: a daily 02:00 UTC curation job, and lazy
self-heal — if this read finds the cache missing or stale, it kicks a
single-flight background refresh (SIM-3090) so a missed/eaten cron fire
doesn't leave the cache empty for the day. Self-heal never blocks the
response.

Free-tier accessible — no Pro gate.

Returns 503 when the cache is not yet populated (a refresh is kicked; retry
shortly).



## OpenAPI

````yaml /openapi.json get /api/sdk/wc/copy-leaders
openapi: 3.1.0
info:
  title: Simmer API
  description: Agent-native trading infrastructure for prediction markets.
  version: 1.0.0
servers:
  - url: https://api.simmer.markets
security: []
paths:
  /api/sdk/wc/copy-leaders:
    get:
      tags:
        - wc
      summary: WC Copy Leaders
      description: >-
        Returns the cached curated World Cup copy-leader set.


        Leaders are ranked by aggregated WC-market totalPnl (Phase 2), with

        copyability screened via the PolyNode copy-pnl leaderboard (excludes
        toxic

        wallets and MM-bot-scale traders).


        When forming=true the leaderboard is still gathering data (fewer than
        the

        minimum qualified leaders). The payload still contains whatever leaders
        have

        qualified so far — clients should display the partial set with a note
        that

        the leaderboard is forming.


        The set is kept warm two ways: a daily 02:00 UTC curation job, and lazy

        self-heal — if this read finds the cache missing or stale, it kicks a

        single-flight background refresh (SIM-3090) so a missed/eaten cron fire

        doesn't leave the cache empty for the day. Self-heal never blocks the

        response.


        Free-tier accessible — no Pro gate.


        Returns 503 when the cache is not yet populated (a refresh is kicked;
        retry

        shortly).
      operationId: get_wc_copy_leaders_api_sdk_wc_copy_leaders_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WCCopyLeadersResponse'
        '503':
          description: Leader set not yet computed — daily curation job has not run yet
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: leader set not yet computed
                type: object
components:
  schemas:
    WCCopyLeadersResponse:
      properties:
        refreshed_at:
          type: string
          title: Refreshed At
        forming:
          type: boolean
          title: Forming
          default: false
        qualified_count:
          type: integer
          title: Qualified Count
          default: 0
        leaders:
          items:
            $ref: '#/components/schemas/WCLeader'
          type: array
          title: Leaders
      type: object
      required:
        - refreshed_at
        - leaders
      title: WCCopyLeadersResponse
    WCLeader:
      properties:
        wallet:
          type: string
          title: Wallet
        wc_total_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Wc Total Pnl
        backtest_copy_pnl_usdc:
          type: number
          title: Backtest Copy Pnl Usdc
        slippage_cost_rate_pct:
          type: number
          title: Slippage Cost Rate Pct
        trade_count:
          type: integer
          title: Trade Count
      type: object
      required:
        - wallet
        - backtest_copy_pnl_usdc
        - slippage_cost_rate_pct
        - trade_count
      title: WCLeader

````