---
title: "Get competition"
method: GET
path: "/v1/competitions/{slug}"
tags: ["Competition"]
---

# Get competition

`GET /v1/competitions/{slug}`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/v1/competitions/{slug}`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/competitions/:slug/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a single competition's metadata.

## Path parameters

- `slug` string, required

## Response `200`

A successful response.

- ApiGetCompetitionResponse
  - `competition` ApiCompetitionMeta
    - `id` string, int64
    - `slug` string
    - `name` string
    - `description` string
    - `start_time` string, int64
    - `end_time` string, int64
    - `prize_pool` string
    - `state` string
    - `participant_count` integer
    - `created_at` string, int64: Unix seconds when the competition row was created / last updated.
    - `updated_at` string, int64
  - `prize_table_json` string: prize_table JSON as a string (flexible per-comp shape).
  - `scoring_config_json` string: scoring_config JSON as a string: the competition's tunables and campaign parameters, including the reward gates (min_deposit_usd, min_volume_usd) and the tracks (`tracks`) the competition is presented as. registration_code is stripped — this endpoint is public and the entry code is the one tunable that is a credential. "{}" if the stored config is unparseable, since a config that cannot be read cannot be redacted either.
  - `total_volume` string: Combined trading volume (maker + taker, human USD) of all participants over the competition window, summed from the last-recomputed leaderboard. "0" before the first recompute.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/v1/competitions/:slug/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)