> ## 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.

# Jetton hybrid search

> If query is not specified and `kind` is either `DEXES` or `MEMES_MEMEPADS`, page is accounted for, otherwise page is ignored.
If query is not specified and `kind` is `DEXES`, sort is accounted for, otherwise sort is ignored.
If kind is one of `ALL`, `MEMES_ALL`, `MEMES_MEMEPADS`, `verification` must include `COMMUNITY`




## OpenAPI

````yaml https://tokens.swap.coffee/api/v3/openapi.yaml get /api/v3/hybrid-search
openapi: 3.0.3
info:
  title: Tokens Service
  version: 3.0.0-beta
servers:
  - url: https://tokens.swap.coffee
  - url: http://localhost:8080
security:
  - {}
  - ApiKey: []
tags:
  - name: Accounts
  - name: Jettons
  - name: Labels
  - name: Contracts
paths:
  /api/v3/hybrid-search:
    get:
      tags:
        - Jettons
      summary: Jetton hybrid search
      description: >
        If query is not specified and `kind` is either `DEXES` or
        `MEMES_MEMEPADS`, page is accounted for, otherwise page is ignored.

        If query is not specified and `kind` is `DEXES`, sort is accounted for,
        otherwise sort is ignored.

        If kind is one of `ALL`, `MEMES_ALL`, `MEMES_MEMEPADS`, `verification`
        must include `COMMUNITY`
      operationId: hybridSearch
      parameters:
        - name: search
          in: query
          schema:
            type: string
          style: form
          explode: false
        - name: verification
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ApiJettonVerification'
            default:
              - WHITELISTED
          style: form
          explode: false
        - name: size
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
          style: form
          explode: false
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
            maximum: 100
          style: form
          explode: false
        - name: kind
          in: query
          schema:
            $ref: '#/components/schemas/ApiHybridSearchKind'
          style: form
          explode: false
        - name: sort
          in: query
          schema:
            $ref: '#/components/schemas/ApiHybridSearchSort'
          style: form
          explode: false
      responses:
        '200':
          description: A list of jettons
          headers:
            Cache-Control:
              description: Cache control header
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiPolyJetton'
        default:
          $ref: '#/components/responses/ApiError'
components:
  schemas:
    ApiJettonVerification:
      type: string
      enum:
        - BLACKLISTED
        - UNKNOWN
        - COMMUNITY
        - WHITELISTED
    ApiHybridSearchKind:
      type: string
      enum:
        - ALL
        - DEXES
        - MEMES_ALL
        - MEMES_DEXES
        - MEMES_MEMEPADS
      default: DEXES
    ApiHybridSearchSort:
      type: string
      enum:
        - FDMC
        - TVL
        - MCAP
        - VOLUME_24H
        - PRICE_CHANGE_24H
    ApiPolyJetton:
      oneOf:
        - $ref: '#/components/schemas/ApiJetton'
        - $ref: '#/components/schemas/ApiMemepadJetton'
      discriminator:
        propertyName: type
        mapping:
          common:
            $ref: '#/components/schemas/ApiJetton'
          memepad:
            $ref: '#/components/schemas/ApiMemepadJetton'
    ApiJetton:
      type: object
      required:
        - address
        - decimals
      properties:
        created_at:
          type: string
          format: date-time
          example: '2023-10-01T12:00:00Z'
        address:
          type: string
          example: 0:a5d12e31be87867851a28d3ce271203c8fa1a28ae826256e73c506d94d49edad
        total_supply:
          type: string
          example: '1000000000'
        name:
          type: string
          example: Tether USD
        symbol:
          type: string
          example: USDT
        decimals:
          type: integer
          format: int32
          example: 6
        mintable:
          type: boolean
          example: false
        buy_fee:
          type: integer
          format: int32
        sell_fee:
          type: integer
          format: int32
        verification:
          $ref: '#/components/schemas/ApiJettonVerification'
        contract_interface:
          type: string
          example: jetton_wallet_tonfun
        image_url:
          type: string
          example: https://tokens.swap.coffee/images/USDT.png
        market_stats:
          $ref: '#/components/schemas/ApiJettonMarketStats'
        labels:
          type: array
          items:
            $ref: '#/components/schemas/ApiJettonLabelRelation'
        scaled_ui_multiplier:
          $ref: '#/components/schemas/ApiJettonScaledUiMultiplier'
    ApiMemepadJetton:
      type: object
      required:
        - address
        - protocol
        - total_supply
        - decimals
        - mintable
        - verification
        - created_at
      properties:
        created_at:
          type: string
          format: date-time
          example: '2023-10-01T12:00:00Z'
        address:
          type: string
          example: 0:a5d12e31be87867851a28d3ce271203c8fa1a28ae826256e73c506d94d49edad
        protocol:
          type: string
          example: TONFUN
        name:
          type: string
          example: Tether USD
        symbol:
          type: string
          example: USDT
        decimals:
          type: integer
          example: 6
        image_url:
          type: string
          example: https://tokens.swap.coffee/images/USDT.png
        market_stats:
          $ref: '#/components/schemas/ApiMemepadJettonMarketStats'
    ApiJettonMarketStats:
      type: object
      required:
        - holders_count
        - price_usd
        - price_change_5m
        - price_change_1h
        - price_change_6h
        - price_change_24h
        - price_change_7d
        - volume_usd_24h
        - tvl_usd
        - fdmc
        - mcap
      properties:
        holders_count:
          type: integer
          example: 1000
        price_usd:
          type: number
          example: 1
        price_change_7d:
          type: number
          example: 0.2
        price_change_5m:
          type: number
          example: 0.01
        price_change_1h:
          type: number
          example: 0.02
        price_change_6h:
          type: number
          example: 0.03
        price_change_24h:
          type: number
          example: 0.1
        volume_usd_24h:
          type: number
          example: 1000000
        tvl_usd:
          type: number
          example: 1000000
        fdmc:
          type: number
          example: 1000000
        mcap:
          type: number
          example: 1000000
        trust_score:
          type: integer
          example: 100
    ApiJettonLabelRelation:
      type: object
      required:
        - label
        - created_at
        - label_id
      properties:
        label:
          type: string
          example: label
        label_id:
          type: integer
          example: 1
        created_at:
          type: string
          format: date-time
          example: '2023-10-01T12:00:00Z'
        expires_at:
          type: string
          format: date-time
          example: '2023-10-01T12:00:00Z'
    ApiJettonScaledUiMultiplier:
      type: object
      required:
        - numerator
        - denominator
      properties:
        numerator:
          type: string
          format: bigint
        denominator:
          type: string
          format: bigint
    ApiMemepadJettonMarketStats:
      type: object
      required:
        - price_usd
        - tvl_usd
        - fdmc_usd
        - collected_ton
      properties:
        price_usd:
          type: number
          example: 1
        tvl_usd:
          type: number
          example: 1000000
        fdmc_usd:
          type: number
          example: 1000000
        max_ton:
          type: number
          example: 1000000
        collected_ton:
          type: number
          example: 1000000
        progress:
          type: number
  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

````