All pages
Powered by GitBook
1 of 2

Loading...

Loading...

Adressetikett-API

Die Address Label API ermöglicht es den Benutzern, Adressetiketten abzurufen und eine Adresse aus verschiedenen Perspektiven umfassend zu verstehen. Es unterstützt derzeit mehr als 25 verschiedene Blockchains, darunter Solana, Bitcoin, Tron, Ethereum, BSC und andere EVM-kompatible Ketten.

Adressetikett

Bei der Verwendung unserer API zur ĂśberprĂĽfung einer Adresse geben wir drei Arten von Etiketten zurĂĽck, um die Adresse zu beschreiben.

Entität

Wir verwenden Entität, um den Besitzer oder Kontrolleur einer Adresse zu beschreiben. Wenn es sich um eine EoA-Adresse handelt, bedeutet dies die Entität, die diese EoA-Adresse kontrolliert (mit dem privaten Schlüssel). Bei einem Smart Contract kann sich die Entität auf ihre Bereitsteller (Projekte) beziehen.

Eine Adresse kann mehr als eine Entität aufweisen.

Die Zuordnung einer Entität zu einer Adresse dient in erster Linie dazu, eine Verbindung zwischen einer Kryptowährungsadresse und einer bekannten Organisation oder Person herzustellen. Es gibt jedoch Fälle, in denen eine Adresse mehreren Entitäten zugeordnet werden kann. In diesen Fällen weisen wir die Hauptentität und ergänzende Entitäten zu.

Betrachten wir zum Beispiel die Einzahlungsadresse von Alameda auf Binance. Wir können angeben, dass Binance die Kontrolle über den privaten Schlüssel dieser Adresse ausübt oder dass Alameda sie nutzt. In solchen Situationen bezeichnen wir Binance als die primäre Entität für diese Adresse, während wir Alameda als sekundäre oder ergänzende Entität betrachten.

Entitätskategorie

Die meisten Entitäten sind Organisationen oder Dienste, nur wenige vertreten Einzelpersonen. Die meisten Entitäten sind in die folgenden Kategorien unterteilt, die Ihnen helfen können, ihre Natur zu verstehen.

Kategorie
Code
Beschreibung

Attribut

Wir verwenden Attribut, um das Verhalten oder die Aktion zu beschreiben, die mit einer bestimmten Adresse oder Entität verbunden ist. Alle Attribute sind in der folgenden Tabelle aufgeführt.

Attribut
Code
Beschreibung

Namensschild

Ein Name wird verwendet, um eine Kryptowährungsadresse mit menschenlesbaren Informationen zu beschreiben. Bei der Zuweisung von Namen wird in der Regel die mit der Adresse verbundene Entität und ihre spezifischen Attribute berücksichtigt, wie Binance Hot Wallet 1 oder Vitalik 2.

UnterstĂĽtzte Netzwerke

Die Address Label API unterstützt 25 verschiedene Ketten, die in der unten stehenden Tabelle aufgeführt sind. Wir bieten auch eine , mit der Sie eine Liste aller unterstützten Ketten abrufen können, damit Sie über neu hinzugefügte Ketten informiert bleiben.

Bei der Erstellung einer API-Anfrage bitte die Chain ID verwenden, um die gewĂĽnschte Kette anzugeben.

Netzwerkname
Kurzname
Chain ID

Abonnement

Abonnieren Sie , um diese API in Ihrem Dienst zu verwenden, um die Compliance-Anforderungen zu erfüllen und die Vermögenswerte der Benutzer zu sichern.

DAPP

3005

Eine dezentrale Anwendung (dApp) ist eine auf einem dezentralen Netzwerk entwickelte Anwendung, die einen Smart Contract und eine Benutzeroberfläche integriert. Wenn eine dApp nicht in spezifische Kategorien wie DEFI passt, wird sie in diese allgemeine Kategorie eingeordnet. Sie kann jedoch in Zukunft neuen hinzugefügten Kategorien zugeordnet werden.

DARK MARKET

3006

Illegale Websites im Dark Web, die den Kauf und Verkauf illegaler Waren und Dienstleistungen erleichtern, einschlieĂźlich Drogen, Waffen, Falschgeld und gestohlener Daten.

DEFI

3007

DeFi-Apps, die dezentralen Finanzanwendungen, bieten Peer-to-Peer-Finanzdienstleistungen auf öffentlichen Blockchains. Wenn eine DeFi-dApp nicht in spezifische Kategorien wie DEX (Decentralized Exchange) fällt, wird sie in diese allgemeine Kategorie eingeordnet. Sie kann jedoch in Zukunft neuen hinzugefügten Kategorien zugeordnet werden.

DEX

3008

Peer-to-Peer-Marktplätze, auf denen Transaktionen direkt zwischen Kryptowährungshändlern stattfinden.

DEX-AGGREGATOR

3009

Eine Plattform, die Liquidität von verschiedenen dezentralen Börsen bezieht, um optimalen Handel hinsichtlich Preis und Slippage zu gewährleisten.

ECOMMERCE

3010

E-Commerce-Plattformen, die Kryptowährungen unterstützen.

BĂ–RSE

3011

Zentralisierte Plattformen, die es Einzelpersonen ermöglichen, verschiedene Kryptowährungen zu kaufen, zu verkaufen und zu handeln.

FAUCET

3012

Eine App oder eine Website, die kleine Mengen an Kryptowährungen als Belohnung für das Lösen einfacher Aufgaben verteilt.

GLĂśCKSSPIEL

3013

Online-Plattformen, die es Benutzern ermöglichen, mit Kryptowährungen zu spielen.

INFRASTRUKTUR

3014

Grundlegende Dienste oder Programme, die auf der Blockchain bereitgestellt werden, wie der ENS (Ethereum Name Service) -Dienst und Solana-Systemprogramme.

NFT-MARKTPLATZ

3015

Plattformen, die den Kauf, Verkauf und die Erstellung von Non-Fungible Tokens (NFTs) erleichtern.

MINING-POOL

3016

Ein Mining-Pool ist, wenn sich einzelne Krypto-Miner zusammenschlieĂźen und ihre Ressourcen bĂĽndeln, um ihre Chancen auf eine Blockbelohnung zu verbessern.

MISCHER

3017

Ein Dienst, der die Kryptowährungen vieler Benutzer miteinander vermischt, um die Ursprünge und Besitzer der Gelder zu verschleiern.

ZAHLUNGSABWICKLER

3018

Ein Dienst, der Zahlungen in digitalen Währungen abwickelt und es Händlern ermöglicht, Kryptowährungszahlungen zu akzeptieren.

ERPRESSUNGSSOFTWARE

3019

Kriminelle Banden, die Erpressung durch Ransomware betreiben.

WALLET

3020

Software oder Hardware, die es Benutzern ermöglicht, Kryptowährung zu speichern und zu nutzen.

EINZAHLUNGSADRESSE

4007

Die Einzahlungsadresse bezieht sich auf die Adresse, die von der zentralisierten Plattform zum Empfang von Benutzereinzahlungen verwendet wird, und in der Regel wird jedem Benutzer eine eigene Einzahlungsadresse zugewiesen.

HEIĂźE WALLET

4009

Ein heißes Wallet ist eine Art von Kryptowährungs-Wallet, das mit dem Internet verbunden ist und aktiv für Transaktionen und tägliche Kryptowährungsverwaltung verwendet wird.

GELDWÄSCHE

4011

Die Adressen und Entitäten, die mit diesem Attribut verbunden sind, werden als in Geldwäscheaktivitäten beteiligt angesehen.

MISCHEN

4012

Dieses Label wird Services oder Adressen (hauptsächlich Verträgen) zugeschrieben, von denen angenommen wird, dass sie die Fähigkeit besitzen, den Geldfluss zu verschleiern.

OHNE KYC

4013

Der VASP (Virtual Asset Service Provider), der mit der Adresse verbunden ist, hat kein KYC (Know Your Customer) -Verfahren eingefĂĽhrt.

GELDMITTEL ZURĂśCKGEBEN

4014

Adresse, die für die Durchführung eines Angriffs oder einer Ausnutzung verwendet wird, gefolgt von der anschließenden Rückgabe von Geldern. Diese Person könnte ein White-Hat-Hacker sein oder jemand, der eine Einigung mit dem Projektteam erzielt hat.

SANKTIONIERT

4015

Die Kryptowährungsadresse, die mit Personen oder Organisationen verbunden ist, die Sanktionen unterliegen.

BETRUG

4016

Die Adressen, die mit Personen oder Organisationen verbunden sind, die in betrügerische Aktivitäten verwickelt sind, einschließlich Phishing, Honeypots, Ponzi-Systeme und mehr.

Optimism Mainnet

OPTIMISM

10

Cronos Mainnet

CRONOS

25

BNB Smart Chain Mainnet

BSC

56

Gnosis

GNOSIS

100

Polygon Mainnet

POLYGON

137

BitTorrent Chain Mainnet

BITTORRENT

199

Fantom

FANTOM

250

Boba Network

BOBA

288

zkSync Era Mainnet

ZKSYNC ERA

324

CLV Parachain

CLV

1024

Polygon zkEvm

POLYGON ZKEVM

1101

WEMIX3.0 Mainnet

WEMIX

1111

Moonbeam

MOONBEAM

1284

Moonriver

MOONRIVER

1285

Base

BASE

8453

Arbitrum One

ARBITRUM

42161

Celo Mainnet

CELO

42220

Avalanche C-Chain

AVALANCHE

43114

Linea

LINEA

59144

Blast Mainnet

BLAST

81457

Aurora Mainnet

AURORA

1313161554

VERMĂ–GENSVERWALTUNG

3001

Finanzinstitute, die sich auf die Verwaltung und Investition von Vermögenswerten im Namen von Kunden spezialisiert haben.

BRĂśCKE

3002

Protokolle, die die Bewegung von Vermögenswerten und Daten zwischen verschiedenen Blockchain-Netzwerken erleichtern.

KINDESMISSBRAUCHMATERIAL

3003

Foren und Websites, die den Kauf, Verkauf und die Verbreitung von Kindesmissbrauchsmaterial erleichtern.

CLOUD MINING

3004

Dienste, die es Einzelpersonen ermöglichen, Rechenleistung aus entfernten Rechenzentren zu mieten, um Kryptowährung zu schürfen, ohne physische Hardware zu verwalten.

ANGREIFER

4001

Adressen, die an Angriffsvorfällen beteiligt sind, wie Vertragsausnutzung, Hacks von privaten Schlüsseln oder Erpressungen.

BLOKIERT

4002

Adressen, die von kritischen Verträgen, hauptsächlich USDT und USDC, blockiert wurden.

KALTE WALLET

4004

Ein kaltes Wallet bezieht sich auf eine Art von Kryptowährungs-Wallet, die offline gespeichert wird und nicht mit dem Internet verbunden ist.

DARKWEB-GESCHÄFT

4006

Adressen, die in Darkweb-Geschäften beteiligt sind, einschließlich Aktivitäten wie Drogen, Waffen, Missbrauch und andere unerlaubte Praktiken.

Solana

SOLANA

-3

Tron

TRX

-2

Bitcoin Mainnet

BTC

-1

Ethereum Mainnet

ETH

API
unseren Plan

1

APIs

Abonnement

Abonnieren Sie unseren Plan, um diese API in Ihrem Service zu nutzen, damit Compliance-Anforderungen erfüllt werden und die Vermögenswerte der Benutzer geschützt werden.

UnterstĂĽtzte Ketten abrufen

Adressetiketten abrufen

Adressetiketten im Batch abrufen

Adressetiketten ĂĽber mehrere Ketten im Batch abrufen

Das verbrauchte Kontingent wird wie folgt berechnet:

Kontingent = Anzahl der Adressen Ă— Anzahl der Ketten.

Beispielsweise verbraucht die Abfrage von 3 Adressen auf 2 Ketten insgesamt 6 Kontingente (3 Ă— 2 = 6).

Entity-Informationen abrufen

Get a list of supported chains

get

Retrieve a list of all blockchains supported by the address label APIs

Authorizations
API-KEYstringRequired
Responses
200

OK

application/json
500

Internal Server Error

application/json
get
/chain-list

Get the label of a single address.

post

Retrieve detailed label information of a specific address on a particular chain.

Authorizations
API-KEYstringRequired
Body
addressstringRequiredExample: 0x3d12e63d4313f850d23cead57ef0c29e94c9551d
chain_idintegerRequiredExample: 1
Responses
200

OK

application/json
500

Internal Server Error

application/json
post
/labels

Get the labels of multiple addresses on the same chain in batch

post

Retrieve detailed label information of a list of addresses on a particular chain.

Authorizations
API-KEYstringRequired
Body
addressesstring[]RequiredExample: ["0x3d12e63d4313f850d23cead57ef0c29e94c9551d","0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"]
chain_idintegerRequiredExample: 1
Responses
200

OK

application/json
500

Internal Server Error

application/json
post
/batch-labels

Get address labels across multiple chains

post

Retrieve address labels for multiple addresses across specified blockchain networks

Authorizations
API-KEYstringRequired
Body
addressesstring[]RequiredExample: ["0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b","0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3"]
chainsinteger[]RequiredExample: [1,56]
Responses
200

Successfully returned address labels

application/json
400

Invalid request parameters

application/json
500

Internal server error

application/json
post
/multi-chains-labels

Get entity information by entity name

post

Retrieve detailed information based on the provided entity name, supporting suffix matching

Authorizations
API-KEYstringRequired
Body
entitystringRequiredExample: TORNADO.CASH
Responses
200

OK

application/json
400

Parameter error

application/json
500

Internal service error

application/json
post
/entity
{
  "request_id": "c82817c2fec843ce",
  "code": 200000,
  "message": "Success",
  "data": {
    "chain_id": 1,
    "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "main_entity": "Binance",
    "main_entity_info": {
      "entity": "Binance",
      "categories": [
        {
          "name": "EXCHANGE",
          "code": 3011
        },
        {
          "name": "OTC DESK",
          "code": 3021
        }
      ],
      "attributes": null,
      "description": {
        "website": "https://www.binance.com/",
        "twitter": "https://twitter.com/binance",
        "telegram": "",
        "discord": ""
      }
    },
    "comp_entities": [
      "Alameda Research"
    ],
    "attributes": [
      {
        "name": "DEPOSIT ADDRESS",
        "code": 4007,
        "comp_info": [
          "BINANCE DEPOSIT ADDRESS"
        ]
      }
    ],
    "name_tag": "Binance: Deposit Address"
  }
}
{
  "request_id": "faf08205f4364c8c",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": 1,
      "address": "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
      "main_entity": "Binance",
      "main_entity_info": {
        "entity": "Binance",
        "categories": [
          {
            "name": "EXCHANGE",
            "code": 3011
          },
          {
            "name": "OTC DESK",
            "code": 3021
          }
        ],
        "attributes": null,
        "description": {
          "website": "https://www.binance.com/",
          "twitter": "https://twitter.com/binance",
          "telegram": "",
          "discord": ""
        }
      },
      "comp_entities": null,
      "attributes": [
        {
          "name": "COLD WALLET",
          "code": 4004,
          "comp_info": null
        }
      ],
      "name_tag": "Binance: Cold Wallet"
    },
    {
      "chain_id": 1,
      "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
      "main_entity": "Binance",
      "main_entity_info": {
        "entity": "Binance",
        "categories": [
          {
            "name": "EXCHANGE",
            "code": 3011
          },
          {
            "name": "OTC DESK",
            "code": 3021
          }
        ],
        "attributes": null,
        "description": {
          "website": "https://www.binance.com/",
          "twitter": "https://twitter.com/binance",
          "telegram": "",
          "discord": ""
        }
      },
      "comp_entities": [
        "Alameda Research"
      ],
      "attributes": [
        {
          "name": "DEPOSIT ADDRESS",
          "code": 4007,
          "comp_info": [
            "BINANCE DEPOSIT ADDRESS"
          ]
        }
      ],
      "name_tag": "Binance: Deposit Address"
    }
  ]
}
{
  "request_id": "6fc7387140e94b42",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": 1,
      "addresses": [
        {
          "chain_id": 1,
          "address": "0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b",
          "main_entity": "",
          "main_entity_info": null,
          "comp_entities": null,
          "attributes": null,
          "name_tag": ""
        },
        {
          "chain_id": 1,
          "address": "0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3",
          "main_entity": "",
          "main_entity_info": null,
          "comp_entities": null,
          "attributes": null,
          "name_tag": ""
        }
      ]
    },
    {
      "chain_id": 56,
      "addresses": [
        {
          "chain_id": 56,
          "address": "0xcf2f7f94dfd385c1a2a2090c971183a121f0de0b",
          "main_entity": "PancakeSwap",
          "main_entity_info": {
            "entity": "PancakeSwap",
            "categories": [
              {
                "name": "DEX",
                "code": 3008
              },
              {
                "name": "OPTIONS",
                "code": 3044
              },
              {
                "name": "DERIVATIVES",
                "code": 3028
              }
            ],
            "attributes": null,
            "description": {
              "website": "https://pancakeswap.finance",
              "twitter": "",
              "telegram": "",
              "discord": ""
            }
          },
          "comp_entities": null,
          "attributes": null,
          "name_tag": "PancakeSwap V2: TRL 23"
        },
        {
          "chain_id": 56,
          "address": "0x32a5b2c435bf3d41a859b48ae307dfbf3b3b54e3",
          "main_entity": "PancakeSwap",
          "main_entity_info": {
            "entity": "PancakeSwap",
            "categories": [
              {
                "name": "DEX",
                "code": 3008
              },
              {
                "name": "OPTIONS",
                "code": 3044
              },
              {
                "name": "DERIVATIVES",
                "code": 3028
              }
            ],
            "attributes": null,
            "description": {
              "website": "https://pancakeswap.finance",
              "twitter": "",
              "telegram": "",
              "discord": ""
            }
          },
          "comp_entities": null,
          "attributes": null,
          "name_tag": "PancakeSwap V2: Daddymoney"
        }
      ]
    }
  ]
}
{
  "request_id": "62e8586265bf4550",
  "code": 200000,
  "message": "Success",
  "data": {
    "entity": "Tornado Cash",
    "categories": [
      {
        "name": "MIXER",
        "code": 3017
      },
      {
        "name": "PRIVACY",
        "code": 3032
      }
    ],
    "attributes": [
      {
        "name": "SANCTIONED",
        "code": 4015,
        "comp_info": [
          "OFAC Sanctioned"
        ]
      }
    ],
    "description": {
      "website": "https://tornadocash-eth.ipns.dweb.link/",
      "twitter": "https://x.com/tornadocash",
      "telegram": "",
      "discord": ""
    }
  }
}
GET /address-label/api/v3/chain-list HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Accept: */*
{
  "request_id": "12cf29e910584a23",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": -3,
      "chain_name": "SOLANA"
    },
    {
      "chain_id": -2,
      "chain_name": "TRON"
    },
    {
      "chain_id": -1,
      "chain_name": "BITCOIN"
    },
    {
      "chain_id": 1,
      "chain_name": "ETHEREUM"
    },
    {
      "chain_id": 10,
      "chain_name": "OPTIMISM"
    },
    {
      "chain_id": 25,
      "chain_name": "CRONOS"
    },
    {
      "chain_id": 56,
      "chain_name": "BNB SMART CHAIN"
    },
    {
      "chain_id": 100,
      "chain_name": "GNOSIS"
    },
    {
      "chain_id": 137,
      "chain_name": "POLYGON"
    },
    {
      "chain_id": 169,
      "chain_name": "MANTA PACIFIC"
    },
    {
      "chain_id": 199,
      "chain_name": "BITTORRENT"
    },
    {
      "chain_id": 250,
      "chain_name": "FANTOM OPERA"
    },
    {
      "chain_id": 288,
      "chain_name": "BOBA"
    },
    {
      "chain_id": 324,
      "chain_name": "ZKSYNC"
    },
    {
      "chain_id": 1024,
      "chain_name": "CLV PARACHAIN"
    },
    {
      "chain_id": 1101,
      "chain_name": "POLYGON ZKEVM"
    },
    {
      "chain_id": 1111,
      "chain_name": "WEMIX3.0 MAINNET"
    },
    {
      "chain_id": 1284,
      "chain_name": "MOONBEAM"
    },
    {
      "chain_id": 1285,
      "chain_name": "MOONRIVER"
    },
    {
      "chain_id": 5000,
      "chain_name": "MANTLE"
    },
    {
      "chain_id": 8453,
      "chain_name": "BASE"
    },
    {
      "chain_id": 42161,
      "chain_name": "ARBITRUM ONE"
    },
    {
      "chain_id": 42220,
      "chain_name": "CELO"
    },
    {
      "chain_id": 43114,
      "chain_name": "AVALANCHE C-CHAIN"
    },
    {
      "chain_id": 59144,
      "chain_name": "LINEA"
    },
    {
      "chain_id": 81457,
      "chain_name": "BLAST"
    },
    {
      "chain_id": 1313161554,
      "chain_name": "AURORA"
    }
  ]
}
POST /address-label/api/v3/labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "chain_id": 1,
  "address": "0x3d12e63d4313f850d23cead57ef0c29e94c9551d"
}
POST /address-label/api/v3/batch-labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 118

{
  "chain_id": 1,
  "addresses": [
    "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"
  ]
}
POST /address-label/api/v3/multi-chains-labels HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "chains": [
    1,
    56
  ],
  "addresses": [
    "0x3d12e63d4313f850d23cead57ef0c29e94c9551d",
    "0xbe0eb53f46cd790cd13851d5eff43d12404d33e8"
  ]
}
POST /address-label/api/v3/entity HTTP/1.1
Host: aml.blocksec.com
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "entity": "TORNADO.CASH"
}