---
title: "GET /api/v1/competitions"
method: GET
path: "/api/v1/competitions"
tags: ["competitions"]
---

# GET /api/v1/competitions

`GET /api/v1/competitions`

## Query parameters

- `status` 'draft' | 'scheduled' | 'active' | 'ended' | 'cancelled'

## Response `200`

Public competitions list

- ListCompetitionsResponse
  - `data` CompetitionSummary[], required
    - `description_md` string, required
    - `end_time_ms` integer, required
    - `id` string, required
    - `prize_usdc` integer, required
    - `scoring` CompetitionScoringConfig, required — Parameters that drive score calculation. - min_daily_activity_units is raw USDC 1e6 units. - All bps values are basis points (1 bp = 0.01%).
      - `consistency_max_bonus_bps` integer, nullable — Max bonus (bps) granted when a participant hits `consistency_target_days`.
      - `consistency_target_days` integer, nullable — Target active day count for maximum bonus; required when `use_consistency_multiplier`.
      - `end_weight_bps` integer, required — Weight applied to the last day, in bps. Linear interpolation between start and end.
      - `max_daily_contribution_bps` integer, required — Per-day contribution cap as a fraction (bps) of the positive sum across the window.
      - `metric` 'volume' | 'pnl', required
      - `min_active_days` integer, required — Required active days for a sub-account to qualify for a rank.
      - `min_daily_activity_units` integer, required — Minimum daily raw metric value (USDC 1e6 units) for a day to count toward `active_days`.
      - `start_weight_bps` integer, required — Weight applied to the first day, in bps (typical: 10000 = 100%).
      - `use_consistency_multiplier` boolean — Whether to apply the consistency multiplier (scales with active days).
    - `slug` string, required
    - `start_time_ms` integer, required
    - `status` 'draft' | 'scheduled' | 'active' | 'ended' | 'cancelled', required
    - `symbol` string, nullable
    - `title` string, required

---

[API](https://skmtc.net/ekidenfi/apis/ekiden-gateway.md) · [All operations](https://skmtc.net/ekidenfi/apis/ekiden-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ekidenfi/ekiden-gateway/versions/75ffe546b73a/schema)