Vertex Docs
  • Getting Started
    • šŸ“‹Overview
    • šŸ“œTable of Contents
    • šŸš€Mission
    • āš”ļøVertex Edge
      • 1ļøāƒ£Vertex on Arbitrum
      • 2ļøāƒ£Blitz on Blast
        • Blitz Documentation
      • 3ļøāƒ£Vertex on Mantle
        • šŸŽ†Trading Rewards
        • šŸ“ŠPerpetual & Spot Market Specifications
        • šŸ–„ļøOpen-Source Contracts
        • šŸ”ŒAPI
      • 4ļøāƒ£Vertex on Sei
        • šŸ’°Trading Rewards
        • šŸ“ŠPerpetual & Spot Market Specifications
        • šŸ–„ļøOn-Chain Contracts
        • šŸ”ŒAPI
      • 5ļøāƒ£Vertex on Base
        • šŸ’°Trading Rewards
        • šŸ“ŠPerpetual & Spot Market Specifications
        • šŸ’»Onchain Contracts
        • šŸ”ŒAPI
        • āœļøCreate a Coinbase Smart Wallet
      • 6ļøāƒ£Vertex on Sonic
        • šŸ’°Trading Rewards
        • šŸ“ŠPerpetual & Spot Market Specifications
        • ā›“ļøOn-Chain Contracts
        • šŸ”ŒAPI
      • 7ļøāƒ£Vertex on Abstract
        • šŸ“ŠMarket Specifications
        • ā›“ļøOn-Chain Contracts
        • šŸ”ŒAPI
      • 8ļøāƒ£Bro.Trade on Berachain
        • ā›“ļøOn-Chain Contracts
        • šŸ”ŒAPI
      • 9ļøāƒ£Vertex on Avalanche
        • šŸ’°Trading Rewards
        • šŸ“ŠMarket Specifications
        • ā›“ļøOn-Chain Contracts
        • šŸ”ŒAPI
  • Basics
    • šŸ“½ļøProducts
    • ⚔Technical Architecture
    • 🧵Universal Cross Margin
    • āœ‚ļøIsolated Margin
    • ā„¹ļøSubaccounts & Health
    • ā°Liquidations & Insurance Fund
    • šŸ’µPnL Settlements
    • šŸ“ŠPricing (Oracles)
    • šŸ’°Fees
    • šŸ“ˆFunding Rates
    • šŸ“…Market Specifications
    • ⚔One-Click Trading
    • šŸ”«Trigger Orders
    • šŸ—‚ļøGMCI 30 & MEME Indices
    • šŸ’°Trade & Earn
      • šŸ¤Maker Program
      • šŸ”Cross-Chain VRTX Rewards
      • ā“Trading Rewards - FAQs
    • šŸ§‘ā€šŸ¤ā€šŸ§‘Referral Program
    • āš’ļøResources & Links
    • ā”FAQs
  • VRTX Token
    • šŸŽ“VRTX Tokenomics
    • šŸ“ŠToken Supply Distribution
  • More
    • 🌐Glossary
    • šŸ”¬Contracts & Code Audits
    • šŸ¦‹Bug Bounties
    • šŸ’½Data & Research
    • 🪟Maintenance Windows
    • šŸTerms of Use
    • āœļøStatement of Risk
    • šŸŒRestricted Territories
    • šŸ“øBrand Assets
  • Tutorials
    • šŸQuick Start
    • šŸ–±ļøOne-Click Trading
    • āš™ļøTrading Basics
    • ā™¾ļøPerpetuals
    • šŸ”®Spot
    • šŸ§‘ā€šŸ¤ā€šŸ§‘Multiple Accounts
    • šŸ”«TP/SL & Stop-Market
    • šŸ’°Withdrawals
    • ⚔Fast Withdrawals
    • šŸŒ‰Cross-Chain Deposits
    • šŸ”„Lend, Borrow & Repay
    • ā¤ļøMargin Health
    • šŸ’§Pools
    • šŸ’«VRTX Staking
    • ā†”ļøSwitching Chains
    • šŸŖ™Trading Rewards
    • āœ‚ļøShortcuts
  • Developer Resources
    • API
      • šŸ”ŒEndpoints
      • Gateway
        • Executes
          • Place Order
          • Place Isolated Order
          • Cancel Orders
          • Cancel Product Orders
          • Cancel And Place
          • Withdraw Collateral
          • Transfer Quote
          • Liquidate Subaccount
          • Mint LP
          • Burn LP
          • Link Signer
        • Queries
          • Status
          • Contracts
          • Nonces
          • Order
          • Orders
          • Subaccount Info
          • Isolated Positions
          • Market Liquidity
          • Symbols
          • All Products
          • Edge All Products
          • Market Prices
          • Max Order Size
          • Max Withdrawable
          • Max LP Mintable
          • Fee Rates
          • Health Groups
          • Linked Signer
          • Insurance
          • Min Deposit Rates
        • Signing
          • Examples
          • Q&A
      • Subscriptions
        • Authentication
        • Streams
        • Events
        • Rate limits
      • Archive (indexer)
        • Orders
        • Matches
        • Events
        • Summary
        • Candlesticks
        • Edge Candlesticks
        • Funding Rate
        • Interest & funding payments
        • Oracle Price
        • Perp Prices
        • Product Snapshots
        • Market Snapshots
        • Edge Market Snapshots
        • Maker Statistics
        • Merkle Proofs
        • Rewards
        • Referral Code
        • Liquidation Feed
        • Linked Signer Rate Limit
        • Subaccounts
        • Signatures
        • USDC Price
      • Trigger
        • Executes
          • Place Order
          • Cancel Orders
          • Cancel Product Orders
        • Queries
          • List Trigger Orders
      • V2
        • Assets
        • Pairs
        • APR
        • Orderbook
        • Tickers
        • Contracts
        • Trades
        • VRTX Token
      • Rate limits
      • Errors
      • Symbols
      • Depositing
      • Withdrawing (on-chain)
      • Integrate via Smart Contracts
      • Definitions / Formulas
    • Vertex Typescript SDK
      • Getting Started
      • How To
        • Create a Vertex client
        • Useful Common Functions
        • Query Markets & Products
        • Deposit Funds
        • Withdraw Funds
        • Manage Orders
      • User Guide
        • Client
          • Market
            • Place Order
            • Cancel Orders
            • Cancel Product Orders
            • Mint LP
            • Burn LP
            • Get All Markets
            • Get Latest Market Price
            • Get Market Liquidity
            • Get Open Subaccount orders
            • Get Historical Orders
            • Get Max Order Size
            • Get Max Mint LP
            • Get Candlesticks
            • Get Funding Rate
            • Get Product Snapshots
          • Spot
            • Approve Allowance
            • Deposit
            • Withdraw
            • Get Max Withdrawable
            • Get Token Contract for Product
            • Get Token Wallet Balance
            • Get Token Allowance
          • Perp
            • Get prices
          • Subaccount
            • Link Signer
            • Get Subaccount Linked Signer with Rate limits
            • Get Subaccount Summary
            • Get Subaccount Fee Rates
            • Get Subaccount Token Rewards
        • Engine Client
          • Executes
          • Queries
        • Indexer Client
          • Base Queries
          • Paginated Queries
        • Websocket
          • Executes
          • Queries
          • Subscriptions
        • Utilities
          • Contracts
          • Utils
      • API Reference
    • Vertex Python SDK
    • Vertex Rust SDK
    • Contracts
    • API/SDK Terms of Use
Powered by GitBook
On this page
  • Account Value
  • Perpetual Settlements – Settled & Unsettled USDC
Export as PDF
  1. Basics

PnL Settlements

Open position settlement and account value calculations.

PnL means ā€œprofit and loss.ā€ This metric is the current market value of a position minus the cost to open the position.

PnL=MarketĀ Valueāˆ’Cost{PnL} = \text{Market Value} - \text{Cost}PnL=MarketĀ Valueāˆ’Cost

On Vertex, you will find two PnL metrics:

  • Perp PnL = Your total PnL across all open perpetual positions.

  • Position PnL = A specific position’s PnL.

Perp PnL can be viewed by visiting the Vertex app pages:

  • Portfolio Overview

  • Perpetual Positions

Position PnL can be found in the Perp Positions tables on the Vertex app.

Users can also use Account Pins to pin Perp PnL to the top of their Vertex app screen and monitor across different page views.

Account Value

It is important to note:

Account Value does NOT equate to [ Assets - Borrows +/- Perp PnL ]

Instead:

AccountĀ Value=Assetsāˆ’Borrows±UnsettledĀ USDC\text{Account\ Value} = \text{Assets} - \text{Borrows} \pm \text{Unsettled USDC}AccountĀ Value=Assetsāˆ’Borrows±UnsettledĀ USDC

Balances will change constantly as USDC is automatically settled on the backend from perpetual trading into balances.

Eventually:

TotalĀ Settlements=PerpĀ PnL\text{Total\ Settlements} = \text{Perp\ PnL}TotalĀ Settlements=PerpĀ PnL

There is no economic effect to traders, BUT Assets and Borrows will change over time as PnL is settled. This process is covered in more depth below.

Perpetual Settlements – Settled & Unsettled USDC

First, it’s important to define two types of open positions within the context of settlement on Vertex.

  1. Winners: Open positions with positive PnL.

  2. Losers: Open positions with negative PnL.

A settlement happens when there is a transfer of USDC from Losers to Winners. At this point, balances are altered accordingly.

Since this process is happening continuously, the lifetime PnL of a perpetual trade can be broken down into two parts:

  • Unsettled USDC

  • Settled USDC

Unsettled USDC = USDC that is yet to be transferred between accounts.

  • If positive, users can expect the displayed amount to be deposited into their USDC balance.

  • If negative, users can expect the displayed amount to be removed from their USDC balance.

This happens continuously and automatically while holding an open position. There is no action required by users.

Settled USDC = PnL that has already been transferred to the current USDC balance on the Portfolio Overview page on the Vertex app.

Users can view their Unsettled USDC balance by clicking on the icon beside Perp PnL. There is also an Unsettled column in the Balances Table that displays it.

This will vary up and down depending on the volatility of positions. It is NOT necessarily related to the lifetime PnL of positions.

For example, a positive PnL CAN have a negative settlement, and a negative PnL CAN have a positive settlement, depending on how long the positions are held and how much they move.

Settlement History can be viewed by navigating on the Vertex app UI to:

  • Portfolio → History → Settlements Table

Closing a Position -- Settlements are automatic when closing a trade, and any remaining unsettled USDC will be realized into the USDC balance. When closing a position, any remaining unsettled USDC will be settled into the trader's USDC balance. This settlement will normally occur within a few minutes.

Changing USDC Balances -- Users with open positions will notice changes in USDC balances over time. This is due to PnL being settled on the backend. It is normal behavior and will not affect the ability to trade.

What if users don’t have USDC and have negative PnL? PnL will continue to settle. Users without USDC but positive account health will borrow USDC automatically.

Users are advised to keep note of the above as they manage risk.

PreviousLiquidations & Insurance FundNextPricing (Oracles)

Last updated 3 months ago

šŸ’µ
Page cover image