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

# Get multilevel referral config

> **Limit: 1 request per second**

`GET /v1/referral/multi_level/admin`

Returns the multilevel referral configuration. Restricted to Admin users only.




## OpenAPI

````yaml orderly.openapi get /v1/referral/multi_level/admin
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /v1/referral/multi_level/admin:
    get:
      tags:
        - private
      summary: Get multilevel referral config
      description: >
        **Limit: 1 request per second**


        `GET /v1/referral/multi_level/admin`


        Returns the multilevel referral configuration. Restricted to Admin users
        only.
      parameters:
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMultiLevelAdminConfigResponse'
      deprecated: false
components:
  parameters:
    orderly_timestamp:
      name: orderly-timestamp
      in: header
      description: Timestamp of the signed request in milliseconds.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: '1649920583000'
    orderly_account_id:
      name: orderly-account-id
      in: header
      description: Account ID of the authenticated account.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: 6.858456565150415e+75
    orderly_key:
      name: orderly-key
      in: header
      description: Public orderly key used to sign the request.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX
    orderly_signature:
      name: orderly-signature
      in: header
      description: Signature of the request payload generated with the orderly key.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: >-
        dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ==
  schemas:
    GetMultiLevelAdminConfigResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          properties:
            data:
              type: object
              properties:
                enable:
                  type: boolean
                  example: true
                required_volume:
                  type: number
                  example: 1000
                max_rebate_rate:
                  type: number
                  deprecated: true
                  description: Legacy response field. Use `bonus_max_rebate_rate`.
                  example: 0.4
                bonus_max_rebate_rate:
                  type: number
                  description: Preferred response field for the maximum bonus rebate rate.
                  example: 0.4
                direct_bonus_rebate_rate:
                  type: number
                  deprecated: true
                  description: Legacy response field. Use `base_rebate_rate`.
                  example: 0.1
                base_rebate_rate:
                  type: number
                  description: >-
                    Preferred response field for the base rebate rate paid to
                    the direct referrer.
                  example: 0.1
                rebate_basis_mode:
                  type: string
                  description: >-
                    Rebate calculation basis for the builder. `BUILDER_REVENUE`
                    always uses builder revenue.
                    `EFFECTIVE_TRADE_FEE_WITH_FALLBACK` uses the standard gross
                    trading fee, excluding additional module fees, custom
                    per-order fees, and other fees added on top; if the
                    requested total commission exceeds builder revenue, the
                    calculation falls back to builder revenue for that trade.
                  enum:
                    - BUILDER_REVENUE
                    - EFFECTIVE_TRADE_FEE_WITH_FALLBACK
                  example: BUILDER_REVENUE
    BasicResponse:
      required:
        - success
      type: object
      properties:
        success:
          description: Indicates whether the request was successful.
          type: boolean
          example: true
        timestamp:
          description: Server timestamp in milliseconds.
          type: integer
          example: 1702989203989

````