> ## 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 Token Pools with Risk Assessment

> Retrieves liquidity pools associated with a token and provides risk assessments for each related token in those pools. This endpoint helps in understanding the liquidity landscape and potential risks within the token's ecosystem.



## OpenAPI

````yaml GET /tokens/{tokenAddress}/pools
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/{tokenAddress}/pools:
    get:
      tags:
        - Token Analysis
      summary: Get Token Pools with Risk Assessment
      description: >-
        Retrieves liquidity pools associated with a token and provides risk
        assessments for each related token in those pools. This endpoint helps
        in understanding the liquidity landscape and potential risks within the
        token's ecosystem.
      operationId: getTokenPools
      parameters:
        - name: tokenAddress
          in: path
          required: true
          description: Address of the token to analyze
          schema:
            type: string
          example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
        - in: query
          name: chain
          description: >-
            Blockchain network of the token. Supported chains for token analysis
            include Ethereum, Base, Binance Smart Chain, Polygon, Optimism,
            Arbitrum, and Solana
          required: true
          schema:
            $ref: '#/components/schemas/TokensChains'
      responses:
        '200':
          description: Success - Returns pools data with associated token risk information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PoolsRisk'
        '400':
          description: Bad Request - Invalid address format or chain parameter
          content:
            application/json:
              example:
                message: Invalid address format or unsupported chain
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          description: Not Found - Token or pools information not available
          content:
            application/json:
              example:
                message: No pools found for this token or token not found
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              example:
                message: Rate limit exceeded. 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
    PoolsRisk:
      type: object
      properties:
        pools:
          type: array
          description: List of liquidity pools associated with the token
          items:
            $ref: '#/components/schemas/NormalizedPoolData'
        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:
                $ref: '#/components/schemas/addresses'
                description: Risk assessment data for the token
              metadata:
                $ref: '#/components/schemas/TokenMetadata'
                description: Metadata information for the token
            required:
              - address
              - risk
      required:
        - pools
        - tokens
    NormalizedPoolData:
      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
        lockedLiquidityPercent:
          type: number
          minimum: 0
          maximum: 100
          description: >-
            Percentage of the pool's liquidity that is locked. Best-effort;
            omitted when lock data isn't detectable for the pool.
          example: 87.5
        lpHolderCount:
          type: integer
          description: Number of addresses holding the pool's LP tokens.
          example: 1532
        lpHolders:
          type: array
          description: >-
            Holders of the pool's LP tokens, including lock status for each
            holding.
          items:
            type: object
            properties:
              address:
                type: string
                description: Address of the LP-token holder
                example: '0x000000000000000000000000000000000000dead'
              balance:
                type: string
                description: LP-token balance held by the address
                example: '1250000000000000000'
              percent:
                type: number
                description: Percentage of the total LP-token supply held by the address
                example: 12.34
              isLocked:
                type: boolean
                description: Whether this holding is locked
                example: true
              lockedUntil:
                type: string
                description: Timestamp until which this holding is locked
                example: '2025-12-31T00:00:00Z'
              isContract:
                type: boolean
                description: Whether the holder address is a contract
                example: true
            required:
              - address
              - balance
              - percent
        issues:
          type: array
          description: Risk issues detected for the pool.
          items:
            $ref: '#/components/schemas/issueAddresses'
        poolType:
          type: string
          description: Type of the liquidity pool.
          example: v2
        positionHolderCount:
          type: integer
          description: Number of addresses holding a position in the pool.
          example: 842
      required:
        - address
        - name
        - fdv
        - market_cap
        - reserve
        - created_at
        - token_price
        - base_token_price
        - quote_token_price
        - volume
    addresses:
      type: object
      properties:
        analyzed_at:
          type: string
          format: date-time
          description: >-
            Timestamp (ISO 8601) of when this address was analyzed. Use this as
            the freshness signal for address risk — this endpoint does not
            return a `stale` flag.
          example: '2026-07-07T03:06:06.986Z'
        count:
          type: integer
          description: Number of transactions
          example: 1
        medium:
          type: integer
          description: Number of medium risk transactions
          example: 1
        high:
          type: integer
          description: Number of high risk transactions
          example: 0
        overallRisk:
          type: number
          description: Overall risk score
          example: 25.99
        issues:
          type: array
          description: List of issues found
          items:
            $ref: '#/components/schemas/issueAddresses'
        details:
          type: object
          description: Detailed analysis information
          properties:
            source_code_analysis:
              $ref: '#/components/schemas/AnalysisResponse'
            multiPlatformAnalysisData:
              $ref: '#/components/schemas/MultiPlatformAnalysisData'
        context:
          type: array
          description: >-
            Contextual information tags that are NOT security risks (e.g., paid
            DexScreener promotional info)
          items:
            $ref: '#/components/schemas/informationalTag'
        isContract:
          type: boolean
          description: >-
            Legacy field indicating if the address has bytecode deployed (true)
            or is an EOA (false). For more detailed classification, use
            addressType. Note: May be true for EIP-7702 delegated EOAs that have
            bytecode but are functionally EOAs. Optional for chains without
            smart contracts (e.g., BTC).
          example: false
        addressType:
          $ref: '#/components/schemas/AddressType'
          description: >-
            Detailed classification of the address type. Indicates whether the
            address is an EOA, smart contract, token, contract wallet, or other
            chain-specific type. For EIP-7702 delegated EOAs, this will be 'EOA'
            even if bytecode exists. May be undefined if classification is
            unavailable.
        tokenStandard:
          $ref: '#/components/schemas/TokenStandard'
          description: >-
            Token standard classification if the address represents a token
            contract (e.g., ERC20, ERC721, SPL). Only populated for token
            addresses. May be undefined for non-token addresses or if standard
            cannot be determined.
    TokenMetadata:
      type: object
      properties:
        name:
          type: string
          description: Name of the token
          example: USD Coin
        symbol:
          type: string
          description: Symbol of the token
          example: USDC
        contract_address:
          type: string
          description: Contract address of the token
          example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
        chain:
          type: string
          description: The blockchain network where the token resides
          example: eth
        other_chains:
          type: array
          description: List of other chains where this token is deployed
          items:
            type: object
            properties:
              chain:
                type: string
                description: Network identifier
                example: pol
              contract_address:
                type: string
                description: Token address on this network
                example: '0x2791bca1f2de4661ed88a30c99a7a9449aa84174'
        decimals:
          type: integer
          description: Number of decimal places
          example: 6
        links:
          type: object
          description: External resources related to the token
          properties:
            homepage:
              type: string
              description: Project website URL
              example: https://www.circle.com/en/usdc
            github:
              type: array
              description: GitHub repository URLs
              items:
                type: string
              example:
                - https://github.com/centrehq
            twitter:
              type: string
              description: Twitter profile URL
              example: https://twitter.com/circle
            telegram:
              type: string
              description: Telegram channel URL
              example: https://t.me/circle_issuer
        categories:
          type: array
          description: Token categories or tags
          items:
            type: string
          example:
            - stablecoin
            - asset-backed-stablecoin
            - usd-stablecoin
        image_url:
          type: string
          description: URL to token logo image
          example: >-
            https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png
        created_at:
          type: string
          description: Token creation date
          example: '2018-09-26'
        last_updated:
          type: string
          description: Last time this data was updated
          format: date-time
          example: '2023-06-15T12:34:56Z'
      required:
        - name
        - symbol
        - contract_address
        - chain
        - other_chains
        - categories
        - last_updated
    issueAddresses:
      type: object
      properties:
        score:
          type: integer
          description: Overall risk score for the issue
          example: 3
        tags:
          type: array
          description: List of tags associated with the issue
          items:
            $ref: '#/components/schemas/tag'
        categories:
          type: array
          description: List of categories associated with the issue
          items:
            $ref: '#/components/schemas/category'
          example:
            address_characteristics:
              key: address_characteristics
              name: Wallet Characteristics
              description: >-
                This address may have risk factors related to address age,
                number of transactions, or balance.
              tags:
                insufficient_wallet_age: true
    AnalysisResponse:
      type: object
      properties:
        contract_address:
          type: string
          description: Address of the analyzed contract
          example: '0x1234567890123456789012345678901234567890'
        chain:
          type: string
          description: Blockchain network where the contract is deployed
          example: eth
        analysis_date:
          type: string
          format: date-time
          description: Date when the analysis was performed
          example: '2023-11-15T10:30:00Z'
        status:
          type: string
          description: Status of the analysis
          enum:
            - completed
            - in_progress
            - failed
            - pending
          example: completed
        findings:
          type: array
          description: Security analysis findings with associated risk tags
          items:
            $ref: '#/components/schemas/DetectorResult'
        urls:
          type: array
          description: Associated URLs related to the analysis
          items:
            $ref: '#/components/schemas/AnalysisUrl'
      required:
        - contract_address
        - chain
        - analysis_date
        - status
        - findings
        - urls
    MultiPlatformAnalysisData:
      type: object
      description: >-
        Multi-platform token launch analysis for developer migration risk
        assessment
      properties:
        developerAddress:
          type: string
          description: The developer's wallet address
          example: ESoMiyuJ1ksL5L99LjYCcwjt7XR2B7hdn6mkbBDFbadV
        analyzedAt:
          type: string
          format: date-time
          description: Timestamp when analysis was performed
          example: '2025-09-05T18:28:55.907Z'
        platformBreakdown:
          type: object
          description: Analysis breakdown by platform
          additionalProperties:
            $ref: '#/components/schemas/PlatformAnalysisResult'
      required:
        - developerAddress
        - analyzedAt
        - platformBreakdown
    informationalTag:
      type: object
      description: Contextual information tag without severity (not a security risk)
      properties:
        name:
          type: string
          description: Name of the informational tag
          example: Paid Information
        description:
          type: string
          description: Description of the informational tag
          example: >-
            The project has paid to display additional project info on platforms
            like DexScreener
        type:
          type: string
          description: Type of the tag
          example: tokenRisk
        key:
          type: string
          description: Key of the tag
          example: paid-info
    AddressType:
      type: string
      enum:
        - CONTRACT
        - EOA
        - TOKEN
        - CONTRACT_WALLET
        - OBJECT
        - PACKAGE
        - DYNAMIC_FIELD
        - UNKNOWN
      description: >-
        Type classification for blockchain addresses. CONTRACT: Smart contract
        address, EOA: Externally Owned Account (user wallet), TOKEN: Token
        contract, CONTRACT_WALLET: Smart contract wallet (e.g., Gnosis Safe,
        Argent), OBJECT: Sui object, PACKAGE: Sui package, DYNAMIC_FIELD: Sui
        dynamic field, UNKNOWN: Classification unavailable
    TokenStandard:
      type: string
      enum:
        - ERC20
        - ERC1155
        - ERC721
        - SPL
        - NFT
        - JETTON
        - JETTON_WALLET
        - TONNFT
        - UNKNOWN
        - SUI_COIN
        - SUI_NFT
        - STELLAR_ASSET
      description: >-
        Token standard classification for blockchain tokens. ERC20: Ethereum
        fungible token standard, ERC721: Ethereum NFT standard, ERC1155:
        Ethereum multi-token standard, SPL: Solana Program Library token, NFT:
        Solana NFT, JETTON: TON fungible token, JETTON_WALLET: TON jetton wallet
        contract, TONNFT: TON NFT, SUI_COIN: Sui coin standard, SUI_NFT: Sui
        NFT, STELLAR_ASSET: Stellar asset, UNKNOWN: Standard cannot be
        determined
    tag:
      type: object
      properties:
        name:
          type: string
          description: Name of the tag
          example: Insufficient Wallet Age
        description:
          type: string
          description: Description of the tag
          example: The age of this wallet or address is new.
        type:
          type: string
          description: Type of the tag
          example: noHistoryRisk
        severity:
          type: integer
          description: Severity of the tag
          example: 3
        key:
          type: string
          description: Key of the tag
          example: insufficient_wallet_age
    category:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/categoryIssue'
    DetectorResult:
      type: object
      properties:
        risk:
          type: string
          description: Risk tag mapped from the security detector
          example: reentrancy
        details:
          type: object
          description: Detailed information about the detector findings
          additionalProperties: true
        function_signatures:
          type: array
          description: Function signatures where issues were detected
          items:
            $ref: '#/components/schemas/FunctionSignature'
        statements:
          type: array
          description: Specific statements that triggered the detector
          items:
            $ref: '#/components/schemas/Statement'
      required:
        - risk
        - details
        - function_signatures
        - statements
    AnalysisUrl:
      type: object
      properties:
        url:
          type: string
          description: URL related to the analysis
          example: https://example.com/analysis-report
      required:
        - url
    PlatformAnalysisResult:
      type: object
      description: Analysis results for a specific token launch platform
      properties:
        platform:
          type: string
          description: Platform name
          enum:
            - pump_fun
            - moonshot
            - jupiter_lfg
          example: pump_fun
        chains:
          type: array
          description: Supported blockchain chains for this platform
          items:
            type: string
          example:
            - sol
        totalLaunches:
          type: integer
          description: Total number of tokens launched by developer on this platform
          example: 74
        successfulLaunches:
          type: integer
          description: Number of successful token launches
          example: 70
        successRate:
          type: number
          description: Success rate percentage
          example: 94.59
        totalFundsRaised:
          type: number
          description: Total funds raised across all launches
          example: 0
        platformRiskFactors:
          type: array
          description: Risk factors identified for this platform
          items:
            type: string
          example:
            - Tokens consistently fail to gain traction
        tokens:
          type: array
          description: Individual token launch records
          items:
            $ref: '#/components/schemas/TokenLaunchRecord'
      required:
        - platform
        - chains
        - totalLaunches
        - successfulLaunches
        - successRate
        - totalFundsRaised
        - platformRiskFactors
        - tokens
    categoryIssue:
      type: object
      properties:
        key:
          type: string
        name:
          type: string
        description:
          type: string
        tags:
          type: object
          additionalProperties:
            type: boolean
    FunctionSignature:
      type: object
      properties:
        function_name:
          type: string
          description: Name of the function
          example: withdraw
        function_signature:
          type: string
          description: Complete function signature
          example: function withdraw(uint256 amount) external
      required:
        - function_name
        - function_signature
    Statement:
      type: object
      properties:
        statement_type:
          type: string
          description: Type of the statement
          example: call
        statement_text:
          type: string
          description: Text of the statement
          example: 'msg.sender.call{value: amount}("")'
      required:
        - statement_type
        - statement_text
    TokenLaunchRecord:
      type: object
      description: Individual token launch record
      properties:
        tokenAddress:
          type: string
          description: Token contract address
          example: 4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf
        platform:
          type: string
          description: Launch platform
          example: pump_fun
        chain:
          type: string
          description: Blockchain network
          example: sol
        developerAddress:
          type: string
          description: Developer wallet address
          example: ESoMiyuJ1ksL5L99LjYCcwjt7XR2B7hdn6mkbBDFbadV
        successful:
          type: boolean
          description: Whether the launch was successful
          example: true
        status:
          type: string
          description: Launch status
          enum:
            - successful
            - rugged
            - failed
            - abandoned
          example: successful
        name:
          type: string
          description: Token name
          example: Dug the Dog
        symbol:
          type: string
          description: Token symbol
          example: Dug
        launchedAt:
          type: string
          format: date-time
          description: Launch timestamp
          example: '2025-06-27T03:36:23.000Z'
        successMetrics:
          $ref: '#/components/schemas/TokenSuccessMetrics'
      required:
        - tokenAddress
        - platform
        - chain
        - developerAddress
        - successful
        - status
        - launchedAt
    TokenSuccessMetrics:
      type: object
      description: Success metrics for a token launch
      properties:
        criteriaType:
          type: string
          description: Type of success criteria used
          example: bonding_curve_completion
        targetValue:
          type: number
          description: Target value for success
          example: 69000
        achievedValue:
          type: number
          description: Achieved value
          example: 69000
        successPercentage:
          type: number
          description: Success percentage
          example: 100
        liquidityAmount:
          type: number
          description: Liquidity amount
          example: 12000
        migrationDestination:
          type: string
          description: Where liquidity was migrated to
          example: raydium
        additionalMetrics:
          type: object
          description: Additional success metrics
          properties:
            detectionMethod:
              type: string
              description: Method used to detect success
              example: market_cap
          additionalProperties: true
  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

````