CrunchDAO

CrunchDAO Season API

The season API from CrunchDAO — 3 operation(s) for season.

GitHub OpenAPI

Operations 3

2 of 3 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /v1/stakers List seasons with filters conformant #
GET /v1/seasons List seasons with filters conformant #
GET /v1/seasons/{seasonNumber} Show a season #

Documentation

📖
Authentication
https://artifacts.apis.io/crunchdao/authentication/crunchdao-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/crunchdao/openapi/crunchdao-season-api-openapi.yml

Other Resources

🔗
Swagger
https://api.hub.crunchdao.com/swagger-ui/index.html
🔗
Conventions
https://artifacts.apis.io/crunchdao/conventions/crunchdao-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/crunchdao/errors/crunchdao-problem-types.yml
🔗
Lifecycle
https://artifacts.apis.io/crunchdao/lifecycle/crunchdao-lifecycle.yml
🔗
DataModel
https://artifacts.apis.io/crunchdao/data-model/crunchdao-data-model.yml
🔗
Conformance
https://artifacts.apis.io/crunchdao/conformance/crunchdao-conformance.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/crunchdao:crunchdao-season-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

crunchdao-season-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tournament Season API
  description: CrunchDAO Tournament Platform API Endpoints
  version: v2
servers:
- url: http://api.hub.crunchdao.com
  description: Generated server url
security: []
tags:
- name: Season
paths:
  /v1/stakers:
    x-service-id: competition-service
    get:
      tags:
      - Season
      summary: List seasons with filters
      operationId: listSeasons
      parameters:
      - name: organizerName
        in: query
        description: Filter for a specific organizer.
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Filter for a specific organizer.
      - name: organizerOnChainId
        in: query
        description: Filter for a specific organizer.
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Filter for a specific organizer.
      - name: address
        in: query
        description: Filter for a specific organizer.
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Filter for a specific organizer.
      - name: userLogin
        in: query
        description: Filter for a specific organizer.
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Filter for a specific organizer.
      - name: page
        in: query
        description: Zero-based page index (0..N)
        required: false
        style: form
        explode: true
        schema:
          type: integer
          default: 0
          minimum: 0
      - name: size
        in: query
        description: The size of the page to be returned
        required: false
        style: form
        explode: true
        schema:
          type: integer
          default: 20
          minimum: 1
      - name: sort
        in: query
        description: 'Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.'
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: includeTarget
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageStaker'
  /v1/seasons:
    x-service-id: competition-service
    get:
      tags:
      - Season
      summary: List seasons with filters
      operationId: listSeasons_1
      parameters:
      - name: status
        in: query
        description: Filter for seasons with a specific status(es).
        required: false
        style: form
        explode: true
        schema:
          type: array
          description: Filter for seasons with a specific status(es).
          items:
            $ref: '#/components/schemas/SeasonStatus'
      - name: sort
        in: query
        description: Sort seasons.
        required: false
        style: form
        explode: true
        schema:
          type: string
          description: Sort seasons.
          enum:
          - RECENT
          - OLDEST
      - name: page
        in: query
        description: Zero-based page index (0..N)
        required: false
        style: form
        explode: true
        schema:
          type: integer
          default: 0
          minimum: 0
      - name: size
        in: query
        description: The size of the page to be returned
        required: false
        style: form
        explode: true
        schema:
          type: integer
          default: 20
          minimum: 1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageSeason'
  /v1/seasons/{seasonNumber}:
    x-service-id: competition-service
    get:
      tags:
      - Season
      summary: Show a season
      operationId: getSeason
      parameters:
      - name: seasonNumber
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Season'
components:
  schemas:
    Organizer:
      type: object
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
          description: Slug-like number.
        displayName:
          type: string
          description: Display name for cards.
        onChainId:
          type: string
          description: On chain address linked to this organizer. Only set if is a coordinator.
        logoImageUrl:
          type: string
          description: Logo image URL for cards.
        bannerImageUrl:
          type: string
          description: Banner URL for cards.
        stake:
          $ref: '#/components/schemas/Unit'
          description: Staking information. Only set if `onChainId` is also set.
    Season:
      type: object
      properties:
        id:
          type: integer
          format: int64
        number:
          type: integer
          format: int64
          description: Slug-like number.
        displayName:
          type: string
          description: Display name for cards.
        shortDescription:
          type: string
          description: Short description for cards.
        description:
          type: string
          description: Full description.
        status:
          $ref: '#/components/schemas/SeasonStatus'
        start:
          type: string
          format: date-time
          description: Start of the season.
        end:
          type: string
          format: date-time
          description: End of the season.
        stakeGoal:
          type: integer
          description: Staking goal to reach in the season.
        createdAt:
          type: string
          format: date-time
          description: Season creation timestamp.
    SeasonStatus:
      type: string
      description: Filter for seasons with a specific status(es).
      enum:
      - VOTING
      - OPEN
      - CLOSED
    User:
      type: object
      properties:
        id:
          type: integer
          format: int64
        login:
          type: string
    PageSeason:
      type: object
      properties:
        pageNumber:
          type: integer
          format: int64
        pageSize:
          type: integer
          format: int64
        totalElements:
          type: integer
          format: int64
        totalPages:
          type: integer
          format: int64
        content:
          type: array
          items:
            $ref: '#/components/schemas/Season'
    Staker:
      type: object
      properties:
        id:
          type: integer
          format: int64
        address:
          type: string
          description: Address which placed the stakes.
        user:
          $ref: '#/components/schemas/User'
          description: User who match the address. `null` if none is matching.
        totalAmount:
          type: integer
          description: Total staked amount.
        organizer:
          $ref: '#/components/schemas/Organizer'
          description: Target of the stake. Only included if `includeTarget=true`
    Unit:
      type: object
      properties:
        prefix:
          type: string
          description: String to show before the value.
        suffix:
          type: string
          description: String to show after the value.
        scale:
          type: integer
          format: int32
          description: Number of digits to keep after the comma.
    PageStaker:
      type: object
      properties:
        pageNumber:
          type: integer
          format: int64
        pageSize:
          type: integer
          format: int64
        totalElements:
          type: integer
          format: int64
        totalPages:
          type: integer
          format: int64
        content:
          type: array
          items:
            $ref: '#/components/schemas/Staker'
  securitySchemes:
    apiKey:
      type: apiKey
      name: apiKey
      in: query
      scheme: token
    accessToken:
      type: http
      in: header
      scheme: Bearer
externalDocs:
  description: docs.crunchdao.com
  url: https://docs.crunchdao.com