---
title: "Bulk fetch jettons by addresses (up to 100 per request)"
method: POST
path: "/api/v3/jettons/by-addresses"
tags: ["Jettons"]
---

# Bulk fetch jettons by addresses (up to 100 per request)

`POST /api/v3/jettons/by-addresses`

## Request

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

## Query parameters

- `refresh_price` boolean

## Request body

- string[]

## Response `200`

A list of jettons

- 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

## Other responses

- `default`: Some error during request processing

## Changes

- **2026-07-21** `8473b7a3ca64`: 4 info
  - added the optional property `items/market_stats/lp_locked_percent` to the response with the `200` status
  - added the optional property `items/market_stats/unique_traders_24h` to the response with the `200` status
  - added the optional property `items/market_stats/volume_buy_usd_24h` to the response with the `200` status
  - added the optional property `items/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/jettons/by-addresses/post.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)