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

# List all active provider configurations

> Returns the minimal exchange-agnostic config needed by the UI for every currently active provider. Public endpoint — no auth headers are checked. No endpoint-specific rate limit; only the global default (100/minute) applies.



## OpenAPI

````yaml /openapi/data-api.yaml get /providers/configs
openapi: 3.1.0
info:
  title: Kairos Data API
  version: 1.0.0
  summary: >-
    The full Kairos data plane — markets, candles, trades, search, discover,
    sports, trader analytics, and PnL.
  description: |
    The Kairos Data API at `data.kairos.trade` is the platform's primary data
    plane: market metadata and prices, OHLCV candles, live venue trade proxies,
    normalized trade history, full-text search, discovery feeds, the sports
    catalog, public trader analytics, and account PnL.

    ## Authentication

    Most endpoints accept a Kairos **API key** (`X-Client-Id` + `X-Api-Key` +
    `X-Api-Secret`, all three) or a first-party session JWT. Endpoints tagged
    `public` (trader analytics, provider configs, several sports feeds) need
    no credentials at all. Some endpoints additionally require an API-key
    **scope** (`trade:read`, `position:read`) — stated per operation.

    For high-volume market-data consumption (candles/trades/metadata at
    scale), prefer the dedicated **Market Data API** at `md.kairos.trade` —
    it has higher budgets, ETag caching, and a binary candle format.

    ## Rate limits

    Rate limits use a sliding window keyed on the authenticated user (JWT
    `sub`) or, for anonymous callers, the trusted client IP. Routes belong to
    a named **bucket** (`x-kairos-bucket`) whose per-minute budget is shared
    by every route in it; routes with no bucket run under the service default
    of 100/minute. `x-kairos-rate-limit` states the bucket's compile-time
    default — operators can raise or lower a bucket at runtime, so treat the
    documented number as the baseline, not a contract. 429 responses carry
    `Retry-After` and `X-RateLimit-*`.

    ## Conventions

    - Prices are on the **0–100 cents scale** unless a field says otherwise
      (trader-analytics position/trade prices use the 0–1 scale; each field's
      description states its scale).
    - Errors: `{"detail": "<message>"}` for handler errors; FastAPI's
      standard validation envelope for 422s. Errors surfaced from a venue
      adapter instead use `{"error", "provider", "operation", "message"}` —
      see `DataProviderError`. Unhandled failures always return the generic
      500 body; internal details are logged, never returned.
    - Every request body is capped at 8 MiB service-wide (413).
  contact:
    name: Kairos
    url: https://app.kairos.trade/docs/api-reference
  termsOfService: https://kairos.trade/terms
servers:
  - url: https://data.kairos.trade
    description: Production
  - url: https://staging-data.kairos.trade
    description: Staging
security:
  - apiKeyClientId: []
    apiKeyKey: []
    apiKeySecret: []
paths:
  /providers/configs:
    get:
      tags:
        - Providers
      summary: List all active provider configurations
      description: >-
        Returns the minimal exchange-agnostic config needed by the UI for every
        currently active provider. Public endpoint — no auth headers are
        checked. No endpoint-specific rate limit; only the global default
        (100/minute) applies.
      operationId: getProviderConfigs
      parameters: []
      responses:
        '200':
          description: All active provider configs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProvidersConfigsResponse'
        '422':
          $ref: '#/components/responses/DataValidationError'
        '429':
          $ref: '#/components/responses/DataRateLimited'
      security: []
components:
  schemas:
    ProvidersConfigsResponse:
      type: object
      required:
        - configs
        - meta
      properties:
        configs:
          type: array
          items:
            $ref: '#/components/schemas/ProvidersConfig'
        meta:
          type: object
          required:
            - count
          properties:
            count:
              type: integer
    ProvidersConfig:
      type: object
      description: Exchange-agnostic provider configuration.
      required:
        - id
        - display_name
        - icon_url
        - chain_id
        - chain_name
        - is_active
        - supported_order_types
        - supports_walk_the_book
        - supports_token_approval
        - has_multi_token_markets
        - auth_flow_type
      properties:
        id:
          type: string
          example: kalshi
          description: '''kalshi'' | ''polymarket'' | ''predictfun'' | ''hyperliquid'' | ...'
        display_name:
          type: string
          example: Kalshi
        icon_url:
          type: string
        chain_id:
          type: string
        chain_name:
          type: string
        is_active:
          type: boolean
        supported_order_types:
          type: array
          items:
            type: string
          example:
            - limit
            - market
        supports_walk_the_book:
          type: boolean
        supports_token_approval:
          type: boolean
        has_multi_token_markets:
          type: boolean
        auth_flow_type:
          type: string
          enum:
            - none
            - wallet_signature
            - api_key
        token_id_format:
          type: string
          enum:
            - opaque
            - clob_uint256
          default: opaque
        metadata_key_type:
          type: string
          enum:
            - marketId
            - conditionId
          default: marketId
        numeric_id:
          type: integer
          nullable: true
        primary_color:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
          nullable: true
        updated_at:
          type: string
          format: date-time
          nullable: true
  responses:
    DataValidationError:
      description: Request failed FastAPI parameter validation.
      content:
        application/json:
          schema:
            type: object
            required:
              - detail
            properties:
              detail:
                type: array
                description: >-
                  One entry per failed field, with location, message, and error
                  type.
                items:
                  type: object
                  additionalProperties: true
    DataRateLimited:
      description: >
        Rate limit exceeded for this route's sliding window, keyed on the
        session `sub` when

        authenticated and on the trusted client IP otherwise. Honor
        `Retry-After`. A per-API-key

        data ceiling (set per credential) rejects with `{"detail": "API key data
        rate limit

        exceeded"}` instead of the `error` envelope below.
      headers:
        Retry-After:
          schema:
            type: integer
        X-RateLimit-Limit:
          schema:
            type: integer
        X-RateLimit-Remaining:
          schema:
            type: integer
        X-RateLimit-Reset:
          schema:
            type: integer
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: 'Rate limit exceeded: 100 per 1 minute'
  securitySchemes:
    apiKeyClientId:
      type: apiKey
      in: header
      name: X-Client-Id
      description: >-
        Credential client id (`kairos_ck_...`). Must be sent together with
        X-Api-Key and X-Api-Secret.
    apiKeyKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: 64-char hex API key.
    apiKeySecret:
      type: apiKey
      in: header
      name: X-Api-Secret
      description: 64-char hex API secret.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.