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

# Get platform fee configuration

> The platform's default fee rate and the fee period currently in force. Use it for fee disclosures, not for signing: a market can carry its own rate, so the `feeRateBps` in every signed order must be that market's `feeTakerBps` from `GET /api/markets/{slug}`. Both legs of a fill are charged, so `feeMakerBps` always equals `feeTakerBps`. See [Fees](/concepts/trading/fees).

Public, no authentication. Cacheable for 60 seconds. `GET /api/platform/notices`, `/status`, `/contracts` and `/fee-config` share one rate limit of 600 requests per minute per IP; `GET /api/platform/maintenance` is limited separately.



## OpenAPI

````yaml /api-reference/openapi.json get /api/platform/fee-config
openapi: 3.1.0
info:
  title: PredictStreet API
  description: >-
    Client-facing HTTP API for the PredictStreet prediction-market platform.
    **Partner kinds.** Every authenticated endpoint resolves a request's
    *effective wallet* from the partner row. `single_wallet` partners bind to
    one `associatedWallet` set at creation. `multi_wallet` partners declare the
    actor on every request via an `X-User-Wallet: 0x<40-hex>` header. See the
    [Partner kinds](/auth/api-keys#partner-kinds) doc for the full contract.
  version: '2026-06-16'
  contact:
    name: PredictStreet partners
    email: partners@predictstreet.com
servers:
  - url: https://core.api.dev.predictstreet.sde.adifoundation.ai
    description: Testnet (partner integrator API — final domain TBD)
security: []
tags:
  - name: Deposits
    description: >-
      Gasless USDC deposit relay - submit a signed EIP-2612 permit and the
      platform broadcasts the on-chain deposit for you (no gas).
  - name: Events
    description: >-
      Polymarket-style event grouping with football metadata (group, stage,
      teams, tags).
  - name: Tags
    description: Curated tag taxonomy used to filter events.
  - name: Markets
    description: 'Public market data: list, detail, orderbook, trades, OHLC.'
  - name: Crypto
    description: >-
      Crypto price markets: the underlying-asset price curve and Up/Down series
      navigation. The markets themselves are ordinary binary markets — list them
      through /api/markets and /api/events.
  - name: Orders
    description: >-
      Signed-order place / cancel / read. Requires `X-Api-Key` with
      `orders:read` / `orders:write` scope; every write additionally requires an
      EIP-712 signature over the order.
  - name: Portfolio
    description: >-
      Balances, positions, trades, fees, vault info for the key's
      `associatedWallet`. Requires `X-Api-Key` with `portfolio:read` scope.
  - name: Matches
    description: >-
      A match groups several events into one fixture/card (1X2 + first-scorer +
      over-under under one matchup).
  - name: Vault
    description: >-
      Backend co-signatures for ERC-1155 split / merge, and recovery for
      off-chain locks when the corresponding chain tx never confirmed. Requires
      `X-Api-Key` with `vault:write` scope plus an EIP-712 signature over the
      operation.
  - name: Leaderboard
    description: Public ranked leaderboard across PnL / volume buckets.
  - name: Search
    description: Global search across users, events, and matches.
  - name: Withdrawal Security
    description: >-
      Self-service withdrawal 2FA (TOTP) and withdrawal-address whitelist. Same
      endpoints serve the web app (user sessions) and API-key integrators.
      Mutations need `vault:write`, reads `portfolio:read`. Both are opt-in per
      wallet and only gate withdrawals once the platform enables
      withdrawal-security enforcement.
  - name: Platform
    description: >-
      Public platform state: the contract registry, the platform fee
      configuration, the platform freeze flag and active notices. No
      authentication.
paths:
  /api/platform/fee-config:
    get:
      tags:
        - Platform
      summary: Get platform fee configuration
      description: >-
        The platform's default fee rate and the fee period currently in force.
        Use it for fee disclosures, not for signing: a market can carry its own
        rate, so the `feeRateBps` in every signed order must be that market's
        `feeTakerBps` from `GET /api/markets/{slug}`. Both legs of a fill are
        charged, so `feeMakerBps` always equals `feeTakerBps`. See
        [Fees](/concepts/trading/fees).


        Public, no authentication. Cacheable for 60 seconds. `GET
        /api/platform/notices`, `/status`, `/contracts` and `/fee-config` share
        one rate limit of 600 requests per minute per IP; `GET
        /api/platform/maintenance` is limited separately.
      operationId: PlatformController_feeConfig
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformFeeConfigDto'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - {}
components:
  schemas:
    PlatformFeeConfigDto:
      type: object
      description: Platform-wide default fee configuration.
      properties:
        currentPeriod:
          type: string
          enum:
            - PRE_WC
            - WC
            - POST_WC
          description: >-
            Fee period currently in force. A label for fee disclosures; the rate
            itself is `feeTakerBps`.
          example: PRE_WC
        feeTakerBps:
          type: integer
          description: >-
            Platform default fee rate in basis points (`k = feeTakerBps /
            10_000` in the [fee formula](/concepts/trading/fees)). A market can
            override it, so sign each order with that market's own
            `feeTakerBps`, not with this value.
          example: 140
        feeMakerBps:
          type: integer
          description: >-
            Always equal to `feeTakerBps`. Both legs of a fill — maker and taker
            — are charged at the rate signed into the order, so there is no
            zero-fee maker leg.
          example: 140
        updatedAt:
          type: string
          format: date-time
          description: ISO-8601 — when the platform fee configuration was last changed.
      required:
        - currentPeriod
        - feeTakerBps
        - feeMakerBps
        - updatedAt
    Error:
      type: object
      description: >-
        Error body returned by every API error (same shape as `ErrorEnvelope`).
        Branch on `error.code`, not on `message`.
      required:
        - status
        - error
      properties:
        status:
          type: integer
          description: HTTP status, repeated in the body.
          example: 404
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: >-
                Machine-readable code (e.g. `market_not_found`,
                `event_not_found`, `invalid_limit`).
            message:
              type: string
            trace_id:
              type: string
              description: Request trace id; quote it to support. May be absent.
            retryAfterSec:
              type: integer
              description: >-
                Seconds to wait before retrying, when the server says so (also
                sent as the `Retry-After` header).
            retryable:
              type: boolean
              description: >-
                Whether the same request may be sent again as it is. Absent when
                the server does not say.
            details:
              type: object
              additionalProperties: true
              description: >-
                Extra structured context thrown with the error, e.g. `slug`,
                `allowed`, `auditId`.
  responses:
    RateLimited:
      description: >-
        Rate limit exceeded. `Retry-After` and `X-RateLimit-Reset` headers are
        set.
      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:
            $ref: '#/components/schemas/Error'

````

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