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

# Returns list of pools associated with given token



## OpenAPI

````yaml https://backend.swap.coffee/openapi get /v1/pool/{blockchain}/by-token/{address}
openapi: 3.0.3
info:
  title: Swap Coffee API
  version: 1.0.0
servers:
  - url: https://backend.swap.coffee/
  - url: http://localhost:8080/
security:
  - {}
  - ApiKey: []
tags:
  - name: Entity
    description: Tokens, pools, DEXes, etc.
  - name: Routing
    description: >-
      Core functionality of the aggregation service. Build routes, get
      transactions, etc.
  - name: Strategies
    description: Limit orders, DCA, VCA, etc.
  - name: Yield
    description: >-
      Yield aggregator functionality. Provides and handles routes to pools with
      the best yield.
  - name: Referral
    description: Everything related to the referral program of swap.coffee.
  - name: Cashback
    description: Cashback programs conducted on swap.coffee.
  - name: Claim
    description: Claiming various rewards available on swap.coffee.
  - name: Contests
    description: Timed contests based on trading volumes for certain token-pairs.
  - name: Staking
    description: Responsible of managing staked funds, corresponding rewards, etc.
  - name: DEX
    description: Core functionality of the Coffee DEX service.
  - name: LiquidityProvisioning
    description: Everything related to liquidity provisioning in DEXes.
  - name: Boosts
    description: >-
      Functionality to support incentives and rewards for liquidity providers
      among all DEXes.
  - name: Profile
    description: Retrieve information about user profiles.
  - name: Partnership
    description: Various functionality for our partners.
  - name: Statistics
    description: Retrieve information about dex aggregation stats.
  - name: Ton
    description: Retrieve information about TON entities.
  - name: Auth
    description: Auth operations. For internal usage only.
paths:
  /v1/pool/{blockchain}/by-token/{address}:
    get:
      tags:
        - Entity
      summary: Returns list of pools associated with given token
      operationId: getPoolsByToken
      parameters:
        - $ref: '#/components/parameters/pathBlockchain'
        - name: address
          in: path
          required: true
          schema:
            type: string
            example: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
        - name: dexes
          in: query
          schema:
            type: array
            items:
              type: string
              example: stonfi
        - $ref: '#/components/parameters/querySize10'
        - $ref: '#/components/parameters/queryPage'
      responses:
        '200':
          description: list of pools
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiTrimmedPool'
          headers:
            Cache-Control:
              schema:
                type: string
        default:
          $ref: '#/components/responses/ApiError'
components:
  parameters:
    pathBlockchain:
      in: path
      name: blockchain
      required: true
      schema:
        type: string
        example: ton
    querySize10:
      in: query
      name: size
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 100
        default: 10
    queryPage:
      in: query
      name: page
      schema:
        type: integer
        format: int32
        minimum: 1
        default: 1
  schemas:
    ApiTrimmedPool:
      type: object
      required:
        - dex
        - address
        - type
        - amm_type
        - tokens
        - reserves
        - fees
      properties:
        dex:
          type: string
          example: stonfi
        address:
          type: string
        type:
          $ref: '#/components/schemas/ApiPoolType'
        amm_type:
          $ref: '#/components/schemas/ApiAmmType'
        amm_settings:
          $ref: '#/components/schemas/ApiJson'
        tokens:
          type: array
          items:
            type: string
            example: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
        reserves:
          $ref: '#/components/schemas/ApiPoolReserves'
        restrictions:
          type: array
          items:
            $ref: '#/components/schemas/ApiTokenRestrictions'
        fees:
          $ref: '#/components/schemas/ApiPoolFees'
        unavailable_until:
          type: integer
          format: int64
          description: UTC unix timestamp in seconds
    ApiPoolType:
      type: string
      enum:
        - public
        - private
        - slumbering
        - invalid
    ApiAmmType:
      type: string
      enum:
        - constant_product
        - cubic_stable
        - curve_fi_stable
        - concentrated_v3
        - tonstakers
        - weighted_constant_product
        - weighted_stable
        - bidask
        - moon_dlmm
        - bidask_damm
    ApiJson:
      type: object
      additionalProperties: {}
    ApiPoolReserves:
      type: array
      items:
        type: number
        format: double
    ApiTokenRestrictions:
      type: object
      properties:
        min_swap_amount:
          type: number
          format: double
        max_swap_amount:
          type: number
          format: double
    ApiPoolFees:
      type: object
      required:
        - average_gas
      properties:
        average_gas:
          type: number
          format: double
        divider:
          type: integer
          format: int64
        input:
          type: integer
          format: int64
        output:
          type: integer
          format: int64
        first_token:
          type: integer
          format: int64
        second_token:
          type: integer
          format: int64
  responses:
    ApiError:
      description: Some error during request processing
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: string
  securitySchemes:
    ApiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````