Docs / API: Labels

Get a label

Returns the label of one address, or 404 when it has none.

GET/api/v1/labels/{address}

Property	Value
Authentication	Optional. A key raises your limit.
Rate-limit cost	1 unit
Status	Live

#Parameters

Name	In	Type	Required	Description
`address`	path	string	Yes	EVM or Solana address.

#Request

curl -s "https://farbeamlabs.com/api/v1/labels/0x28C6c06298d514Db089934071355E5743bf21d60"

const res = await fetch("https://farbeamlabs.com/api/v1/labels/0x28C6c06298d514Db089934071355E5743bf21d60");
const { data, meta, error } = await res.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os, requests

res = requests.get(
    "https://farbeamlabs.com/api/v1/labels/0x28C6c06298d514Db089934071355E5743bf21d60",
    timeout=30,
)
body = res.json()
if "error" in body:
    raise RuntimeError(body["error"]["code"])
print(body["data"])

You can send this request now in the API playground.

#Response

This response is real. It was captured from the running API when this page was built. Arrays are cut to two items.

JSON

{
  "data": {
    "name": "Binance 14",
    "type": "exchange",
    "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
    "chains": [
      "ethereum"
    ],
    "source_url": "https://etherscan.io/address/0x28C6c06298d514Db089934071355E5743bf21d60"
  },
  "meta": {
    "request_id": "req_e41baa687c0b",
    "as_of": "2026-11-04T20:10:56.752Z"
  }
}

#Errors

HTTP	Code	Meaning
400	`invalid_address`	The address format does not match the chain.
404	`not_found`	The item does not exist.

All errors share one format. See errors.

PreviousList labels NextChain TVL