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
    • 💰Deposits - Powered by Fun.xyz
    • ⚙️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
        • Subaccount Snapshots
        • 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 4 months ago

Page cover image