Address labels

Public labels of up to 100 addresses at once: the names of exchanges and their hot wallets, wallet services, bridges, DEXes and other projects, and addresses an open dataset flags as scam — to label the holders of an asset or any list of addresses in one call. A page of Transactions already carries the labels of its own addresses (labels), and Details the label of its address (label).

No chain read: apiton keeps the labels in memory. They come from openly licensed datasets — today ton-labels by TON Foundation (MIT, github.com/ton-studio/ton-labels) — refreshed daily, and every label carries its source and dates. A label is the dataset's statement, not apiton's own finding: show its source with it.

Request. addresses — 1–100 strings, any form (raw 0:…, EQ…, UQ…; no .ton names). Duplicates and addresses that do not parse are allowed and simply absent from the answer.

Response. labels — a map from the address exactly as sent to its AddressLabel; an address without a label is absent. In the example the EQ… form that was sent is the key, the label's own address is the UQ… form, and the second address has no label.

Field	Meaning
`address`	the address, non-bounceable `UQ…`
`name`	display name of the entity: `OKX`, `Bridge.ton.org`, `Scammer`
`category`	apiton's category: `exchange` (centralised exchanges and other custodial services) · `wallet` (wallet apps and their service addresses) · `dex` · `defi` (lending, liquid staking, yield) · `bridge` · `validator` · `infrastructure` (system contracts, givers) · `gaming` · `merchant` (marketplaces, payment services) · `fund` · `scam` · `other`
`scam`	the source flags the address as a scam (its category or its `scammer` tag) — a public warning, not apiton's own finding
`comment`	what the address is within the entity, as the source says (`hot wallet`, `USDT withdrawals`)
`website`	the entity's `https` site
`tags`	the source's tags verbatim: `has-custodial-wallets`, `telegram-gifts`, `suspicious`, …
`entity`	the source's id of the entity (`okx`); addresses of one entity share it
`source`	`ton-labels` · `manual` (added by apiton; wins over every dataset)
`source_url`	where the source publishes the label
`source_category`, `source_subcategory`	the source's own category / subcategory (`CEX`, `scripted-activity`; `gambling`, `drainer`)
`submitted_at`	when the label was added to the source; absent when unknown
`created_at`, `updated_at`	when apiton first stored the label / when its content last changed
`fetched_at`	the last refresh of the source that still had the label

Empty fields are left out of the JSON (scam: false, no comment, no tags). When several sources label one address, the answer is the label of the highest-priority source. A label taken down by apiton is not returned any more within a few minutes of the takedown.

Errors (Connect JSON envelope {"code":…,"message":…})

Code	When
`failed_precondition` (400)	an empty list, or more than 100 addresses
`unavailable` (503)	`labels unavailable, retry later` — only before the server has loaded the labels, with its database down

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "labels": {
        "EQBqStmtzW97_197s50itoNl3L3uCc4L6STW32sbgBCiMcV1": {
            "address": "UQBqStmtzW97_197s50itoNl3L3uCc4L6STW32sbgBCiMZiw",
            "name": "Abantether",
            "category": "exchange",
            "website": "https://abantether.com",
            "entity": "abantether",
            "source": "ton-labels",
            "source_url": "https://github.com/ton-studio/ton-labels",
            "source_category": "CEX",
            "submitted_at": "2026-07-01T10:09:26Z",
            "created_at": "2026-10-25T19:23:07.362548Z",
            "updated_at": "2026-10-25T19:23:07.362548Z",
            "fetched_at": "2026-11-05T22:57:36.566131Z"
        }
    }
}

🔴500Server Error