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

# public/get_maker_program_scores

> Returns the wallet-level score breakdown for one maker-program epoch, including square-rooted coverage and quality components, traded-volume multiplier, holder boost, volume, and epoch totals. Scores, trades, program configuration, and the temporary enrolled-wallet set are read from ClickHouse.



## OpenAPI

````yaml /openapi.json post /public/get_maker_program_scores
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: Onchain Actions
    description: >-
      L1 onchain actions submitted via OnchainActionManager: register deposit
      addresses, list pending deposits, and inspect onchain action history.
  - name: System
    description: Rate limits and transaction lookups.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Maker Scoring
    description: Maker programs, score breakdowns, and detailed scoring snapshots.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /public/get_maker_program_scores:
    post:
      tags:
        - Maker Scoring
      summary: public/get_maker_program_scores
      description: >-
        Returns the wallet-level score breakdown for one maker-program epoch,
        including square-rooted coverage and quality components, traded-volume
        multiplier, holder boost, volume, and epoch totals. Scores, trades,
        program configuration, and the temporary enrolled-wallet set are read
        from ClickHouse.
      operationId: public_get_maker_program_scores
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetMakerProgramScoresParams'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMakerProgramScoresResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    GetMakerProgramScoresParams:
      type: object
      required:
        - epoch_start_timestamp
        - program_name
      properties:
        epoch_start_timestamp:
          type: integer
          format: int64
        program_name:
          type: string
    GetMakerProgramScoresResponse:
      type: object
      required:
        - program
        - scores
        - total_score
        - total_volume
      properties:
        program:
          $ref: '#/components/schemas/ProgramResponse'
        scores:
          type: array
          items:
            $ref: '#/components/schemas/ScoreBreakdown'
        total_score:
          type: string
        total_volume:
          type: string
    ProgramResponse:
      type: object
      required:
        - asset_types
        - currencies
        - end_timestamp
        - min_notional
        - name
        - rewards
        - start_timestamp
      properties:
        asset_types:
          type: array
          items:
            type: string
        currencies:
          type: array
          items:
            type: string
        end_timestamp:
          type: integer
          format: int64
        min_notional:
          type: string
        name:
          type: string
        rewards:
          type: object
          additionalProperties:
            type: string
        start_timestamp:
          type: integer
          format: int64
    ScoreBreakdown:
      type: object
      required:
        - coverage_score
        - holder_boost
        - quality_score
        - total_score
        - volume
        - volume_multiplier
        - wallet
      properties:
        coverage_score:
          type: string
        holder_boost:
          type: string
        quality_score:
          type: string
        total_score:
          type: string
        volume:
          type: string
        volume_multiplier:
          type: string
        wallet:
          type: string

````

## Related topics

- [public/get_maker_programs](/api-reference/maker-scoring/publicget_maker_programs.md)
- [Programmatic Onboarding](/getting-started/depositing.md)
- [public/get_referral_performance](/api-reference/referrals/publicget_referral_performance.md)