About "contractAddress" returning a symbol

Notifications related to tokens (ERC-20 or compatible) may be delivered with the parameter "contractAddress" containing a symbol rather than the intended blockchain Contract Address. See the example notification below.

Example notification:

{
  "currency": "TRON",
  "chain": "tron-mainnet",
  "amount": "0.006043",
  "address": "TS4kth6SCbZGPgwPktnaeJGRtsiqWnuxrf",
  "counterAddress": "TMszoJ2M2iUFnsmUAZM2GCAqG8MMSxAPko",
  "subscriptionType": "INCOMING_FUNGIBLE_TX",
  "blockNumber": 62139354,
  "txId": "6933f55def9223e51df7b0b3c4a4c5f73dda5c070a724a7797b0f5b03bf93ea4",
  "contractAddress": "USDT_TRON" // Returns symbol rather than "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}

This behavior is expected in several ContractAddresses supported by Tatum (Legacy). See the list below.

📘

Future improvements to notifications will deprecate the current behavior. The response will instead return the token address in the "contractAddress" field.

List of Tokens

ChainSymbol (currency)ContractAddressDigits
BSCBBCH0x8ff795a6f4d97e7887c79bea79aba5cc76444adf18
BSCBBTC0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c18
BSCBDOT0x7083609fce4d1d8dc0c979aab8c869ea2c87340218
BSCBETH0x2170ed0880ac9a755fd29b2688956bd959f933f818
BSCBLTC0x4338665cbb7b2485a8855a139b75d5e34ab0db9418
BSCBUSD_BSC0xe9e7cea3dedca5984780bafc599bd69add087d5618
BSCBXRP0x1d2f0da169ceb9fc7b3144628db156f3f6c60dbe18
BSCCAKE0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce8218
BSCGMC_BSC0xa6272359bc37f61af398071b65c8934aca744d5318
BSCRMD0x02888e65324a98219c26f292e7cd3e52ef39c5c218
BSCUSDC_BSC0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d18
BSCWBNB0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c18
CELOCEUR0xd8763cba276a3738e6de85b4b3bf5fded6d6ca7318
CELOCUSD0x765DE816845861e75A25fCA122bb6898B8B1282a18
ETHBAT0x0d8775f648430679a709e98d2b0cb6250d2887ef18
ETHBUSD0x4fabb145d64652a948d72533023f6e7a623c7c5318
ETHFREE0x2f141ce366a2462f02cea3d12cf93e4dca49e4fd18
ETHGMC0xa6272359bc37f61af398071b65c8934aca744d5318
ETHLATOKEN0xe50365f5d679cb98a1dd62d6f6e58e59321bcddf18
ETHLEO0x2af5d2ad76741191d15dfe7bf6ac92d4bd912ca318
ETHLINK0x514910771af9ca656af840dff83e8264ecf986ca18
ETHMATIC_ETH0x7d1afa7b718fb893db30a3abc0cfc608aacfebb018
ETHMKR0x9f8f72aa9304c8b593d555f12ef6589cc3a579a218
ETHPAX0x8e870d67f660d95d5be530380d0ec0bd388289e118
ETHPAXG0x45804880de22913dafe09f4980848ece6ecbaf7818
ETHREVV0x557b933a7c2c45672b610f8954a3deb39a51a8ca18
ETHSAND0x3845badade8e6dff049820680d1f14bd3903a5d018
ETHTUSD0x0000000000085d4780B73119b644AE5ecd22b37618
ETHUNI0x1f9840a85d5af5bf1d1762f925bdaddc4201f98418
ETHUSDC0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb486
ETHUSDT0xdac17f958d2ee523a2206206994597c13d831ec76
ETHWBTC0x2260fac5e5542a773aa44fbcfedf7c193bc2c5998
ETHXCON0x0f237d5ea7876e0e2906034d98fdb20d43666ad418
FLOWFUSDA.3c5959b568896393.FUSD?
MATICGAMEE0xcf32822ff397ef82425153a9dcb726e5ff61dca718
MATICUSDC_MATIC0x2791bca1f2de4661ed88a30c99a7a9449aa841746
MATICUSDC_MATIC_NATIVE0x3c499c542cef5e3811e1192ce70d8cc03d5c33596
MATICUSDT_MATIC0xc2132d05d31c914a87c6611c10748aeb04b58e8f18
SOLUSDC_SOLEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6
TRONINRT_TRONTX66VmiV1txm45vVLvcHYEqPXXLoREyAXm2
TRONUSDT_TRONTR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t6

📘

Find additional information in GitHub at the following link.

❗️

These tokens only exist in Mainnet.