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

# GET /api/v1/user/competitions

`GET /api/v1/user/competitions`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/user/competitions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/user/competitions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

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

## Response `200`

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

## Changes

- **2026-05-28** `75ffe546b73a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/user/competitions/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)