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

# Get Trending Pools with Risk Analysis

> Retrieves current trending liquidity pools with comprehensive risk analysis for the pools and their associated tokens. Data is refreshed every 24 hours.



## OpenAPI

````yaml GET /tokens/pools/trending
openapi: 3.0.1
info:
  title: Risk Score API
  description: API definition for Webacy Risk Scores
  version: 1.2.0
servers:
  - url: https://api.webacy.com
    description: Webacy Risk Score API (Production)
  - url: https://api-development.webacy.com
    description: Webacy Risk Score API (Development)
  - url: http://0.0.0.0:3030/api/v1/risk-score
    description: Webacy Risk Score API - Local
security:
  - api_key: []
tags:
  - name: Threat Risks
    description: Analyze addresses for security threats and malicious activity
  - name: Sanction Checks
    description: Check addresses against OFAC and other sanction lists
  - name: Approval Risks
    description: Analyze token approvals and associated risks
  - name: Transaction Risks
    description: Assess risk details for blockchain transactions
  - name: Exposure Risk
    description: Understand risk profile and exposure of addresses
  - name: Contract Risk
    description: Real-time smart contract security analysis
  - name: URL Risks
    description: Analyze URLs for phishing and security threats
  - name: API Usage
    description: Monitor and manage API consumption
  - name: Holder Analysis
    description: Token holder distribution and sniper detection
  - name: Address Poisoning
    description: Detect address poisoning attack patterns
  - name: Token Analysis
    description: Comprehensive token security and market analysis
  - name: Pool Analysis
    description: Liquidity pool data and analysis
  - name: Transaction Scanning
    description: Scan and simulate transactions for risks
  - name: trading-lite
    description: Lightweight trading risk assessment
  - name: RWA & Pegged Tokens
    description: >-
      Real-world asset and pegged-token analytics (supply flows, mint/burn
      velocity)
  - name: Vault Risk v3
    description: >-
      Webacy-native v3 vault risk surface — composite grade, categories,
      coverage, and the framework taxonomy (RFC-019).
  - name: RWA Risk v3
    description: >-
      Webacy-native v3 RWA / stablecoin risk surface — composite grade,
      structural-health criteria, and batch (RFC-019).
paths:
  /tokens/pools/trending:
    get:
      tags:
        - Pool Analysis
      summary: Get Trending Pools with Risk Analysis
      description: >-
        Retrieves current trending liquidity pools with comprehensive risk
        analysis for the pools and their associated tokens. Data is refreshed
        every 24 hours.
      operationId: getTrendingPools
      parameters:
        - in: query
          name: chain
          description: >-
            Blockchain network to get trending pools from. Supported chains for
            pool analysis include Ethereum, Base, Binance Smart Chain, Polygon,
            Optimism, Arbitrum, and Solana
          required: true
          schema:
            $ref: '#/components/schemas/TokensChains'
      responses:
        '200':
          description: >-
            Success - Returns trending pools with risk assessments for pools and
            associated tokens
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrendingPoolsRiskResponse'
        '400':
          description: Bad Request - Invalid chain parameter
          content:
            application/json:
              example:
                message: Invalid or unsupported chain specified
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              example:
                message: Rate limit exceeded. Please try again later.
        '500':
          description: Internal Server Error - Service unavailable or other issues
          content:
            application/json:
              example:
                message: Unable to fetch trending pools data. Please try again later.
      security:
        - api_key: []
components:
  schemas:
    TokensChains:
      type: string
      enum:
        - eth
        - base
        - bsc
        - pol
        - opt
        - arb
        - sol
        - ton
        - sei
        - btc
        - sui
      description: >-
        Blockchain networks supported for token analysis, pools, and market data
        operations
    TrendingPoolsRiskResponse:
      type: object
      properties:
        pools:
          type: array
          description: List of trending liquidity pools
          items:
            $ref: '#/components/schemas/TrendingPoolData'
        tokens:
          type: array
          description: Risk and metadata information for tokens in the pools
          items:
            type: object
            properties:
              address:
                type: string
                description: Address of the token
                example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
              risk:
                type: object
                description: Risk assessment data for the token
                properties:
                  count:
                    type: integer
                    description: Number of risk factors identified
                    example: 1
                  medium:
                    type: integer
                    description: Number of medium risk factors
                    example: 0
                  high:
                    type: integer
                    description: Number of high risk factors
                    example: 0
                  overallRisk:
                    type: number
                    description: Overall risk score
                    example: 0
                  issues:
                    type: array
                    description: List of identified risk issues
                    items:
                      type: object
                      properties:
                        score:
                          type: integer
                          description: Risk score for this issue
                          example: 1
                        tags:
                          type: array
                          description: Risk tags associated with this issue
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                example: Low Liquidity
                              description:
                                type: string
                                example: Token has low trading liquidity
              metadata:
                type: object
                description: Token metadata information
                properties:
                  name:
                    type: string
                    example: USD Coin
                  symbol:
                    type: string
                    example: USDC
                  decimals:
                    type: integer
                    example: 6
            required:
              - address
              - risk
      required:
        - pools
        - tokens
    TrendingPoolData:
      type: object
      properties:
        address:
          type: string
          description: Contract address of the pool
          example: '0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8'
        name:
          type: string
          description: Name of the liquidity pool
          example: USDC/ETH
        fdv:
          type: string
          description: Fully diluted valuation in USD
          example: '1000000000'
        base_token:
          type: string
          description: Address of the base token in the pool
          example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
        quote_token:
          type: string
          description: Address of the quote token in the pool
          example: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
        market_cap:
          type: string
          description: Market capitalization in USD
          example: '500000000'
        reserve:
          type: string
          description: Pool reserves in USD
          example: '1000000'
        created_at:
          type: string
          description: Pool creation timestamp
          example: '2023-01-15T10:30:00Z'
        token_price:
          type: string
          description: Current token price in USD
          example: '1.25'
        base_token_price:
          type: string
          description: Price of the base token in USD
          example: '1.00'
        quote_token_price:
          type: string
          description: Price of the quote token in USD
          example: '2500.50'
        volume:
          type: object
          description: Trading volume in USD
          properties:
            h1:
              type: string
              description: Trading volume in the last 1 hour
              example: '50000'
            h6:
              type: string
              description: Trading volume in the last 6 hours
              example: '250000'
            m5:
              type: string
              description: Trading volume in the last 5 minutes
              example: '5000'
            h24:
              type: string
              description: Trading volume in the last 24 hours
              example: '1000000'
            m15:
              type: string
              description: Trading volume in the last 15 minutes
              example: '15000'
            m30:
              type: string
              description: Trading volume in the last 30 minutes
              example: '25000'
          required:
            - h1
            - h6
            - m5
            - h24
            - m15
            - m30
      required:
        - address
        - name
        - fdv
        - base_token
        - quote_token
        - market_cap
        - reserve
        - created_at
        - token_price
        - base_token_price
        - quote_token_price
        - volume
  responses:
    UnauthorizedError:
      description: Authorization information is missing or invalid
      content:
        application/json:
          example:
            message: Unauthorized
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````