> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List pools with advanced filters (v2)

> Advanced pool listing with cursor-based pagination. Cached 60–90 seconds.



## OpenAPI

````yaml /api-reference/openapi/api-v3.yaml get /pools/info/list-v2
openapi: 3.0.3
info:
  title: Raydium API v3
  version: 3.0.0
  description: >-
    The Raydium API v3 provides REST endpoints for querying liquidity pools,
    mint information, farm details, IDO pools, and chain metadata for the Solana
    blockchain. Used by wallets, aggregators, and traders to source price feeds,
    pool data, and routing information.
servers:
  - url: https://api-v3.raydium.io
    description: Production (Mainnet)
  - url: https://api-v3-devnet.raydium.io
    description: Development (Devnet)
security: []
tags:
  - name: Main
    description: Core API endpoints for chain info, TVL, and configuration
  - name: Mint
    description: Token mint information and pricing
  - name: Pools
    description: Liquidity pool info, keys, and historical data
  - name: Farms
    description: Farm pool information and keys
  - name: IDO
    description: IDO pool information and keys
paths:
  /pools/info/list-v2:
    get:
      tags:
        - Pools
      summary: List pools with advanced filters (v2)
      description: >-
        Advanced pool listing with cursor-based pagination. Cached 60–90
        seconds.
      operationId: getPoolsInfoListV2
      parameters:
        - name: poolType
          in: query
          required: false
          schema:
            type: string
            enum:
              - Concentrated
              - Standard
        - name: mintFilter
          in: query
          required: false
          schema:
            type: string
        - name: hasReward
          in: query
          required: false
          schema:
            type: boolean
        - name: sortField
          in: query
          required: false
          schema:
            type: string
            enum:
              - liquidity
              - volume24h
              - fee24h
              - apr24h
              - volume7d
              - fee7d
              - apr7d
              - volume30d
              - fee30d
              - apr30d
        - name: sortType
          in: query
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
        - name: size
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
            maximum: 1000
        - name: nextPageId
          in: query
          required: false
          schema:
            type: string
        - name: mint1
          in: query
          required: false
          schema:
            type: string
        - name: mint2
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/PoolListV2Response'
components:
  schemas:
    ApiResponse:
      type: object
      description: >-
        Common response envelope. The `data` field is supplied by each
        endpoint's response schema via `allOf` and is therefore not declared on
        the base envelope.
      required:
        - id
        - success
      properties:
        id:
          type: string
          description: Request ID (UUID)
        success:
          type: boolean
          description: Whether the request was successful
        msg:
          type: string
          description: Error message if success is false
    PoolListV2Response:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PoolInfoItem'
        nextPageId:
          type: string
          nullable: true
    PoolInfoItem:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        programId:
          type: string
        lpMint:
          type: string
        mint1:
          type: object
        mint2:
          type: object
        tvl:
          type: number
        lpPrice:
          type: number
        farmOngoingCount:
          type: number
        day:
          type: object
        week:
          type: object
        month:
          type: object

````