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

# Add delegate signer Orderly key

> **Limit: 1 requests per second**

`POST /v1/delegate_orderly_key`

Adds an orderly key for a delegate signer after the delegate relationship has been authorized.




## OpenAPI

````yaml orderly.openapi post /v1/delegate_orderly_key
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/delegate_orderly_key:
    post:
      tags:
        - public
      summary: Add delegate signer Orderly key
      description: >
        **Limit: 1 requests per second**


        `POST /v1/delegate_orderly_key`


        Adds an orderly key for a delegate signer after the delegate
        relationship has been authorized.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DelegateOrderlyKeyBody'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderlyKeyResponse'
      deprecated: false
components:
  schemas:
    DelegateOrderlyKeyBody:
      type: object
      required:
        - message
        - signature
        - userAddress
      properties:
        message:
          type: object
          required:
            - delegateContract
            - brokerId
            - chainId
            - expiration
            - orderlyKey
            - scope
            - timestamp
          properties:
            delegateContract:
              type: string
              description: Delegate contract address authorized to act for the account.
            brokerId:
              type: string
              description: Builder ID
            chainId:
              type: integer
              description: >-
                Chain ID of registering chain (within those that are supported
                by the Network)
            orderlyKey:
              type: string
              description: orderly key to be added
            scope:
              type: string
              description: >-
                Valid scopes are `read`, `trading`, and `asset`. Multiple scopes
                can be sent as a comma-separated string such as `read,trading`.
            timestamp:
              type: number
              description: timestamp in UNIX milliseconds
            expiration:
              type: number
              description: >-
                Expiration time of the key in UNIX milliseconds. The maximum
                allowed expiration is 365 days from creation.
          description: >-
            Message object containing the message that is signed by the wallet
            owner
        signature:
          type: string
          description: Signature generated by signing the message object.
        userAddress:
          type: string
          description: Address of the wallet that signed the message object.
    OrderlyKeyResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - orderly_key
              properties:
                id:
                  description: Internal ID of the created orderly key record.
                  type: integer
                  example: 123
                orderly_key:
                  description: orderly key added to the account.
                  type: string
                  example: ed25519:FRXntsPJBCy6dzKv9WPw4eYSw3rKU9Npz3T6UmvvJc9Z
    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

````