> ## Documentation Index > Fetch the complete documentation index at: https://docs.lpagent.io/llms.txt > Use this file to discover all available pages before exploring further. # Discover pools > Retrieve a list of pools with filtering, sorting, and pagination ## OpenAPI ````yaml /api-reference/openapi.json get /pools/discover openapi: 3.0.0 info: title: LP Agent Open API version: 1.0.0 description: |+ Public API for LP Agent **Authentication** All endpoints require an API key passed via the `x-api-key` header. servers: - url: https://api.lpagent.io/open-api/v1 description: Production security: - apiKeyAuth: [] tags: [] paths: /pools/discover: get: tags: - Pools summary: Discover pools description: Retrieve a list of pools with filtering, sorting, and pagination parameters: - in: query name: chain schema: type: string default: SOL description: The blockchain network - in: query name: sortBy schema: type: string enum: - mcap - created_at - vol_24h - tvl - fee_tvl_ratio - volatility default: mcap description: Field to sort pools by - in: query name: sortOrder schema: type: string enum: - asc - desc - default default: desc description: Sort order direction - in: query name: page schema: type: integer minimum: 1 default: 1 description: Page number for pagination - in: query name: pageSize schema: type: integer minimum: 1 maximum: 100 default: 10 description: Number of items per page - in: query name: feeTVLInterval schema: type: string enum: - 5m - 1h - 6h - 24h default: 24h description: Time interval for fee/TVL ratio calculation - in: query name: quote_token schema: type: string description: Filter by quote token address - in: query name: min_market_cap schema: type: number description: Minimum market cap filter - in: query name: max_market_cap schema: type: number description: Maximum market cap filter - in: query name: min_bin_step schema: type: number description: Minimum bin step filter - in: query name: max_bin_step schema: type: number description: Maximum bin step filter - in: query name: min_organic_score schema: type: number description: Minimum organic score filter - in: query name: max_organic_score schema: type: number description: Maximum organic score filter - in: query name: min_base_fee schema: type: number description: Minimum base fee filter - in: query name: max_base_fee schema: type: number description: Maximum base fee filter - in: query name: min_age_hr schema: type: number description: Minimum pool age in hours - in: query name: max_age_hr schema: type: number description: Maximum pool age in hours - in: query name: min_liquidity schema: type: number description: Minimum liquidity filter - in: query name: max_liquidity schema: type: number description: Maximum liquidity filter - in: query name: min_24h_fees schema: type: number description: Minimum 24h fees filter - in: query name: max_24h_fees schema: type: number description: Maximum 24h fees filter - in: query name: min_24h_vol schema: type: number description: Minimum 24h volume filter - in: query name: max_24h_vol schema: type: number description: Maximum 24h volume filter - in: query name: min_1h_vol schema: type: number description: Minimum 1h volume filter - in: query name: max_1h_vol schema: type: number description: Maximum 1h volume filter - in: query name: type schema: type: string default: all description: >- Pool type filter. `meteora` for dlmm and `meteora_damm_v2` for DAMM V2 - in: query name: search schema: type: string description: Search by pool name or token address responses: '200': description: Successfully retrieved pools content: application/json: schema: type: object properties: status: type: string example: success data: type: array items: type: object properties: pool: type: string description: Pool address example: 5rCfABCxyz123 tvl: type: number description: Total value locked example: 125000.5 fee: type: number description: Pool fee rate example: 0.003 protocol: type: string description: Protocol name example: meteora chain: type: string example: SOL token0: type: string description: Token X mint address example: So11111111111111111111111111111111111111112 token1: type: string description: Token Y mint address vol_5m: type: number description: Volume in last 5 minutes vol_1h: type: number description: Volume in last 1 hour vol_6h: type: number description: Volume in last 6 hours vol_24h: type: number description: Volume in last 24 hours example: 800000 base_price: type: number description: Base token price in USD example: 150.25 quote_price: type: number description: Quote token price in USD example: 1 mcap: type: number description: Market cap example: 50000000 usd_price: type: number description: Token USD price fdv: type: number description: Fully diluted valuation organic_score: type: number description: Organic trading score example: 75 top_holder: type: number description: Top holder percentage mint_freeze: type: boolean description: Whether mint/freeze authority is enabled price_5m_change: type: number description: Price change in last 5 minutes price_1h_change: type: number description: Price change in last 1 hour price_6h_change: type: number description: Price change in last 6 hours price_24h_change: type: number description: Price change in last 24 hours bin_step: type: number description: Bin step size example: 10 liquidity_token0: type: number description: Liquidity of token X liquidity_token1: type: number description: Liquidity of token Y created_at: type: string format: date-time description: Pool creation time updated_at: type: string format: date-time first_pool_created_at: type: string format: date-time token0_symbol: type: string nullable: true example: SOL token0_name: type: string nullable: true example: Solana token0_decimals: type: number nullable: true example: 9 token1_symbol: type: string nullable: true example: USDC token1_name: type: string nullable: true token1_decimals: type: number nullable: true token0_stats: type: object nullable: true description: Token X trading stats from Jupiter properties: volume: type: object properties: stats1h: type: object properties: volume: type: number volume_change: type: number stats6h: type: object properties: volume: type: number volume_change: type: number stats24h: type: object properties: volume: type: number volume_change: type: number holders: type: number token1_stats: type: object nullable: true description: Token Y trading stats from Jupiter pagination: type: object properties: currentPage: type: integer pageSize: type: integer totalCount: type: integer totalPages: type: integer hasNextPage: type: boolean hasPreviousPage: type: boolean '500': description: Internal server error components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: API key for authentication ````