Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key
Version: 2.0

Address Labels

address-labels-docs

Address Labels

The Moralis API automatically enriches all transactions, NFT transfers and ERC20 transfers with user-friendly labels for the sender and the receiver. Any transaction or transfer that includes a to_address or from_address will also include to_address_label and from_address labels respectively.

These labels reflect publicly known addresses such as Coinbase, Binance, Kraken, as well as DEXes such as Uniswap v3, 1inch, and also NFT marketplaces like OpenSea and Blur, plus many more!

Here's an example transaction:

{
  "hash": "0x70c30285a9a4cc1c147cc94e5d0cefebe693fffd5fd5cbf727e2f86b6829d71b",
  "nonce": "6810858",
  "transaction_index": "72",
  "from_address": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
  "from_address_label": "Binance 15",
  "to_address": "0x514910771af9ca656af840dff83e8264ecf986ca",
  "to_address_label": "ChainLink Token",
  "value": "0",
  "gas": "207128",
  "gas_price": "32393720336",
  "input": "0xa9059cbb000000000000000000000000c476723407b737c173bdfd87c7abc80f6856e6320000000000000000000000000000000000000000000000008533e3870aec3000",
  "receipt_cumulative_gas_used": "8535588",
  "receipt_gas_used": "52089",
  "receipt_contract_address": null,
  "receipt_root": null,
  "receipt_status": "1",
  "block_timestamp": "2023-06-26T16:48:23.000Z",
  "block_number": "17564884",
  "block_hash": "0x4e61fbb792a84c419a22ffcc590cbcb2f5a1b88d8e864d608e3544a3594c0e69",
  "transfer_index": [
    17564884,
    72
  ],
}

Which endpoints support Address labeling?​

Any endpoint that includes a to_address and from_address! This list currently includes:

NameEndpoint
Get native transactions by wallet/:address
Get decoded transactions by wallet/:address/verbose
Get transaction by hash/transaction/:transaction_hash
Get decoded transaction by hash/transaction/:transaction_hash/verbose
Get NFT transfers by wallet/:address/nft/transfers
Get NFT transfers by contract/nft/:address/transfers
Get NFT transfers from a block to a block/nft/transfers
Get NFT transfers by block/block/:block_hash/nft/transfers
Get NFT transfers by token id/nft/:address/transfers
Get ERC20 transfers by wallet/:address/erc20/transfers
Get ERC20 transfers by contract/erc20/:address/transfers
Get ERC20 mints/erc20/mints
Get ERC20 burns/erc20/burns
Get ERC20 approvals/erc20/approvals
Get ERC20 metadata by contract/erc20/metadata
Get ERC20 metadata by symbol/erc20/metadata/symbol

How many labels are supported?​

We support over 1,000 labels and counting. Examples of these include:

Centralized Exchanges

  • Coinbase
  • Kraken
  • Binance
  • Bittrex
  • Bitfinex
  • ...plus many more

Decentralized Exchanges

  • Uniswap
  • Aave
  • 1inch
  • Pancakeswap
  • Sushiswap
  • ...plus many more

NFT Marketplaces

  • OpenSea
  • Blur
  • Rarible
  • Sorare
  • LooksRare
  • ...plus many more

As well as all ERC20 token and cryptocurrency contract labels.

What chains currently support transaction labeling?​

Ethereum and Polygon have the largest coverage, but we include labels for the following chains:

  • Ethereum
  • Polygon
  • Binance Chain
  • Avalanche
  • Arbitrum
  • Optimism
  • Fantom

Will you continue to add new labels?​

Yes, absolutely! We plan to continue adding fresh address labels as new contracts and projects emerge. If you would like a specific address added, please add your submissions to our feature requests board.