---
title: "Jetton hybrid search"
method: GET
path: "/api/v3/hybrid-search"
tags: ["Jettons"]
---

# Jetton hybrid search

`GET /api/v3/hybrid-search`

## Request

- Base URL: `https://tokens.swap.coffee`
- URL: `https://tokens.swap.coffee/api/v3/hybrid-search`
- Auth: one of:
  - none
  - API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/swap/apis/tokens-service/docs/api/v3/hybrid-search/get.ts> (a function with typed inputs; its response is checked against the schema)

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.
`direction` applies to `sort=PRICE_CHANGE_24H` only.
If kind is one of `ALL`, `MEMES_ALL`, `MEMES_MEMEPADS`, `verification` must include `COMMUNITY`

## Query parameters

- `search` string
- `verification` ApiJettonVerification[]
- `size` integer
- `page` integer
- `kind` 'ALL' | 'DEXES' | 'MEMES_ALL' | 'MEMES_DEXES' | 'MEMES_MEMEPADS'
- `sort` 'FDMC' | 'TVL' | 'MCAP' | 'VOLUME_24H' | 'PRICE_CHANGE_24H'
- `direction` 'ASC' | 'DESC'

## Response `200`

A list of jettons

- ApiPolyJetton[]
  - union
    - ApiJetton
      - `created_at` string, date-time
      - `address` string, required
      - `total_supply` string
      - `name` string
      - `symbol` string
      - `decimals` integer, required
      - `mintable` boolean
      - `buy_fee` integer
      - `sell_fee` integer
      - `verification` 'BLACKLISTED' | 'UNKNOWN' | 'COMMUNITY' | 'WHITELISTED'
      - `contract_interface` string
      - `image_url` string
      - `market_stats` ApiJettonMarketStats
        - `holders_count` integer, required
        - `price_usd` number, required
        - `price_change_7d` number, required
        - `price_change_5m` number, required
        - `price_change_1h` number, required
        - `price_change_6h` number, required
        - `price_change_24h` number, required
        - `volume_usd_24h` number, required
        - `tvl_usd` number, required
        - `fdmc` number, required
        - `mcap` number, required
        - `trust_score` integer
        - `volume_buy_usd_24h` number: USD volume of buys over the last 24h (from on-chain dex trades)
        - `volume_sell_usd_24h` number: USD volume of sells over the last 24h (from on-chain dex trades)
        - `unique_traders_24h` integer: Number of unique trading wallets over the last 24h
        - `lp_locked_percent` number: Share of the token's liquidity (LP tokens) held by lockers/farms or burned, 0..100
      - `labels` ApiJettonLabelRelation[]
        - `label` string, required
        - `label_id` integer, required
        - `created_at` string, date-time, required
        - `expires_at` string, date-time
      - `scaled_ui_multiplier` ApiJettonScaledUiMultiplier
        - `numerator` string, bigint, required
        - `denominator` string, bigint, required
    - ApiMemepadJetton
      - `created_at` string, date-time, required
      - `address` string, required
      - `protocol` string, required
      - `name` string
      - `symbol` string
      - `decimals` integer, required
      - `image_url` string
      - `market_stats` ApiMemepadJettonMarketStats
        - `price_usd` number, required
        - `tvl_usd` number, required
        - `fdmc_usd` number, required
        - `max_ton` number
        - `collected_ton` number, required
        - `progress` number

## Other responses

- `default`: Some error during request processing

## Changes

- **2026-08-22** `b8fd8c19faee`: 1 info
  - added the new optional `query` request parameter `direction`
- **2026-07-21** `8473b7a3ca64`: 4 info
  - added the optional property `items/oneOf[#/components/schemas/ApiJetton]/market_stats/lp_locked_percent` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/ApiJetton]/market_stats/unique_traders_24h` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/ApiJetton]/market_stats/volume_buy_usd_24h` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/ApiJetton]/market_stats/volume_sell_usd_24h` to the response with the `200` status

[Operation history](https://skmtc.dev/swap/apis/tokens-service/changes/api/v3/hybrid-search/get.md)

---

[API](https://skmtc.dev/swap/apis/tokens-service.md) - [All operations](https://skmtc.dev/swap/apis/tokens-service/llms.txt) - [OpenAPI document](https://skmtc.dev/swap/apis/tokens-service/revisions/b8fd8c19faee?raw)