DegenHedge Fees API

openapi: 3.2.0
info:
  title: Degenhedge Com Fees API
  version: 1.2.0
  contact:
    name: DegenHedge
    url: https://degenhedge.com/api/
    email: team@degenhedge.com
  termsOfService: https://degenhedge.com/terms/
  description: 'Operations tagged fees across 2 of this provider''s published API definitions: degenhedge-com-openapi.json, degenhedge-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://degenhedge.com
tags:
- name: fees
paths:
  /api/kalshi-fee:
    get:
      operationId: getKalshiFee
      tags:
      - fees
      summary: Kalshi taker fee, total cost and breakeven for a price and order size
      description: Single-equivalent-fill estimate with explicit direct/non-direct balance precision, matching the website calculator. Price is in CENTS.
      parameters:
      - name: price
        in: query
        required: true
        description: Contract price in cents, 0.1 to 99.9 (whole cents between 10 and 90)
        schema:
          type: number
          minimum: 0.1
          maximum: 99.9
        example: 95
      - name: contracts
        in: query
        required: false
        description: Number of contracts, 1 to 100000 (default 1)
        schema:
          type: integer
          minimum: 1
          maximum: 100000
          default: 1
        example: 10
      - name: maker
        in: query
        required: false
        description: true for a resting (maker) order; KXBTC15M charges makers no fee
        schema:
          type: boolean
          default: false
      - name: balance_precision
        in: query
        required: false
        description: 'Balance precision in dollars: non-direct member 0.01 (default), direct member 0.0001. One equivalent fill, no prior order accumulator.'
        schema:
          type: string
          enum:
          - '0.01'
          - '0.0001'
          default: '0.01'
      responses:
        '200':
          description: Fee quote
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeQuote'
        '400':
          description: Invalid price or contracts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited (60 requests a minute per IP across /api/*; retry after a minute)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    servers:
    - url: https://degenhedge.com
components:
  schemas:
    FeeQuote:
      type: object
      required:
      - input
      - fee_cents
      - total_cost_cents
      - breakeven_win_rate_pct
      - fee_schedule
      - disclaimer
      properties:
        input:
          type: object
          required:
          - price_cents
          - contracts
          - order
          properties:
            price_cents:
              type: number
              description: Normalised price (tenths of a cent; whole cents between 10 and 90)
            contracts:
              type: integer
            order:
              type: string
              enum:
              - taker
              - maker
            balance_precision_dollars:
              type: string
              enum:
              - '0.01'
              - '0.0001'
        fee_cents:
          type: number
          description: Model fee plus balance rounding, in cents; may be fractional.
        fee_per_contract_cents:
          type: number
        total_cost_cents:
          type: number
        profit_if_win_cents:
          type: number
        loss_if_lose_cents:
          type: number
        breakeven_win_rate_pct:
          type: number
          description: Win rate needed to break even after the fee
        breakeven_before_fees_pct:
          type: number
        wins_needed_per_loss:
          type:
          - number
          - 'null'
          description: null when the fee takes the whole profit
        entry_price_bucket:
          type:
          - string
          - 'null'
        notes:
          type: array
          items:
            type: string
        fee_rule:
          type: string
        fee_schedule:
          type: object
          required:
          - fee_type
          - fee_multiplier
          - live
          properties:
            fee_type:
              type: string
            fee_multiplier:
              type:
              - number
              - string
            checked_at:
              type:
              - string
              - 'null'
            source:
              type: string
            live:
              type: boolean
            stale:
              type: boolean
        matches:
          type: string
          format: uri
        record_at_this_price:
          type: string
          format: uri
        disclaimer:
          type: string
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
        docs:
          type: string
        example:
          type: string
externalDocs:
  description: API docs
  url: https://degenhedge.com/api/
x-refined-from:
- degenhedge-com-openapi.json
- degenhedge-com-openapi.yml