Skip to main content

LP List

Overview

The Pools List page displays all available liquidity pools in the DeFi platform, allowing users to view and interact with different trading pairs.

Liquidity Pools Image

My Liquidity Positions

When a wallet is connected and the user has active liquidity positions, a dedicated carousel section appears at the top of the page, providing quick access to their existing pools.

Display Behavior

  • Visibility: Only appears when:
    • A wallet is connected to the platform
    • The user has at least one active liquidity position
  • Location: Positioned above the general pools table for easy access
  • Purpose: Quick overview of user's investments before browsing all available pools

The My Liquidity Positions section features:

  • Horizontal Scroll: Swipeable carousel for easy navigation through multiple positions
  • Navigation Arrows: Left/right arrows for desktop navigation
  • Card Design: Each pool displayed as a compact, informative card
  • Card Dimensions: 300px width × 120px height per card
  • Visual Style: Dark accent background with hover effects
  • Position Count: Header displays total number of positions (e.g., "My Liquidity Positions (3)")

Pool Card Information

Each liquidity position card displays comprehensive information:

Header Section

  • Token Icons: Overlapping avatars showing both tokens in the trading pair
  • Pool Name: Trading pair identifier (e.g., "KFI-KLV")
  • Smart Contract Address: Truncated contract address for reference (e.g., "klv1...mrmd")
  • APR: Annual Percentage Rate displayed prominently in primary color
  • My Position: Current value of user's position in USD (e.g., "$19.85")
  • Pool Tokens: Amount of LP (Liquidity Provider) tokens owned (e.g., "1.54 LP")

Data Sources

The carousel combines data from two sources:

  1. Portfolio API: Provides user-specific data
    • Position value in USD
    • LP tokens owned
    • Unclaimed rewards
  2. Pools API: Provides pool metadata
    • Token icons and names
    • Current APR
    • Pool contract address

This merged data ensures users see both their personal position details and current pool performance metrics.

User Interactions

Click to Navigate

  • Action: Click any pool card
  • Destination: Redirects to pool details page (/pools/{scAddress}/add)
  • Purpose: Allows users to:
    • Add more liquidity to existing position
    • View detailed pool information
    • Access pool management options

Key Differences: My Positions vs All Pools

FeatureMy Liquidity PositionsAll Pools Table
VisibilityWallet connected + positionsAlways visible
Display FormatHorizontal carouselVertical table
Data FocusUser's personal positionsAll available pools
Information ShownPosition value, LP tokensPool TVL, general APR
SearchableNoYes
SortableNoYes (by name, value, APR)
User-specific Data✅ Shows personal metrics❌ General pool info only

Benefits

  1. Quick Access: Immediately see all positions without navigating to portfolio
  2. At-a-Glance Value: Track total invested liquidity across pools
  3. Performance Monitoring: Compare APRs of current positions
  4. Easy Management: One-click access to add more liquidity
  5. Visual Organization: Carousel format prevents page clutter

Search Functionality

  • Search bar located at the top of the table
  • Placeholder text: "Search by name or symbol"
  • Real-time filtering as users type
  • Case-insensitive search

Pools Table

The All Pools table displays every available liquidity pool on the platform, allowing users to discover new opportunities beyond their existing positions.

Table Structure

  • Name column: Displays pool pair names (e.g., KFI-KLV) with token icons
  • Value column: Shows pool's total value in USD
  • APR column: Displays Annual Percentage Rate

Table Features

  • Clickable rows for pool selection
  • Pagination with 10 items per page
  • Navigation controls (Previous/Next)

Pool Entry Information

Each pool entry displays:

  • Pool pair icons
  • Trading pair name
  • Pool contract address (truncated)
  • Current pool value in USD
  • Current APR percentage

User Interactions

  1. Pool Selection

    • Users can click any pool row to access the liquidity provision interface
    • Selection redirects to the pool's detailed page
  2. Search and Filter

    • Users can search pools by name or symbol
    • Results update in real-time as users type
  3. Pagination

    • Users can navigate between pages
    • Option to select number of rows per page

Table Data Example

NameValueAPR
KFI-KLV$1,483.585.00%
FRG-KLV$89.784.50%
ROY-KLV$167.3112.00%