> ## 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.

# Request PnL settlement

> **Limit: 1 requests per 1 second**

`POST /v1/settle_pnl`

`verifyingContract` should use: `0x6F7a338F2aA472838dEFD3283eB360d4Dff5D203`.




## OpenAPI

````yaml orderly.openapi post /v1/settle_pnl
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/settle_pnl:
    post:
      tags:
        - private
      summary: Request PnL settlement
      description: >
        **Limit: 1 requests per 1 second**


        `POST /v1/settle_pnl`


        `verifyingContract` should use:
        `0x6F7a338F2aA472838dEFD3283eB360d4Dff5D203`.
      parameters:
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SettlePnlBody'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettlePnlResponse'
              examples:
                '1':
                  summary: Successful examples
                  value:
                    success: true
                    data:
                      settle_pnl_id: 889
                    timestamp: 1692246987774
      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:
    SettlePnlBody:
      required:
        - signature
        - userAddress
        - verifyingContract
        - message
      type: object
      properties:
        signature:
          type: string
          description: The signature generated by signing the message object via EIP-712
        userAddress:
          type: string
          description: The address of the wallet signing the message object via EIP-712
        verifyingContract:
          type: string
          description: Address of the Orderly ledger contract
        message:
          type: object
          description: >-
            Message object containing the message that is signed by the wallet
            owner
          required:
            - brokerId
            - chainId
            - settleNonce
            - timestamp
          properties:
            brokerId:
              type: string
              description: Builder ID
            chainId:
              type: integer
              description: >-
                Chain ID of registering chain (within those that are supported
                by the Network)
            chainType:
              type: string
              description: >-
                Chain type of the signing wallet. Supported values are `EVM` and
                `SOL`.
            settleNonce:
              type: integer
              description: Nonce returned by Get Settle PnL Nonce.
            timestamp:
              type: integer
              description: current timestamp in UNIX milliseconds
    SettlePnlResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - settle_pnl_id
              properties:
                settle_pnl_id:
                  type: integer
                  example: 1
    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

````