Docs / API: Labels

List labels

Returns the curated label set. You can search it and filter it.

GET/api/v1/labels

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

#Parameters

Name	In	Type	Required	Description
`q`	query	string	No	Text to find in the name or the address.
`type`	query	string	No	`exchange`, `dex`, `bridge`, `lending`, `staking`, `token`, `issuer`, `launchpad` or `infrastructure`.
`chain`	query	string	No	One of `ethereum`, `base`, `bnb`, `arbitrum`, `optimism`, `polygon`, `solana`.

#Request

curl -s "https://farbeamlabs.com/api/v1/labels?q=binance"

const res = await fetch("https://farbeamlabs.com/api/v1/labels?q=binance");
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?q=binance",
    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": "Kraken 4",
      "type": "exchange",
      "address": "0x267be1C1D684F78cb4F6a176C4911b741E4Ffdc0",
      "chains": [
        "ethereum"
      ],
      "source_url": "https://etherscan.io/address/0x267be1C1D684F78cb4F6a176C4911b741E4Ffdc0"
    },
    {
      "name": "Kraken 13",
      "type": "exchange",
      "address": "0xDA9dfA130Df4dE4673b89022EE50ff26f6EA73Cf",
      "chains": [
        "ethereum"
      ],
      "source_url": "https://etherscan.io/address/0xDA9dfA130Df4dE4673b89022EE50ff26f6EA73Cf"
    }
  ],
  "meta": {
    "request_id": "req_6afe05b562bb",
    "as_of": "2026-11-04T20:10:56.750Z"
  }
}

#Errors

HTTP	Code	Meaning
400	`invalid_chain`	The chain is unknown.

All errors share one format. See errors.

PreviousTransaction lookup NextGet a label